![\"DOMRect](\"$MDN_URL$/Web/API/Element/getBoundingClientRect/element-box-diagram.png\")
\n<url>(), followed by optional hints using the format() and tech() component values that specify the format and font technology of the resource referenced by the URL. The format() and tech() components are a comma-separated list of strings of known font formats and technologies. If a user agent doesn't support the font technology or formats, it skips downloading the font resource. If no format or technology hints are supplied, the font resource is always downloaded.",
- "format()": "An optional declaration that follows the url() value that provides a hint for the user agent on the font format. If the value is not supported or invalid, the browser may not download the resource, potentially saving bandwidth. If omitted, the browser will download the resource and then detect the format. If including a font source for backward-compatibility that is not in the list of defined keywords, enclose the format string in quotes. Possible values are described in the Font formats section below.",
- "tech()": "An optional declaration that follows the url() value that provides a hint for the user agent on the font technology. The value for tech() may be one of the keywords described in Font technologies.",
+ "format()": "An optional declaration that follows the url() value that provides a hint for the user agent on the font format. If the value is not supported or invalid, the browser may not download the resource, potentially saving bandwidth. If omitted, the browser will download the resource and then detect the format. If including a font source for backward-compatibility that is not in the list of defined keywords, enclose the format string in quotes. Possible values are described in the Font formats section below.",
+ "tech()": "An optional declaration that follows the url() value that provides a hint for the user agent on the font technology. The value for tech() may be one of the keywords described in Font technologies.",
"local(<font-face-name>)": "Specifies the font name should the font be available on the user's device. Enclosing the font name in quotes is optional. Note: For OpenType and TrueType fonts, <font-face-name> is used to match either the Postscript name or the full font name in the name table of locally available fonts. Which type of name is used varies by platform and font, so you should include both of these names to assure proper matching across platforms. Platform substitutions for a given font name must not be used.
Note: Locally available fonts may have been preinstalled on the user's device, or may have been actively installed by the user.
While the set of preinstalled fonts is likely to be the same for all users of a particular device, the set of user-installed fonts is not. By discovering the set of user-installed fonts, a site can therefore build a fingerprint for the device, helping the site to track users across the web.
To prevent this, user agents may ignore user-installed fonts when using local().
local() component value, which uniquely identifies a single font face within a larger family. The name can optionally be enclosed in quotes. The font face name is not case-sensitive."
}
@@ -671,7 +671,7 @@
"SafariIOS": "15.4"
},
"doc": "The override-colors CSS descriptor is used to override colors in the chosen base-palette for a color font.",
- "formalSyntax": "[ <integer [0,∞]> <absolute-color-base> ]#\n <absolute-color-base> = <hex-color> | <absolute-color-function> | <named-color> | transparent\n <absolute-color-function> = <rgb()> | <rgba()> | <hsl()> | <hsla()> | <hwb()> | <lab()> | <lch()> | <oklab()> | <oklch()> | <color()>\n <rgb()> = <legacy-rgb-syntax> | <modern-rgb-syntax>\n <rgba()> = <legacy-rgba-syntax> | <modern-rgba-syntax>\n <hsl()> = <legacy-hsl-syntax> | <modern-hsl-syntax>\n <hsla()> = <legacy-hsla-syntax> | <modern-hsla-syntax>\n <hwb()> = hwb( [ <hue> | none ] [ <percentage> | <number> | none ] [ <percentage> | <number> | none ] [ / [ <alpha-value> | none ] ]? )\n <lab()> = lab( [ <percentage> | <number> | none ] [ <percentage> | <number> | none ] [ <percentage> | <number> | none ] [ / [ <alpha-value> | none ] ]? )\n <lch()> = lch( [ <percentage> | <number> | none ] [ <percentage> | <number> | none ] [ <hue> | none ] [ / [ <alpha-value> | none ] ]? )\n <oklab()> = oklab( [ <percentage> | <number> | none ] [ <percentage> | <number> | none ] [ <percentage> | <number> | none ] [ / [ <alpha-value> | none ] ]? )\n <oklch()> = oklch( [ <percentage> | <number> | none ] [ <percentage> | <number> | none ] [ <hue> | none ] [ / [ <alpha-value> | none ] ]? )\n <color()> = color( <colorspace-params> [ / [ <alpha-value> | none ] ]? )\n <legacy-rgb-syntax> = rgb( <percentage>#{3} , <alpha-value>? ) | rgb( <number>#{3} , <alpha-value>? )\n <modern-rgb-syntax> = rgb( [ <number> | <percentage> | none ]{3} [ / [ <alpha-value> | none ] ]? )\n <legacy-rgba-syntax> = rgba( <percentage>#{3} , <alpha-value>? ) | rgba( <number>#{3} , <alpha-value>? )\n <modern-rgba-syntax> = rgba( [ <number> | <percentage> | none ]{3} [ / [ <alpha-value> | none ] ]? )\n <legacy-hsl-syntax> = hsl( <hue> , <percentage> , <percentage> , <alpha-value>? )\n <modern-hsl-syntax> = hsl( [ <hue> | none ] [ <percentage> | <number> | none ] [ <percentage> | <number> | none ] [ / [ <alpha-value> | none ] ]? )\n <legacy-hsla-syntax> = hsla( <hue> , <percentage> , <percentage> , <alpha-value>? )\n <modern-hsla-syntax> = hsla( [ <hue> | none ] [ <percentage> | <number> | none ] [ <percentage> | <number> | none ] [ / [ <alpha-value> | none ] ]? )\n <hue> = <number> | <angle>\n <alpha-value> = <number> | <percentage>\n <colorspace-params> = <predefined-rgb-params> | <xyz-params>\n <predefined-rgb-params> = <predefined-rgb> [ <number> | <percentage> | none ]{3}\n <xyz-params> = <xyz-space> [ <number> | <percentage> | none ]{3}\n <predefined-rgb> = srgb | srgb-linear | display-p3 | a98-rgb | prophoto-rgb | rec2020\n <xyz-space> = xyz | xyz-d50 | xyz-d65",
+ "formalSyntax": "[ <integer [0,∞]> <absolute-color-base> ]#",
"values": {
"[ <integer [0,∞]> <absolute-color-base> ]": "Specifies the index of a color in a base-palette and the color to overwrite it with."
}
@@ -785,7 +785,7 @@
"Safari": "3",
"SafariIOS": ""
},
- "doc": "The -webkit-device-pixel-ratio is a non-standard Boolean CSS media feature which is an alternative to the standard resolution media feature.\nNote: If possible, use the resolution media feature query instead, which is a standard media feature. While this prefixed media feature is a WebKit feature, other browser engines may support it. See browser compatibility below.\n
-webkit-device-pixel-ratio is a non-standard Boolean CSS media feature which is an alternative to the standard resolution media feature.\nNote: If possible, use the resolution media feature query instead, which is a standard media feature. While this prefixed media feature is a WebKit feature, other browser engines may support it. See browser compatibility below.\n
px. Although the value is a <number>, and thus doesn't syntactically allow units, its implicit unit is dppx."
}
@@ -816,7 +816,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "The -webkit-transform-3d Boolean CSS media feature is a WebKit extension whose value is true if vendor-prefixed CSS 3D transforms are supported.\nNote: While this media feature is currently supported by most browsers. If possible, use an @supports feature query instead.\n
-webkit-transform-3d Boolean CSS media feature is a WebKit extension whose value is true if vendor-prefixed CSS 3D transforms are supported.\nNote: While this media feature is currently supported by most browsers. If possible, use an @supports feature query instead.\n
-webkit prefix and supports non-standard, prefixed media queries.",
"false": "The 3D CSS transforms prefixed with -webkit are not supported by the browser."
@@ -831,7 +831,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
Note: All browsers support the transition property without vendor prefixes. Only WebKit (Safari), and not Chromium, based browsers support the -webkit-transition media feature. No browsers support transition without the prefix as a media query (though some browsers do support - -webkit-transform-3d). Use the @supports (transition) feature query instead.\n
The -webkit-transition Boolean non-standardCSS media feature is a WebKit extension whose value is true if the browsing context supports CSS transitions.\n
Apple has a description in Safari CSS Reference; this is now called transition there.\n
Note: You should not use this media feature; it was never specified, has never been widely implemented, and has been removed from most browsers. Use a @supports feature query instead.\n
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
Note: All browsers support the transition property without vendor prefixes. Only WebKit (Safari), and not Chromium, based browsers support the -webkit-transition media feature. No browsers support transition without the prefix as a media query (though some browsers do support - -webkit-transform-3d). Use the @supports (transition) feature query instead.\n
The -webkit-transition Boolean non-standardCSS media feature is a WebKit extension whose value is true if the browsing context supports CSS transitions.\n
Apple has a description in Safari CSS Reference; this is now called transition there.\n
Note: You should not use this media feature; it was never specified, has never been widely implemented, and has been removed from most browsers. Use a @supports feature query instead.\n
resolution CSS media feature can be used to test the pixel density of the output device."
},
+ "scan": {
+ "url": "$MDN_URL$/web/css/@media/scan",
+ "status": [
+ "Experimental",
+ "Deprecated"
+ ],
+ "doc": "The scan CSS media feature is used to apply CSS styles based on the scanning process of the output device."
+ },
"scripting": {
"url": "$MDN_URL$/web/css/@media/scripting",
"status": [
@@ -1740,7 +1748,7 @@
"SafariIOS": ""
},
"doc": "The <color> CSS data type represents a color.\nA <color> may also include an alpha-channel transparency value, indicating how the color should composite with its background.\nNote: Although <color> values are precisely defined, their actual appearance may vary (sometimes significantly) from device to device. This is because most devices are not calibrated, and some browsers do not support output devices' color profiles.\n
The case sensitivity of attribute names and values depends on the document language. In HTML, attribute names are case insensitive, as are spec-defined enumerated values. The case-insensitive HTML attribute values are listed in the HTML spec. For these attributes, the attribute value in the selector is case-insensitive, regardless of whether the value is invalid or the attribute for the element on which it is set is invalid.\n
If the attribute value is case sensitive, like class, id, and data-* attributes, the attribute selector value match is case-sensitive. Attributes defined outside of the HTML specification, like role and aria-* attributes, are also case-sensitive. Normally case-sensitive attribute selectors can be made case-insensitive with the inclusion of the case-insensitive modifier (i).\n
The case sensitivity of attribute names and values depends on the document language. In HTML, attribute names are case-insensitive, as are spec-defined enumerated values. The case-insensitive HTML attribute values are listed in the HTML spec. For these attributes, the attribute value in the selector is case-insensitive, regardless of whether the value is invalid or the attribute for the element on which it is set is invalid.\n
If the attribute value is case-sensitive, like class, id, and data-* attributes, the attribute selector value match is case-sensitive. Attributes defined outside of the HTML specification, like role and aria-* attributes, are also case-sensitive. Normally case-sensitive attribute selectors can be made case-insensitive with the inclusion of the case-insensitive modifier (i).\n
400.",
"bold": "Bold font weight. Same as 700.",
- "<number>": "A <number> value between 1 and 1000, both values included. Higher numbers represent weights that are bolder than (or as bold as) lower numbers. This allows fine-grain control for variable fonts. For non-variable fonts, if the exact specified weight is unavailable, a fallback weight algorithm is used — numeric values that are divisible by 100 correspond to common weight names, as described in the Common weight name mapping section below.",
+ "<number>": "A <number> value between 1 and 1000, both values included. Higher numbers represent weights that are bolder than (or as bold as) lower numbers. This allows fine-grain control for variable fonts. For non-variable fonts, if the exact specified weight is unavailable, a fallback weight algorithm is used — numeric values that are divisible by 100 correspond to common weight names, as described in the Common weight name mapping section below.",
"lighter": "One relative font weight lighter than the parent element. Note that only four font weights are considered for relative weight calculation; see the Meaning of relative weights section below.",
"bolder": "One relative font weight heavier than the parent element. Note that only four font weights are considered for relative weight calculation; see the Meaning of relative weights section below."
}
@@ -10935,7 +10943,7 @@
"Safari": "17.2",
"SafariIOS": "17.2"
},
- "doc": "The CSS & nesting selector explicitly states the relationship between parent and child rules when using CSS Nesting. It makes nested child rule selectors relative to the parent element. Without the & nesting selector the child rule selector selects child elements. The child rule selectors have the same specificity weight as if they were within :is().\nNote: Child rule does not mean child element selector. A child rule can target parent element or child elements depending on use of the & nesting selector.\n
If not used in nested style rule the & nesting selector represents the scoping root."
+ "doc": "The CSS & nesting selector explicitly states the relationship between parent and child rules when using CSS nesting. It makes the nested child rule selectors relative to the parent element. Without the & nesting selector, the child rule selector selects child elements. The child rule selectors have the same specificity weight as if they were within :is().\n
Note: Child rule does not mean child element selector. A child rule can target parent element or child elements depending on use of the & nesting selector.\n
If not used in nested style rule, the & nesting selector represents the scoping root."
},
"next-sibling_combinator": {
"url": "$MDN_URL$/web/css/next-sibling_combinator",
@@ -11128,7 +11136,7 @@
"SafariIOS": ""
},
"doc": "The opacity CSS property sets the opacity of an element. Opacity is the degree to which content behind an element is hidden, and is the opposite of transparency.",
- "formalSyntax": "<alpha-value>\n <alpha-value> = <number> | <percentage>",
+ "formalSyntax": "<opacity-value>",
"values": {
"<alpha-value>": "A <number> in the range 0.0 to 1.0, inclusive, or a <percentage> in the range 0% to 100%, inclusive, representing the opacity of the channel (that is, the value of its alpha channel). Any value outside the interval, though valid, is clamped to the nearest limit in the range. "
}
@@ -12980,7 +12988,8 @@
"Chrome": "121",
"ChromeAndroid": "121",
"Edge": "121",
- "Firefox": "64"
+ "Firefox": "64",
+ "Opera": "107"
},
"doc": "The
Value Meaning 0The element is fully transparent (that is, invisible). Any <number> strictly between 0 and 1The element is translucent (that is, content behind the element can be seen). 1 (default value)The element is fully opaque (visually solid). scrollbar-color CSS property sets the color of the scrollbar track and thumb.\n
The track refers to the background of the scrollbar, which is generally fixed regardless of the scrolling position.\n
The thumb refers to the moving part of the scrollbar, which usually floats on top of the track.\n
When scrollbar-color value is set on the document's root element, the values are applied to the viewport scrollbars.",
"formalSyntax": "auto | <color>{2}",
@@ -13017,7 +13026,8 @@
"Chrome": "121",
"ChromeAndroid": "121",
"Edge": "121",
- "Firefox": "64"
+ "Firefox": "64",
+ "Opera": "107"
},
"doc": "The scrollbar-width property allows the author to set the maximum thickness of an element's scrollbars when they are shown.",
"formalSyntax": "auto | thin | none",
@@ -13056,7 +13066,7 @@
"SafariIOS": "10.3"
},
"doc": "The shape-image-threshold CSS property sets the alpha channel threshold used to extract the shape using an image as the value for shape-outside.",
- "formalSyntax": "<alpha-value>\n <alpha-value> = <number> | <percentage>",
+ "formalSyntax": "<'opacity'>",
"values": {
"<alpha-value>": "Sets the threshold used for extracting a shape from an image. The shape is defined by the pixels whose alpha value is greater than the threshold. Values outside the range 0.0 (fully transparent) to 1.0 (fully opaque) are clamped to this range."
}
@@ -13763,7 +13773,7 @@
"Opera": "102"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The timeline-scope CSS property modifies the scope of a named animation timeline.\n
By default, a named timeline (i.e. declared using scroll-timeline-name or view-timeline-name) can only be set as the controlling timeline of a direct descendant element (i.e. by setting animation-timeline on it with the timeline name as its value). This is the timeline's default \"scope\".\n
timeline-scope is given the name of a timeline defined on a descendant element; this causes the scope of the timeline to be increased to the element that timeline-scope is set on and any of its descendants. In other words, that element and any of its descendant elements can now be controlled using that timeline.\n
Note: If no timeline (or more than one timeline) exists with the name given for the timeline-scope value, an inactive timeline with the specified name is created.\n
scroll-timeline-name or view-timeline-name) defined on a descendant element. This causes the timeline scope to be increased to the element that timeline-scope is set on and any of its descendants. Note: <dashed-ident> values must start with --, which helps to avoid name clashes with standard CSS keywords.
Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The ::-webkit-scrollbar CSS pseudo-element affects the style of an element's scrollbar when it has scrollable overflow.\n
Note: The ::-webkit-scrollbar vendor-prefixed pseudo-element is not supported on all browsers (see Browser compatibility).\nThe scrollbar-color and scrollbar-width standard properties may be used as an alternative for browsers that do not support this pseudo-element.\n
Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The ::-webkit-scrollbar CSS pseudo-element affects the style of an element's scrollbar when it has scrollable overflow.\n
Note: The ::-webkit-scrollbar vendor-prefixed pseudo-element is not supported on all browsers (see Browser compatibility).\nThe scrollbar-color and scrollbar-width standard properties may be used as an alternative for browsers that do not support this pseudo-element. When these properties are set, ::-webkit-scrollbar styling is disabled.\n
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The ::grammar-error CSS pseudo-element represents a text segment which the user agent has flagged as grammatically incorrect."
@@ -16205,6 +16216,7 @@
"Chrome": "121",
"ChromeAndroid": "121",
"Edge": "121",
+ "Opera": "107",
"Safari": "preview"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The ::spelling-error CSS pseudo-element represents a text segment which the user agent has flagged as incorrectly spelled."
diff --git a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/GlobalObjects.json b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/GlobalObjects.json
index 05c3deaa7e9b..bdbf3c74c5c4 100644
--- a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/GlobalObjects.json
+++ b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/GlobalObjects.json
@@ -518,6 +518,7 @@
"ChromeAndroid": "121",
"Edge": "121",
"Firefox": "115",
+ "Opera": "107",
"Safari": "16.4",
"SafariIOS": "16.4",
"Deno": "1.38"
diff --git a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/Html.json b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/Html.json
index 91131fecd1f0..5efad938a7f6 100644
--- a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/Html.json
+++ b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/Html.json
@@ -1092,6 +1092,15 @@
},
"controlslist": {
"url": "$MDN_URL$/web/html/element/audio#controlslist",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "58",
+ "ChromeAndroid": "58",
+ "Edge": "79",
+ "Opera": "45"
+ },
"doc": "The controlslist attribute, when specified, helps the browser select what controls to show for the audio element whenever the browser shows its own set of controls (that is, when the controls attribute is specified).\n
The allowed values are nodownload, nofullscreen and noremoteplayback."
},
"crossorigin": {
@@ -1706,13 +1715,6 @@
"DOM interface": "HTMLButtonElement\n"
},
"attrs": {
- "autocomplete": {
- "url": "$MDN_URL$/web/html/element/button#autocomplete",
- "compatibility": {
- "Firefox": "4"
- },
- "doc": "This attribute on a <button> is nonstandard and Firefox-specific. Unlike other browsers, Firefox persists the dynamic disabled state of a <button> across page loads. Setting autocomplete=\"off\" on the button disables this feature; see Firefox bug 654072."
- },
"autofocus": {
"url": "$MDN_URL$/web/html/element/button#autofocus",
"doc": "This Boolean attribute specifies that the button should have input focus when the page loads. Only one element in a document can have this attribute."
@@ -1847,10 +1849,34 @@
},
"popovertarget": {
"url": "$MDN_URL$/web/html/element/button#popovertarget",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "114",
+ "ChromeAndroid": "114",
+ "Edge": "114",
+ "Firefox": "preview",
+ "Opera": "100",
+ "Safari": "17",
+ "SafariIOS": "17"
+ },
"doc": "Turns a <button> element into a popover control button; takes the ID of the popover element to control as its value. See the Popover API landing page for more details."
},
"popovertargetaction": {
"url": "$MDN_URL$/web/html/element/button#popovertargetaction",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "114",
+ "ChromeAndroid": "114",
+ "Edge": "114",
+ "Firefox": "preview",
+ "Opera": "100",
+ "Safari": "17",
+ "SafariIOS": "17"
+ },
"doc": "Specifies the action to be performed on a popover element being controlled by a control <button>. Possible values are:\n
\"hide\"The button will hide a shown popover. If you try to hide an already hidden popover, no action will be taken.\n
\"show\"The button will show a hidden popover. If you try to show an already showing popover, no action will be taken.\n
\"toggle\"The button will toggle a popover between showing and hidden. If the popover is hidden, it will be shown; if the popover is showing, it will be hidden. If popovertargetaction is omitted, \"toggle\" is the default action that will be performed by the control button.\n
<caption> HTML element specifies the caption (or title) of a table.",
+ "doc": "The <caption> HTML element specifies the caption (or title) of a table, providing the table an accessible description.",
"details": {
"Content categories": "None.\n",
"Permitted content": "Flow content\n.\n",
@@ -1990,7 +2016,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This enumerated attribute indicates how the caption must be aligned with respect to the table. It may have one of the following values:\nleftThe caption is displayed to the left of the table.\n
topThe caption is displayed above the table.\n
rightThe caption is displayed to the right of the table.\n
bottomThe caption is displayed below the table.\n
Warning: Do not use this attribute, as it has been deprecated. The <caption> element should be styled using the CSS properties caption-side and text-align.\n
left, top, right, or bottom. Use the caption-side and text-align CSS properties instead, as this attribute is deprecated."
}
}
},
@@ -2075,7 +2101,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "The <col> HTML element defines a column within a table and is used for defining common semantics on all common cells. It is generally found within a <colgroup> element.\n<col> allows styling columns using CSS, but only a few properties will have an effect on the column (see the CSS 2.1 specification for a list).",
+ "doc": "The <col> HTML element defines one or more columns in a column group represented by its parent <colgroup> element. The <col> element is only valid as a child of a <colgroup> element that has no span attribute defined.",
"details": {
"Content categories": "None.\n",
"Permitted content": "None; it is a\nvoid element\n.\n",
@@ -2101,7 +2127,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This enumerated attribute specifies how horizontal alignment of each column cell content will be handled. Possible values are:\n
left, aligning the content to the left of the cellcenter, centering the content in the cellright, aligning the content to the right of the celljustify, inserting spaces into the textual content so that the content is justified in the cellIf this attribute is not set, its value is inherited from the align of the <colgroup> element this <col> element belongs too. If there are none, the left value is assumed.\n
Note: To achieve the same effect as the left, center, right or justify values, do not try to set the text-align property on a selector giving a <col> element. Because <td> elements are not descendant of the <col> element, they won't inherit it.\n
If the table doesn't use a colspan attribute, use the td:nth-child(an+b) CSS selector. Set a to zero and b to the position of the column in the table, e.g. td:nth-child(2) { text-align: right; } to right-align the second column.\n
If the table does use a colspan attribute, the effect can be achieved by combining adequate CSS attribute selectors like [colspan=n], though this is not trivial.\n
left, center, right, justify, and char. When supported, the char value aligns the textual content on the character defined in the char attribute and on offset defined by the charoff attribute. Note that this attribute overrides the specified align of its <colgroup> parent element. Use the text-align CSS property on the <td> and <th> elements instead, as this attribute is deprecated.\nNote: Setting text-align on the <col> element has no effect as <col> has no descendants, and therefore no elements inherit from it.\n
If the table does not use a colspan attribute, use the td:nth-of-type(an+b) CSS selector. Set a to zero and b to the position of the column in the table, e.g. td:nth-of-type(2) { text-align: right; } to right-align the second column cells.\n
If the table does use a colspan attribute, the effect can be achieved by combining adequate CSS attribute selectors like [colspan=n], though this is not trivial.\n
#'. One of the predefined color keywords can also be used.\nTo achieve a similar effect, use the CSS background-color property."
+ "doc": "Defines the background color of each column cell. The value is an HTML color; either a 6-digit hexadecimal RGB code, prefixed by a '#', or a color keyword. Other CSS <color> values are not supported. Use the background-color CSS property instead, as this attribute is deprecated."
},
"char": {
"url": "$MDN_URL$/web/html/element/col#char",
@@ -2134,7 +2160,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This attribute sets the character to align the cells in a column on. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored."
+ "doc": "Specifies the alignment of the content to a character of each column cell. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored, though it will still override the specified char of its <colgroup> parent element."
},
"charoff": {
"url": "$MDN_URL$/web/html/element/col#charoff",
@@ -2150,7 +2176,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This attribute is used to indicate the number of characters to offset the column data from the alignment characters specified by the char attribute."
+ "doc": "Specifies the number of characters to offset the column cell content from the alignment character specified by the char attribute."
},
"span": {
"url": "$MDN_URL$/web/html/element/col#span",
@@ -2166,7 +2192,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This attribute contains a positive integer indicating the number of consecutive columns the <col> element spans. If not present, its default value is 1."
+ "doc": "Specifies the number of consecutive columns the <col> element spans. The value must be a positive integer greater than zero. If not present, its default value is 1."
},
"valign": {
"url": "$MDN_URL$/web/html/element/col#valign",
@@ -2183,7 +2209,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This attribute specifies the vertical alignment of the text within each cell of the column. Possible values for this attribute are:\n
baseline, which will put the text as close to the bottom of the cell as it is possible, but align it on the baseline of the characters instead of the bottom of them. If characters are all of the size, this has the same effect as bottom.bottom, which will put the text as close to the bottom of the cell as it is possible;middle, which will center the text in the cell;top, which will put the text as close to the top of the cell as it is possible.Note: Do not try to set the vertical-align property on a selector giving a <col> element. Because <td> elements are not descendant of the <col> element, they won't inherit it.\n
If the table doesn't use a colspan attribute, use the td:nth-child(an+b) CSS selector where 'a' is the total number of the columns in the table and 'b' is the ordinal position of the column in the table. Only after this selector the vertical-align property can be used.\n
If the table does use a colspan attribute, the effect can be achieved by combining adequate CSS attribute selectors like [colspan=n], though this is not trivial.\n
baseline, bottom, middle, and top. Note that this attribute overrides the specified valign of its <colgroup> parent element. Use the vertical-align CSS property on the <td> and <th> elements instead, as this attribute is deprecated.\nNote: Setting vertical-align on the <col> element has no effect as <col> has no descendants, and therefore no elements inherit from it.\n
If the table does not use a colspan attribute, use the td:nth-of-type(an+b) CSS selector. Set a to zero and b to the position of the column in the table, e.g. td:nth-of-type(2) { vertical-align: middle; } to center the second column cells vertically.\n
If the table does use a colspan attribute, the effect can be achieved by combining adequate CSS attribute selectors like [colspan=n], though this is not trivial.\n
0*, which means that the width of each column in the group should be the minimum width necessary to hold the column's contents. Relative widths such as 5* also can be used."
+ "doc": "Specifies a default width for each column. In addition to the standard pixel and percentage values, this attribute can take the special form 0*, which means that the width of each column spanned should be the minimum width necessary to hold the column's contents. Relative widths such as 5* can also be used. Note that this attribute overrides the specified width of its <colgroup> parent element. Use the width CSS property instead, as this attribute is deprecated."
}
}
},
@@ -2223,7 +2249,7 @@
"Content categories": "None.\n",
"Permitted content": "If the\nspan\nattribute is\npresent: none.\n<col>\nelement\n",
"Tag omission": "The start tag may be omitted, if it has a\n<col>\nelement as its first child and if it is not preceded by a\n<colgroup>\nwhose end tag has been omitted.\n<table>\nelement. The\n<colgroup>\nmust appear after any optional\n<caption>\nelement but before any\n<thead>\n,\n<th>\n,\n<tbody>\n,\n<tfoot>\nand\n<tr>\nelement.\n",
+ "Permitted parents": "A\n<table>\nelement. The\n<colgroup>\nmust appear after any\n<caption>\nelement, but before any\n<thead>\n,\n<tbody>\n,\n<tfoot>\n, and\n<tr>\nelements.\n",
"Implicit ARIA role": "No corresponding role\n",
"Permitted ARIA roles": "No\nrole\npermitted\n",
"DOM interface": "HTMLTableColElement\n"
@@ -2244,7 +2270,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This enumerated attribute specifies how horizontal alignment of each column cell content will be handled. Possible values are:\nleft, aligning the content to the left of the cellcenter, centering the content in the cellright, aligning the content to the right of the celljustify, inserting spaces into the textual content so that the content is justified in the cellchar, aligning the textual content on a special character with a minimal offset, defined by the char and charoff attributes.If this attribute is not set, the left value is assumed. The descendant <col> elements may override this value using their own align attribute.\n
Note: Do not try to set the text-align property on a selector giving a <colgroup> element. Because <td> elements are not descendant of the <colgroup> element, they won't inherit it.\n
If the table doesn't use a colspan attribute, use one td:nth-child(an+b) CSS selector per column, where 'a' is the total number of the columns in the table and 'b' is the ordinal position of this column in the table. Only after this selector the text-align property can be used.\n
If the table does use a colspan attribute, the effect can be achieved by combining adequate CSS attribute selectors like [colspan=n], though this is not trivial.\n
left, center, right, justify, and char. When supported, the char value aligns the textual content on the character defined in the char attribute and the offset defined by the charoff attribute. Note that the descendant <col> elements may override this value using their own align attribute. Use the text-align CSS property on the <td> and <th> elements instead, as this attribute is deprecated.\nNote: Setting text-align on the <colgroup> element has no effect as <td> and <th> elements are not descendants of the <colgroup> element, and therefore they do not inherit from it.\n
If the table does not use a colspan attribute, use the td:nth-of-type(an+b) CSS selector per column, where a is the total number of the columns in the table and b is the ordinal position of the column in the table, e.g. td:nth-of-type(7n+2) { text-align: right; } to right-align the second column cells.\n
If the table does use a colspan attribute, the effect can be achieved by combining adequate CSS attribute selectors like [colspan=n], though this is not trivial.\n
#'. One of the predefined color keywords can also be used.\nTo achieve a similar effect, use the CSS background-color property."
+ "doc": "Defines the background color of each column group cell. The value is an HTML color; either a 6-digit hexadecimal RGB code, prefixed by a '#', or a color keyword. Other CSS <color> values are not supported. Use the background-color CSS property instead, as this attribute is deprecated."
},
"char": {
"url": "$MDN_URL$/web/html/element/colgroup#char",
@@ -2277,7 +2303,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This attribute specifies the alignment of the content in a column group to a character. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored, though it will still be used as the default value for the align of the <col> which are members of this column group."
+ "doc": "Specifies the alignment of the content to a character of each column group cell. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored, though it will still be used as the default value for the align of the <col> elements which are members of this column group."
},
"charoff": {
"url": "$MDN_URL$/web/html/element/colgroup#charoff",
@@ -2293,7 +2319,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This attribute is used to indicate the number of characters to offset the column data from the alignment character specified by the char attribute."
+ "doc": "Specifies the number of characters to offset the column group cell content from the alignment character specified by the char attribute."
},
"span": {
"url": "$MDN_URL$/web/html/element/colgroup#span",
@@ -2309,7 +2335,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This attribute contains a positive integer indicating the number of consecutive columns the <colgroup> element spans. If not present, its default value is 1.\n
The span attribute is not permitted if there are one or more <col> elements within the <colgroup>."
+ "doc": "Specifies the number of consecutive columns the <colgroup> element spans. The value must be a positive integer greater than zero. If not present, its default value is 1.\n
Note: The span attribute is not permitted if there are one or more <col> elements within the <colgroup>.\n
baseline, which will put the text as close to the bottom of the cell as it is possible, but align it on the baseline of the characters instead of the bottom of them. If characters are all of the size, this has the same effect as bottom.bottom, which will put the text as close to the bottom of the cell as it is possible;middle, which will center the text in the cell;top, which will put the text as close to the top of the cell as it is possible.Note: Do not try to set the vertical-align property on a selector giving a <colgroup> element. Because <td> elements are not descendant of the <colgroup> element, they won't inherit it.\n
If the table doesn't use a colspan attribute, use the td:nth-child(an+b) CSS selector per column, where 'a' is the total number of the columns in the table and 'b' is the ordinal position of the column in the table. Only after this selector the vertical-align property can be used.\n
If the table does use a colspan attribute, the effect can be achieved by combining adequate CSS attribute selectors like [colspan=n], though this is not trivial.\n
baseline, bottom, middle, and top. Note that the descendant <col> elements may override this value using their own valign attribute. Use the vertical-align CSS property on the <td> and <th> elements instead, as this attribute is deprecated.\nNote: Setting vertical-align on the <colgroup> element has no effect as <td> and <th> elements are not descendants of the <colgroup> element, and therefore they do not inherit from it.\n
If the table does not use a colspan attribute, use the td:nth-of-type() CSS selector per column, e.g. td:nth-of-type(2) { vertical-align: middle; } to center the second column cells vertically.\n
If the table does use a colspan attribute, the effect can be achieved by combining adequate CSS attribute selectors like [colspan=n], though this is not trivial.\n
0*, which means that the width of each column spanned should be the minimum width necessary to hold the column's contents. Relative widths such as 5* can also be used. Note that the descendant <col> elements may override this value using their own width attribute. Use the width CSS property instead, as this attribute is deprecated."
}
}
},
@@ -2517,7 +2544,7 @@
"Safari": "6",
"SafariIOS": "6"
},
- "doc": "The <details> HTML element creates a disclosure widget in which information is visible only when the widget is toggled into an \"open\" state. A summary or label must be provided using the <summary> element.\nA disclosure widget is typically presented onscreen using a small triangle which rotates (or twists) to indicate open/closed status, with a label next to the triangle. The contents of the <summary> element are used as the label for the disclosure widget.\n
A <details> widget can be in one of two states. The default closed state displays only the triangle and the label inside <summary> (or a user agent-defined default string if no <summary>).\n
When the user clicks on the widget or focuses it then presses the space bar, it \"twists\" open, revealing its contents. The common use of a triangle which rotates or twists around to represent opening or closing the widget is why these are sometimes called \"twisty\".\n
You can use CSS to style the disclosure widget, and you can programmatically open and close the widget by setting/removing its open attribute. Unfortunately, at this time, there's no built-in way to animate the transition between open and closed.\n
By default when closed, the widget is only tall enough to display the disclosure triangle and summary. When open, it expands to display the details contained within.\n
Fully standards-compliant implementations automatically apply the CSS display: list-item<summary> element. You can use this to customize its appearance further. See Customizing the disclosure widget for further details.",
+ "doc": "The <details> HTML element creates a disclosure widget in which information is visible only when the widget is toggled into an \"open\" state. A summary or label must be provided using the <summary> element.\n
A disclosure widget is typically presented onscreen using a small triangle that rotates (or twists) to indicate open/closed status, with a label next to the triangle. The contents of the <summary> element are used as the label for the disclosure widget. The contents of the <details> provide the accessible description for the <summary>.\n
A <details> widget can be in one of two states. The default closed state displays only the triangle and the label inside <summary> (or a user agent-defined default string if no <summary>).\n
When the user clicks on the widget or focuses it then presses the space bar, it \"twists\" open, revealing its contents. The common use of a triangle which rotates or twists around to represent opening or closing the widget is why these are sometimes called \"twisty\".\n
You can use CSS to style the disclosure widget, and you can programmatically open and close the widget by setting/removing its open attribute. Unfortunately, at this time, there's no built-in way to animate the transition between open and closed.\n
By default when closed, the widget is only tall enough to display the disclosure triangle and summary. When open, it expands to display the details contained within.\n
Fully standards-compliant implementations automatically apply the CSS display: list-item<summary> element. You can use this to customize its appearance further. See Customizing the disclosure widget for further details.",
"details": {
"Content categories": "Flow content\n, sectioning root, interactive content, palpable content.\n",
"Permitted content": "One\n<summary>\nelement followed by\nflow content\n.\n",
@@ -2992,7 +3019,7 @@
"Safari": "5.1",
"SafariIOS": "5"
},
- "doc": "The <figcaption> HTML element represents a caption or legend describing the rest of the contents of its parent <figure> element.",
+ "doc": "The <figcaption> HTML element represents a caption or legend describing the rest of the contents of its parent <figure> element, providing the <figure> an accessible description.",
"details": {
"Content categories": "None.\n",
"Permitted content": "Flow content\n.\n",
@@ -3904,6 +3931,16 @@
},
"csp": {
"url": "$MDN_URL$/web/html/element/iframe#csp",
+ "status": [
+ "Experimental",
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "61",
+ "ChromeAndroid": "61",
+ "Edge": "79",
+ "Opera": "48"
+ },
"doc": "A Content Security Policy enforced for the embedded resource. See HTMLIFrameElement.csp for details."
},
"frameborder": {
@@ -4337,7 +4374,7 @@
"Safari": "15.4",
"SafariIOS": "15.4"
},
- "doc": "Indicates how the browser should load the image:\n
eagerLoads the image immediately, regardless of whether or not the image is currently within the visible viewport (this is the default value).\n
lazyDefers loading the image until it reaches a calculated distance from the viewport, as defined by the browser. The intent is to avoid the network and storage bandwidth needed to handle the image until it's reasonably certain that it will be needed. This generally improves the performance of the content in most typical use cases.\n
Note: Loading is only deferred when JavaScript is enabled. This is an anti-tracking measure, because if a user agent supported lazy loading when scripting is disabled, it would still be possible for a site to track a user's approximate scroll position throughout a session, by strategically placing images in a page's markup such that a server can track how many images are requested and when.\n
eagerLoads the image immediately, regardless of whether or not the image is currently within the visible viewport (this is the default value).\n
lazyDefers loading the image until it reaches a calculated distance from the viewport, as defined by the browser. The intent is to avoid the network and storage bandwidth needed to handle the image until it's reasonably certain that it will be needed. This generally improves the performance of the content in most typical use cases.\n
Note: Loading is only deferred when JavaScript is enabled. This is an anti-tracking measure, because if a user agent supported lazy loading when scripting is disabled, it would still be possible for a site to track a user's approximate scroll position throughout a session, by strategically placing images in a page's markup such that a server can track how many images are requested and when.\nNote: Images with loading set to lazy will never be loaded if they do not intersect a visible part of an element, even if loading them would change that as unloaded images have a width and height of 0. Putting width and height on lazyloaded images fixes this issue and is a best practice, recommended by the specification. Doing so also helps prevent layout shifts.\n
type attribute, this attribute identifies the scripting language in use. Unlike the type attribute, however, this attribute's possible values were never standardized. The type attribute should be used instead."
},
"nomodule": {
@@ -8109,7 +8164,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "The <table> HTML element represents tabular data — that is, information presented in a two-dimensional table comprised of rows and columns of cells containing data.",
+ "doc": "The <table> HTML element represents tabular data—that is, information presented in a two-dimensional table comprised of rows and columns of cells containing data.",
"details": {
"Content categories": "Flow content\n",
"Permitted content": "In this order:\n<caption> element,<colgroup> elements,<thead> element,<tfoot> elementleft: the table is displayed on the left side of the document;center: the table is displayed in the center of the document;right: the table is displayed on the right side of the document.Set margin-left and margin-right to achieve an effect that is similar to the align attribute:\n
left: margin-right: auto; margin-left: 0;center: margin-right: auto; margin-left: auto;right: margin-right: 0; margin-left: auto;left, center, and right. Use the margin-inline-start and margin-inline-end CSS properties instead, as this attribute is deprecated."
},
"bgcolor": {
"url": "$MDN_URL$/web/html/element/table#bgcolor",
@@ -8152,7 +8207,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "The background color of the table. It is a 6-digit hexadecimal RGB code, prefixed by a '#'. One of the predefined color keywords can also be used.\nTo achieve a similar effect, use the CSS background-color property."
+ "doc": "Defines the background color of the table. The value is an HTML color; either a 6-digit hexadecimal RGB code, prefixed by a '#', or a color keyword. Other CSS <color> values are not supported. Use the background-color CSS property instead, as this attribute is deprecated."
},
"border": {
"url": "$MDN_URL$/web/html/element/table#border",
@@ -8169,7 +8224,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This integer attribute defines, in pixels, the size of the frame surrounding the table. If set to 0, the frame attribute is set to void.\n
To achieve a similar effect, use the CSS border shorthand property."
+ "doc": "Defines, as a non-negative integer value (in pixels), the size of the frame surrounding the table. If set to 0, the frame attribute is set to void. Use the border CSS property instead, as this attribute is deprecated."
},
"cellpadding": {
"url": "$MDN_URL$/web/html/element/table#cellpadding",
@@ -8186,7 +8241,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute defines the space between the content of a cell and its border, displayed or not. If the cellpadding's length is defined in pixels, this pixel-sized space will be applied to all four sides of the cell's content. If the length is defined using a percentage value, the content will be centered and the total vertical space (top and bottom) will represent this value. The same is true for the total horizontal space (left and right).\n
To achieve a similar effect, apply the border-collapse property to the <table> element, with its value set to collapse, and the padding property to the <td> elements."
+ "doc": "Defines the space between the content of a cell and its border, displayed or not. If the cellpadding's length is defined in pixels, this pixel-sized space will be applied to all four sides of the cell's content. If the length is defined using a percentage value, the content will be centered and the total vertical space (top and bottom) will represent this value. The same is true for the total horizontal space (left and right). Apply the border-collapse CSS property to the <table> element, with its value set to collapse, and the padding CSS property to the <td> elements instead, as this attribute is deprecated."
},
"cellspacing": {
"url": "$MDN_URL$/web/html/element/table#cellspacing",
@@ -8203,7 +8258,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute defines the size of the space between two cells in a percentage value or pixels. The attribute is applied both horizontally and vertically, to the space between the top of the table and the cells of the first row, the left of the table and the first column, the right of the table and the last column and the bottom of the table and the last row.\n
To achieve a similar effect, apply the border-spacing property to the <table> element. border-spacing does not have any effect if border-collapse is set to collapse."
+ "doc": "Defines the size of the space between two cells in a percentage value or pixels. The attribute is applied both horizontally and vertically, to the space between the top of the table and the cells of the first row, the left of the table and the first column, the right of the table and the last column and the bottom of the table and the last row. Apply the border-spacing CSS property to the <table> element instead, as this attribute is deprecated. border-spacing does not have any effect if the border-collapse CSS property is set to collapse."
},
"frame": {
"url": "$MDN_URL$/web/html/element/table#frame",
@@ -8220,7 +8275,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This enumerated attribute defines which side of the frame surrounding the table must be displayed.\n
To achieve a similar effect, use the border-style and border-width properties."
+ "doc": "Defines which side of the frame surrounding the table must be displayed. The possible enumerated values are void, above, below, hsides, vsides, lhs, rhs, box and border. Use the border-style and border-width CSS properties instead, as this attribute is deprecated."
},
"rules": {
"url": "$MDN_URL$/web/html/element/table#rules",
@@ -8237,7 +8292,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This enumerated attribute defines where rules, i.e. lines, should appear in a table. It can have the following values:\n
none, which indicates that no rules will be displayed; it is the default value;groups, which will cause the rules to be displayed between row groups (defined by the <thead>, <tbody> and <tfoot> elements) and between column groups (defined by the <col> and <colgroup> elements) only;rows, which will cause the rules to be displayed between rows;cols, which will cause the rules to be displayed between columns;all, which will cause the rules to be displayed between rows and columns.To achieve a similar effect, apply the border property to the appropriate <thead>, <tbody>, <tfoot>, <col>, or <colgroup> elements."
+ "doc": "Defines where rules (borders) are displayed in the table. The possible enumerated values are none (default value), groups (<thead>, <tbody>, and <tfoot> elements), rows (horizontal lines), cols (vertical lines), and all (border around every cell). Use the border CSS property on the appropriate table-related elements, as well as on the <table> itself, instead, as this attribute is deprecated."
},
"summary": {
"url": "$MDN_URL$/web/html/element/table#summary",
@@ -8254,7 +8309,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute defines an alternative text that summarizes the content of the table. Use the <caption> element instead."
+ "doc": "Defines an alternative text that summarizes the content of the table. Use the <caption> element instead, as this attribute is deprecated."
},
"width": {
"url": "$MDN_URL$/web/html/element/table#width",
@@ -8271,7 +8326,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute defines the width of the table. Use the CSS width property instead."
+ "doc": "Specifies the width of the table. Use the width CSS property instead, as this attribute is deprecated.\n
Note: While no HTML specification includes height as a <table> attribute, some browsers support a non-standard interpretation of height. The unitless value sets a minimum absolute height in pixels. If set as a percent value, the minimum table height will be relative to the parent container's height. Use the min-height CSS property instead, as this attribute is deprecated.\n
<tbody> HTML element encapsulates a set of table rows (<tr> elements), indicating that they comprise the body of the table (<table>).\nThe <tbody> element, along with its related <thead> and <tfoot> elements, provide useful semantic information that can be used when rendering for either screen or printer.",
+ "doc": "The <tbody> HTML element encapsulates a set of table rows (<tr> elements), indicating that they comprise the body of a table's (main) data.",
"details": {
"Content categories": "None.\n",
"Permitted content": "Zero or more\n<tr>\nelements.\n",
- "Tag omission": "A\n<tbody>\nelement's start tag can be omitted if the first thing inside the\n<tbody>\nelement is a\n<tr>\nelement, and if the element is not immediately preceded by a\n<tbody>\n,\n<thead>\n, or\n<tfoot>\nelement whose end tag has been omitted. (It can't be omitted if the element is empty.)\nA\n<tbody>\nelement's end tag can be omitted if the\n<tbody>\nelement is immediately followed by a\n<tbody>\nor\n<tfoot>\nelement, or if there is no more content in the parent element.\n",
- "Permitted parents": "Within the required parent\n<table>\nelement,\nthe\n<tbody>\nelement can be added after a\n<caption>\n,\n<colgroup>\n, and a\n<thead>\nelement.\n",
+ "Tag omission": "A\n<tbody>\nelement's start tag can be omitted if the first thing inside the\n<tbody>\nelement is a\n<tr>\nelement, and if the element is not immediately preceded by a\n<tbody>\n,\n<thead>\n, or\n<tfoot>\nelement whose end tag has been omitted. (It can't be omitted if the element is empty.)\nA\n<tbody>\nelement's end tag can be omitted if the\n<tbody>\nelement is immediately followed by a\n<tbody>\nor\n<tfoot>\nelement, or if there is no more content in the parent element.\n",
+ "Permitted parents": "Within the required parent\n<table>\nelement,\nthe\n<tbody>\nelement can be added after any\n<caption>\n,\n<colgroup>\n,\nand\n<thead>\nelements.\n",
"Implicit ARIA role": "rowgroup\n",
"Permitted ARIA roles": "Any\n",
"DOM interface": "HTMLTableSectionElement\n"
@@ -8315,7 +8370,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This enumerated attribute specifies how horizontal alignment of each cell content will be handled. Possible values are:\n
left, aligning the content to the left of the cellcenter, centering the content in the cellright, aligning the content to the right of the celljustify, inserting spaces into the textual content so that the content is justified in the cellchar, aligning the textual content on a special character with a minimal offset, defined by the char and charoff attributes.If this attribute is not set, the left value is assumed.\n
As this attribute is deprecated, use the CSS text-align property instead.\n
Note: The equivalent text-align property for the align=\"char\" is not implemented in any browsers yet. See the text-align's browser compatibility section for the <string> value.\n
left, center, right, justify, and char. When supported, the char value aligns the textual content on the character defined in the char attribute and on offset defined by the charoff attribute. Use the text-align CSS property instead, as this attribute is deprecated."
},
"bgcolor": {
"url": "$MDN_URL$/web/html/element/tbody#bgcolor",
@@ -8332,7 +8387,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "The background color of the table. It is a 6-digit hexadecimal RGB code, prefixed by a '#'. One of the predefined color keywords can also be used.\nAs this attribute is deprecated, use the CSS background-color property instead."
+ "doc": "Defines the background color of each body cell. The value is an HTML color; either a 6-digit hexadecimal RGB code, prefixed by a '#', or a color keyword. Other CSS <color> values are not supported. Use the background-color CSS property instead, as this attribute is deprecated."
},
"char": {
"url": "$MDN_URL$/web/html/element/tbody#char",
@@ -8348,7 +8403,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This attribute is used to set the character to align the cells in a column on. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored."
+ "doc": "Specifies the alignment of the content to a character of each body cell. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored."
},
"charoff": {
"url": "$MDN_URL$/web/html/element/tbody#charoff",
@@ -8365,7 +8420,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This attribute is used to indicate the number of characters to offset the column data from the alignment characters specified by the char attribute."
+ "doc": "Specifies the number of characters to offset the body cell content from the alignment character specified by the char attribute."
},
"valign": {
"url": "$MDN_URL$/web/html/element/tbody#valign",
@@ -8382,7 +8437,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This attribute specifies the vertical alignment of the text within each row of cells of the table header. Possible values for this attribute are:\n
baseline, which will put the text as close to the bottom of the cell as it is possible, but align it on the baseline of the characters instead of the bottom of them. If characters are all of the size, this has the same effect as bottom.bottom, which will put the text as close to the bottom of the cell as it is possible;middle, which will center the text in the cell;top, which will put the text as close to the top of the cell as it is possible.As this attribute is deprecated, use the CSS vertical-align property instead."
+ "doc": "Specifies the vertical alignment of each body cell. The possible enumerated values are baseline, bottom, middle, and top. Use the vertical-align CSS property instead, as this attribute is deprecated."
}
}
},
@@ -8400,7 +8455,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "The <td> HTML element defines a cell of a table that contains data. It participates in the table model.",
+ "doc": "The <td> HTML element defines a cell of a table that contains data and may be used as a child of the <tr> element.",
"details": {
"Content categories": "Sectioning root.\n",
"Permitted content": "Flow content\n.\n",
@@ -8426,7 +8481,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute contains a short abbreviated description of the cell's content. Some user-agents, such as speech readers, may present this description before the content itself.\n
Note: Do not use this attribute as it is obsolete in the latest standard. Alternatively, you can put the abbreviated description inside the cell and place the long content in the title attribute.\n
title attribute, as this attribute is deprecated. Or, preferably, include the content within the data cell, and use CSS to visually clip overflowing text."
},
"align": {
"url": "$MDN_URL$/web/html/element/td#align",
@@ -8443,7 +8498,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This enumerated attribute specifies how the cell content's horizontal alignment will be handled. Possible values are:\nleft: The content is aligned to the left of the cell.center: The content is centered in the cell.right: The content is aligned to the right of the cell.justify (with text only): The content is stretched out inside the cell so that it covers its entire width.char (with text only): The content is aligned to a character inside the <th> element with minimal offset. This character is defined by the char and charoff attributes.The default value when this attribute is not specified is left.\n
Note:\n
left, center, right or justify values, apply the CSS text-align property to the element.char value, give the text-align property the same value you would use for the char.left, center, right, justify, and char. When supported, the char value aligns the textual content on the character defined in the char attribute and the offset defined by the charoff attribute. Use the text-align CSS property instead, as this attribute is deprecated."
},
"axis": {
"url": "$MDN_URL$/web/html/element/td#axis",
@@ -8460,7 +8515,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute contains a list of space-separated strings. Each string is the id of a group of cells that this header applies to."
+ "doc": "Contains a list of space-separated strings, each corresponding to the id attribute of a group of cells that the data cell applies to."
},
"bgcolor": {
"url": "$MDN_URL$/web/html/element/td#bgcolor",
@@ -8477,7 +8532,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute defines the background color of each cell in a column. It is a 6-digit hexadecimal RGB code, prefixed by a '#'. One of the predefined color keywords can also be used.\nTo achieve a similar effect, use the CSS background-color property."
+ "doc": "Defines the background color of the data cell. The value is an HTML color; either a 6-digit hexadecimal RGB code, prefixed by a '#', or a color keyword. Other CSS <color> values are not supported. Use the background-color CSS property instead, as this attribute is deprecated."
},
"char": {
"url": "$MDN_URL$/web/html/element/td#char",
@@ -8493,7 +8548,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "The content in the cell element is aligned to a character. Typical values include a period (.) to align numbers or monetary values. If align is not set to char, this attribute is ignored."
+ "doc": "Specifies the alignment of the content to a character of the data cell. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored."
},
"charoff": {
"url": "$MDN_URL$/web/html/element/td#charoff",
@@ -8510,7 +8565,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This attribute is used to shift column data to the right of the character specified by the char attribute. Its value specifies the length of this shift."
+ "doc": "Specifies the number of characters to offset the data cell content from the alignment character specified by the char attribute."
},
"colspan": {
"url": "$MDN_URL$/web/html/element/td#colspan",
@@ -8526,7 +8581,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute contains a non-negative integer value that indicates for how many columns the cell extends. Its default value is 1. Values higher than 1000 will be considered as incorrect and will be set to the default value (1)."
+ "doc": "Contains a non-negative integer value that indicates how many columns the data cell spans or extends. The default value is 1. User agents dismiss values higher than 1000 as incorrect, setting to the default value (1)."
},
"headers": {
"url": "$MDN_URL$/web/html/element/td#headers",
@@ -8542,11 +8597,11 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute contains a list of space-separated strings, each corresponding to the id attribute of the <th> elements that apply to this element."
+ "doc": "Contains a list of space-separated strings, each corresponding to the id attribute of the <th> elements that provide headings for this table cell."
},
"height": {
"url": "$MDN_URL$/web/html/element/td#height",
- "doc": "This attribute is used to define a recommended cell height. Use the CSS height property instead."
+ "doc": "Defines a recommended data cell height. Use the height CSS property instead, as this attribute is deprecated."
},
"rowspan": {
"url": "$MDN_URL$/web/html/element/td#rowspan",
@@ -8562,7 +8617,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute contains a non-negative integer value that indicates for how many rows the cell extends. Its default value is 1; if its value is set to 0, it extends until the end of the table section (<thead>, <tbody>, <tfoot>, even if implicitly defined), that the cell belongs to. Values higher than 65534 are clipped down to 65534."
+ "doc": "Contains a non-negative integer value that indicates for how many rows the data cell spans or extends. The default value is 1; if its value is set to 0, it extends until the end of the table grouping section (<thead>, <tbody>, <tfoot>, even if implicitly defined), that the cell belongs to. Values higher than 65534 are clipped to 65534."
},
"scope": {
"url": "$MDN_URL$/web/html/element/td#scope",
@@ -8579,7 +8634,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This enumerated attribute defines the cells that the header (defined in the <th>) element relates to. Only use this attribute with the <th> element to define the row or column for which it is a header."
+ "doc": "Defines the cells that the header (defined in the <th>) element relates to. The possible enumerated values are row, col, rowgroup, and colgroup. Only use this attribute with the <th> element to define the row or column for which it is a header, as this attribute is deprecated for the <td> element."
},
"valign": {
"url": "$MDN_URL$/web/html/element/td#valign",
@@ -8596,7 +8651,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This attribute specifies how a text is vertically aligned inside a cell. Possible values for this attribute are:\n
baseline: Positions the text near the bottom of the cell and aligns it with the baseline of the characters instead of the bottom. If characters don't descend below the baseline, the baseline value achieves the same effect as bottom.bottom: Positions the text near the bottom of the cell.middle: Centers the text in the cell.top: Positions the text near the top of the cell.To achieve a similar effect, use the CSS vertical-align property."
+ "doc": "Specifies the vertical alignment of the data cell. The possible enumerated values are baseline, bottom, middle, and top. Use the vertical-align CSS property instead, as this attribute is deprecated."
},
"width": {
"url": "$MDN_URL$/web/html/element/td#width",
@@ -8613,7 +8668,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute is used to define a recommended cell width. Use the CSS width property instead."
+ "doc": "Defines a recommended data cell width. Use the width CSS property instead, as this attribute is deprecated."
}
}
},
@@ -8631,7 +8686,7 @@
"Safari": "8",
"SafariIOS": "8"
},
- "doc": "The <template> HTML element is a mechanism for holding HTML that is not to be rendered immediately when a page is loaded but may be instantiated subsequently during runtime using JavaScript.\n
Think of a template as a content fragment that is being stored for subsequent use in the document. While the parser does process the contents of the <template> element while loading the page, it does so only to ensure that those contents are valid; the element's contents are not rendered, however.",
+ "doc": "The <template> HTML element serves as a mechanism for holding HTML fragments, which can either be used later via JavaScript or generated immediately into shadow DOM.",
"details": {
"Content categories": "Metadata content\n,\nflow content\n,\nphrasing content\n,\nscript-supporting element\n",
"Permitted content": "No restrictions\n",
@@ -8655,7 +8710,8 @@
"Opera": "97",
"Safari": "16.4",
"SafariIOS": "16.4"
- }
+ },
+ "doc": "Creates a shadow root for the parent element. It is a declarative version of the Element.attachShadow() method and accepts the same enumerated values.\n
openExposes the internal shadow root DOM for JavaScript (recommended for most use cases).\n
closedHides the internal shadow root DOM from JavaScript.\n
Note: This is a feature of the HTML parser that cannot be used post-parsing by setting the shadowrootmode attribute through JavaScript. Only allowed values will create the shadow root; any other values, including empty ones, won't trigger this behavior.\n
Note: You may find the non-standard shadowroot attribute in older tutorials and examples that used to be supported in Chrome 90-110. This attribute has since been removed and replaced by the standard shadowrootmode attribute.\n
<tfoot> HTML element defines a set of rows summarizing the columns of the table.",
+ "doc": "The <tfoot> HTML element encapsulates a set of table rows (<tr> elements), indicating that they comprise the foot of a table with information about the table's columns. This is usually a summary of the columns, e.g., a sum of the given numbers in a column.",
"details": {
"Content categories": "None.\n",
"Permitted content": "Zero or more\n<tr>\nelements.\n",
"Tag omission": "The start tag is mandatory. The end tag may be omitted if there is no\nmore content in the parent\n<table>\nelement.\n",
- "Permitted parents": "A\n<table>\nelement. The\n<tfoot>\nmust appear after any\n<caption>\n,\n<colgroup>\n,\n<thead>\n,\n<tbody>\n, or\n<tr>\nelement. Note that this is the requirement in HTML.\n<tfoot>\nelement could not be placed after any\n<tbody>\nor\n<tr>\nelement.\n",
+ "Permitted parents": "A\n<table>\nelement. The\n<tfoot>\nmust appear after any\n<caption>\n,\n<colgroup>\n,\n<thead>\n,\n<tbody>\n, and\n<tr>\nelements. Note that this is the requirement in HTML.\n<tfoot>\nelement could not be placed after any\n<tbody>\nand\n<tr>\nelements.\n",
"Implicit ARIA role": "rowgroup\n",
"Permitted ARIA roles": "Any\n",
"DOM interface": "HTMLTableSectionElement\n"
@@ -8962,7 +9018,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This enumerated attribute specifies how horizontal alignment of each cell content will be handled. Possible values are:\nleft, aligning the content to the left of the cellcenter, centering the content in the cellright, aligning the content to the right of the celljustify, inserting spaces into the textual content so that the content is justified in the cellchar, aligning the textual content on a special character with a minimal offset, defined by the char and charoff attributes.If this attribute is not set, the left value is assumed.\n
Note:\n
left, center, right or justify values, use the CSS text-align property on it.char value, in CSS, you can use the value of the char as the value of the text-align property.left, center, right, justify, and char. When supported, the char value aligns the textual content on the character defined in the char attribute and on offset defined by the charoff attribute. Use the text-align CSS property instead, as this attribute is deprecated."
},
"bgcolor": {
"url": "$MDN_URL$/web/html/element/tfoot#bgcolor",
@@ -8979,7 +9035,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "The background color of the table. It is a 6-digit hexadecimal RGB code, prefixed by a '#'. One of the predefined color keywords can also be used.\nTo achieve a similar effect, use the CSS background-color property."
+ "doc": "Defines the background color of each foot cell. The value is an HTML color; either a 6-digit hexadecimal RGB code, prefixed by a '#', or a color keyword. Other CSS <color> values are not supported. Use the background-color CSS property instead, as this attribute is deprecated."
},
"char": {
"url": "$MDN_URL$/web/html/element/tfoot#char",
@@ -8995,7 +9051,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This attribute specifies the alignment of the content in a column to a character. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored."
+ "doc": "Specifies the alignment of the content to a character of each foot cell. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored."
},
"charoff": {
"url": "$MDN_URL$/web/html/element/tfoot#charoff",
@@ -9012,7 +9068,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This attribute is used to indicate the number of characters to offset the column data from the alignment characters specified by the char attribute."
+ "doc": "Specifies the number of characters to offset the foot cell content from the alignment character specified by the char attribute."
},
"valign": {
"url": "$MDN_URL$/web/html/element/tfoot#valign",
@@ -9029,7 +9085,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This attribute specifies the vertical alignment of the text within each row of cells of the table footer. Possible values for this attribute are:\n
baseline, which will put the text as close to the bottom of the cell as it is possible, but align it on the baseline of the characters instead of the bottom of them. If characters are all of the size, this has the same effect as bottom.bottom, which will put the text as close to the bottom of the cell as it is possible;middle, which will center the text in the cell;top, which will put the text as close to the top of the cell as it is possible.Note: Do not use this attribute as it is obsolete (and not supported) in the latest standard: instead set the CSS vertical-align property on it.\n
baseline, bottom, middle, and top. Use the vertical-align CSS property instead, as this attribute is deprecated."
}
}
},
@@ -9047,7 +9103,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "The <th> HTML element defines a cell as the header of a group of table cells. The exact nature of this group is defined by the scope and headers attributes.",
+ "doc": "The <th> HTML element defines a cell as the header of a group of table cells and may be used as a child of the <tr> element. The exact nature of this group is defined by the scope and headers attributes.",
"details": {
"Content categories": "None.\n",
"Permitted content": "Flow content\n, but with no header, footer, sectioning content, or heading content\ndescendants.\n",
@@ -9072,7 +9128,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute contains a short abbreviated description of the cell's content. Some user-agents, such as speech readers, may present this description before the content itself."
+ "doc": "A short, abbreviated description of the header cell's content provided as an alternative label to use for the header cell when referencing the cell in other contexts. Some user-agents, such as speech readers, may present this description before the content itself."
},
"align": {
"url": "$MDN_URL$/web/html/element/th#align",
@@ -9089,7 +9145,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This enumerated attribute specifies how the cell content's horizontal alignment will be handled. Possible values are:\nleft: The content is aligned to the left of the cell.center: The content is centered in the cell.right: The content is aligned to the right of the cell.justify (with text only): The content is stretched out inside the cell so that it covers its entire width.char (with text only): The content is aligned to a character inside the <th> element with minimal offset. This character is defined by the char and charoff attributes.The default value when this attribute is not specified is left.\n
Note: Do not use this attribute as it is obsolete in the latest standard.\n
left, center, right or justify values, apply the CSS text-align property to the element.char value, give the text-align property the same value you would use for the char.left, center, right, justify, and char. When supported, the char value aligns the textual content on the character defined in the char attribute and the offset defined by the charoff attribute. Use the text-align CSS property instead, as this attribute is deprecated."
},
"axis": {
"url": "$MDN_URL$/web/html/element/th#axis",
@@ -9106,7 +9162,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute contains a list of space-separated strings. Each string is the id of a group of cells that this header applies to.\nNote: Do not use this attribute as it is obsolete in the latest standard: use the scope attribute instead.\n
id attribute of a group of cells that the header cell applies to. Use the scope attribute instead, as this attribute is deprecated."
},
"bgcolor": {
"url": "$MDN_URL$/web/html/element/th#bgcolor",
@@ -9123,7 +9179,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute defines the background color of each cell in a column. It consists of a 6-digit hexadecimal code as defined in sRGB and is prefixed by '#'."
+ "doc": "Defines the background color of the header cell. The value is an HTML color; either a 6-digit hexadecimal RGB code, prefixed by a '#', or a color keyword. Other CSS <color> values are not supported. Use the background-color CSS property instead, as this attribute is deprecated."
},
"char": {
"url": "$MDN_URL$/web/html/element/th#char",
@@ -9139,7 +9195,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "The content in the cell element is aligned to a character. Typical values include a period (.) to align numbers or monetary values. If align is not set to char, this attribute is ignored.\nNote: Do not use this attribute as it is obsolete in the latest standard. To achieve the same effect, you can specify the character as the first value of the text-align property.\n
.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored."
},
"charoff": {
"url": "$MDN_URL$/web/html/element/th#charoff",
@@ -9156,7 +9212,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This attribute is used to shift column data to the right of the character specified by the char attribute. Its value specifies the length of this shift.\nNote: Do not use this attribute as it is obsolete in the latest standard.\n
char attribute."
},
"colspan": {
"url": "$MDN_URL$/web/html/element/th#colspan",
@@ -9172,7 +9228,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute contains a non-negative integer value that indicates for how many columns the cell extends. Its default value is 1. Values higher than 1000 will be considered as incorrect and will be set to the default value (1)."
+ "doc": "A non-negative integer value indicating how many columns the header cell spans or extends. The default value is 1. User agents dismiss values higher than 1000 as incorrect, defaulting such values to 1."
},
"headers": {
"url": "$MDN_URL$/web/html/element/th#headers",
@@ -9188,11 +9244,11 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute contains a list of space-separated strings, each corresponding to the id attribute of the <th> elements that apply to this element."
+ "doc": "A list of space-separated strings corresponding to the id attributes of the <th> elements that provide the headers for this header cell."
},
"height": {
"url": "$MDN_URL$/web/html/element/th#height",
- "doc": "This attribute is used to define a recommended cell height.\nNote: Do not use this attribute as it is obsolete in the latest standard: use the CSS height property instead.\n
height CSS property instead, as this attribute is deprecated."
},
"rowspan": {
"url": "$MDN_URL$/web/html/element/th#rowspan",
@@ -9208,7 +9264,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute contains a non-negative integer value that indicates for how many rows the cell extends. Its default value is 1; if its value is set to 0, it extends until the end of the table section (<thead>, <tbody>, <tfoot>, even if implicitly defined), that the cell belongs to. Values higher than 65534 are clipped down to 65534."
+ "doc": "A non-negative integer value indicating how many rows the header cell spans or extends. The default value is 1; if its value is set to 0, the header cell will extends to the end of the table grouping section (<thead>, <tbody>, <tfoot>, even if implicitly defined), that the <th> belongs to. Values higher than 65534 are clipped at 65534."
},
"scope": {
"url": "$MDN_URL$/web/html/element/th#scope",
@@ -9224,7 +9280,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This enumerated attribute defines the cells that the header (defined in the <th>) element relates to. It may have the following values:\nrow: The header relates to all cells of the row it belongs to.col: The header relates to all cells of the column it belongs to.rowgroup: The header belongs to a rowgroup and relates to all of its cells.colgroup: The header belongs to a colgroup and relates to all of its cells.If the scope attribute is not specified, or its value is not row, col, or rowgroup, or colgroup, then browsers automatically select the set of cells to which the header cell applies."
+ "doc": "Defines the cells that the header (defined in the <th>) element relates to. Possible enumerated values are:\n
row: the header relates to all cells of the row it belongs to;col: the header relates to all cells of the column it belongs to;rowgroup: the header belongs to a rowgroup and relates to all of its cells;colgroup: the header belongs to a colgroup and relates to all of its cells.If the scope attribute is not specified, or its value is not row, col, rowgroup, or colgroup, then browsers automatically select the set of cells to which the header cell applies."
},
"valign": {
"url": "$MDN_URL$/web/html/element/th#valign",
@@ -9241,7 +9297,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This attribute specifies how a text is vertically aligned inside a cell. Possible values for this attribute are:\n
baseline: Positions the text near the bottom of the cell and aligns it with the baseline of the characters instead of the bottom. If characters don't descend below the baseline, the baseline value achieves the same effect as bottom.bottom: Positions the text near the bottom of the cell.middle: Centers the text in the cell.top: Positions the text near the top of the cell.Note: Do not use this attribute as it is obsolete in the latest standard: use the CSS vertical-align property instead.\n
baseline, bottom, middle, and top. Use the vertical-align CSS property instead, as this attribute is deprecated."
},
"width": {
"url": "$MDN_URL$/web/html/element/th#width",
@@ -9258,7 +9314,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute is used to define a recommended cell width. Additional space can be added with the cellspacing and cellpadding properties and the width of the <col> element can also create extra width. But, if a column's width is too narrow to show a particular cell properly, it will be widened when displayed.\nNote: Do not use this attribute as it is obsolete in the latest standard: use the CSS width property instead.\n
width CSS property instead, as this attribute is deprecated."
}
}
},
@@ -9276,12 +9332,12 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "The <thead> HTML element defines a set of rows defining the head of the columns of the table.",
+ "doc": "The <thead> HTML element encapsulates a set of table rows (<tr> elements), indicating that they comprise the head of a table with information about the table's columns. This is usually in the form of column headers (<th> elements).",
"details": {
"Content categories": "None.\n",
"Permitted content": "Zero or more\n<tr>\nelements.\n",
"Tag omission": "The start tag is mandatory. The end tag may be omitted if the\n<thead>\nelement is immediately followed by a\n<tbody>\nor\n<tfoot>\nelement.\n",
- "Permitted parents": "A\n<table>\nelement. The\n<thead>\nmust appear after any\n<caption>\nor\n<colgroup>\nelement, even implicitly defined,\nbut before any\n<tbody>\n,\n<tfoot>\nand\n<tr>\nelement.\n",
+ "Permitted parents": "A\n<table>\nelement. The\n<thead>\nmust appear after any\n<caption>\nand\n<colgroup>\nelements, even implicitly defined,\nbut before any\n<tbody>\n,\n<tfoot>\n, and\n<tr>\nelements.\n",
"Implicit ARIA role": "rowgroup\n",
"Permitted ARIA roles": "Any\n",
"DOM interface": "HTMLTableSectionElement\n"
@@ -9302,7 +9358,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This enumerated attribute specifies how horizontal alignment of each cell content will be handled. Possible values are:\nleft, aligning the content to the left of the cellcenter, centering the content in the cellright, aligning the content to the right of the celljustify, inserting spaces into the textual content so that the content is justified in the cellchar, aligning the textual content on a special character with a minimal offset, defined by the char and charoff attributes.If this attribute is not set, the left value is assumed.\n
Warning: Do not use this attribute as it is obsolete (not supported) in the latest standard.\n
text-align property instead.left, center, right, justify, and char. When supported, the char value aligns the textual content on the character defined in the char attribute and the offset defined by the charoff attribute. Use the text-align CSS property instead, as this attribute is deprecated."
},
"bgcolor": {
"url": "$MDN_URL$/web/html/element/thead#bgcolor",
@@ -9319,7 +9375,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "This attribute defines the background color of each column cell. It accepts a 6-digit hexadecimal color or a named color. Alpha transparency is not supported.\nNote: Do not use this attribute, as it is non-standard. The thead element should be styled using the CSS background-color property, which can be applied to any element, including the thead, <tr>, <td> and <th> elements.\n
#', or a color keyword. Other CSS <color> values are not supported. Use the background-color CSS property instead, as this attribute is deprecated."
},
"char": {
"url": "$MDN_URL$/web/html/element/thead#char",
@@ -9335,7 +9391,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This attribute is used to set the character to align the cells in a column on. Typical values for this include a period (.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored.\nNote: Do not use this attribute as it is obsolete (and not supported) in the latest standard.\n
align is not set to char, this attribute is ignored."
},
"charoff": {
"url": "$MDN_URL$/web/html/element/thead#charoff",
@@ -9352,7 +9408,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "This attribute is used to indicate the number of characters to offset the column data from the alignment characters specified by the char attribute.\nNote: Do not use this attribute as it is obsolete (and not supported) in the latest standard.\n
char attribute."
},
"valign": {
"url": "$MDN_URL$/web/html/element/thead#valign",
@@ -9369,7 +9425,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "This attribute specifies the vertical alignment of the text within each row of cells of the table header. Possible values for this attribute are:\nbaseline, which will put the text as close to the bottom of the cell as it is possible, but align it on the baseline of the characters instead of the bottom of them. If characters are all of the size, this has the same effect as bottom.bottom, which will put the text as close to the bottom of the cell as it is possible;middle, which will center the text in the cell;top, which will put the text as close to the top of the cell as it is possible.Note: Do not use this attribute as it is obsolete (and not supported) in the latest standard: instead set the CSS vertical-align property on it.\n
baseline, bottom, middle, and top. Use the vertical-align CSS property instead, as this attribute is deprecated."
}
}
},
@@ -9455,12 +9511,12 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "The <tr> HTML element defines a row of cells in a table. The row's cells can then be established using a mix of <td> (data cell) and <th> (header cell) elements.\nTo provide additional control over how cells fit into (or span across) columns, both <th> and <td> support the colspan attribute, which lets you specify how many columns wide the cell should be, with the default being 1. Similarly, you can use the rowspan attribute on cells to indicate they should span more than one table row.\n
This can take a little practice to get right when building your tables. We have some examples below, but for more examples and an in-depth tutorial, see the HTML tables series in our Learn web development area, where you'll learn how to use the table elements and their attributes to get just the right layout and formatting for your tabular data.",
+ "doc": "The <tr> HTML element defines a row of cells in a table. The row's cells can then be established using a mix of <td> (data cell) and <th> (header cell) elements.",
"details": {
"Content categories": "None\n",
- "Permitted content": "Zero or more\n<td>\nand/or\n<th>\nelements;\nscript-supporting elements\n(\n<script>\nand\n<template>\n) are also allowed\n",
- "Tag omission": "Start tag is mandatory. End tag may be omitted if the\n<tr>\nelement is immediately followed by a\n<tr>\nelement, or if the row is the last element\nin its parent table group (\n<thead>\n,\n<tbody>\nor\n<tfoot>\n)\nelement\n",
- "Permitted parents": "<table>\n(only if the table has no child\n<tbody>\nelement, and even then only after any\n<caption>\n,\n<colgroup>\n, and\n<thead>\nelements); otherwise, the parent must\nbe\n<thead>\n,\n<tbody>\nor\n<tfoot>\n",
+ "Permitted content": "Zero or more\n<td>\nand/or\n<th>\nelements;\nscript-supporting elements\n(\n<script>\nand\n<template>\n) are also allowed.\n",
+ "Tag omission": "Start tag is mandatory. End tag may be omitted if the\n<tr>\nelement is immediately followed by a\n<tr>\nelement, or if the row is the last element\nin its parent table group (\n<thead>\n,\n<tbody>\nor\n<tfoot>\n)\nelement.\n",
+ "Permitted parents": "<table>\n(only if the table has no child\n<tbody>\nelement, and even then only after any\n<caption>\n,\n<colgroup>\n, and\n<thead>\nelements); otherwise, the parent must\nbe a\n<thead>\n,\n<tbody>\nor\n<tfoot>\nelement.\n",
"Implicit ARIA role": "row\n",
"Permitted ARIA roles": "Any\n",
"DOM interface": "HTMLTableRowElement\n"
@@ -9481,7 +9537,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "A string which specifies how the cell's context should be aligned horizontally within the cells in the row; this is shorthand for using align on every cell in the row individually. Possible values are:\n
leftAlign the content of each cell at its left edge.\n
centerCenter the contents of each cell between their left and right edges.\n
rightAlign the content of each cell at its right edge.\n
justifyWiden whitespaces within the text of each cell so that the text fills the full width of each cell (full justification).\n
charAlign each cell in the row on a specific character (such that each row in the column that is configured this way will horizontally align its cells on that character). This uses the char and charoff to establish the alignment character (typically \".\" or \",\" when aligning numerical data) and the number of characters that should follow the alignment character. This alignment type was never widely supported.\n
If no value is expressly set for align, the parent node's value is inherited.\n
Note: Instead of using the obsolete align attribute, you should instead use the CSS text-align property to establish left, center, right, or justify alignment for the row's cells. To apply character-based alignment, set the CSS text-align property to the alignment character (such as \".\" or \",\").\n
left, center, right, justify, and char. When supported, the char value aligns the textual content on the character defined in the char attribute and on offset defined by the charoff attribute. Use the text-align CSS property instead, as this attribute is deprecated."
},
"bgcolor": {
"url": "$MDN_URL$/web/html/element/tr#bgcolor",
@@ -9498,7 +9554,7 @@
"Safari": "",
"SafariIOS": ""
},
- "doc": "A string specifying a color to apply to the backgrounds of each of the row's cells. This can be either a hexadecimal #RRGGBB or #RGB value or a color keyword. Omitting the attribute or setting it to null in JavaScript causes the row's cells to inherit the row's parent element's background color.\nNote: The <tr> element should be styled using CSS. To give a similar effect as the bgcolor attribute, use the CSS property background-color.\n
#', or a color keyword. Other CSS <color> values are not supported. Use the background-color CSS property instead, as this attribute is deprecated."
},
"char": {
"url": "$MDN_URL$/web/html/element/tr#char",
@@ -9514,7 +9570,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "A string that sets the character to align the cells in each row's columns (each row's centering that uses the same character gets aligned with others using the same character. Typical values for this include a period (\".\") or comma (\",\") when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored.\nNote: This attribute is obsolete and rarely implemented anyway. To achieve the same effect as the char attribute, set the CSS text-align property to the same string you would specify for the char property, such as text-align: \".\".\n
.) when attempting to align numbers or monetary values. If align is not set to char, this attribute is ignored."
},
"charoff": {
"url": "$MDN_URL$/web/html/element/tr#charoff",
@@ -9530,7 +9586,7 @@
"Safari": "4",
"SafariIOS": "3.2"
},
- "doc": "A string indicating the number of characters on the tail end of the column's data should be displayed after the alignment character specified by the char attribute. For example, when displaying money values for currencies that use hundredths of a unit (such as the dollar, which is divided into 100 cents), you would typically specify a value of 2, so that in tandem with char being set to \".\", the values in a column would be cleanly aligned on the decimal points, with the number of cents properly displayed to the right of the decimal point.\nNote: This attribute is obsolete, and was never widely supported anyway.\n
char attribute."
},
"valign": {
"url": "$MDN_URL$/web/html/element/tr#valign",
@@ -9547,7 +9603,7 @@
"Safari": "3",
"SafariIOS": "2"
},
- "doc": "A string specifying the vertical alignment of the text within each cell in the row. Possible values for this attribute are:\nbaselineAligns each cell's content text as closely as possible to the bottom of the cell, handling alignment of different fonts and font sizes by aligning the characters along the baseline of the font(s) used in the row. If all the characters in the row are the same size, the effect is the same as bottom.\n
bottom,Draws the text in each of the row's cells as closely as possible to the bottom edge of those cells.\n
middleEach cell's text is vertically centered.\n
topEach cell's text is drawn as closely as possible to the top edge of the containing cell.\n
Note: Don't use the obsolete valign attribute. Instead, add the CSS vertical-align property to the row.\n
baseline, bottom, middle, and top. Use the vertical-align CSS property instead, as this attribute is deprecated."
}
}
},
@@ -9851,6 +9907,15 @@
},
"controlslist": {
"url": "$MDN_URL$/web/html/element/video#controlslist",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "58",
+ "ChromeAndroid": "58",
+ "Edge": "79",
+ "Opera": "45"
+ },
"doc": "The controlslist attribute, when specified, helps the browser select what controls to show for the video element whenever the browser shows its own set of controls (that is, when the controls attribute is specified).\nThe allowed values are nodownload, nofullscreen and noremoteplayback.\n
Use the disablepictureinpicture attribute if you want to disable the Picture-In-Picture mode (and the control)."
},
"crossorigin": {
@@ -9871,6 +9936,17 @@
},
"disablepictureinpicture": {
"url": "$MDN_URL$/web/html/element/video#disablepictureinpicture",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "69",
+ "ChromeAndroid": "105",
+ "Edge": "79",
+ "Opera": "56",
+ "Safari": "13.1",
+ "SafariIOS": "13.4"
+ },
"doc": "Prevents the browser from suggesting a Picture-in-Picture context menu or to request Picture-in-Picture automatically in some cases."
},
"disableremoteplayback": {
@@ -9926,6 +10002,17 @@
},
"playsinline": {
"url": "$MDN_URL$/web/html/element/video#playsinline",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "75",
+ "ChromeAndroid": "75",
+ "Edge": "79",
+ "Opera": "62",
+ "Safari": "10",
+ "SafariIOS": "10"
+ },
"doc": "A Boolean attribute indicating that the video is to be played \"inline\", that is within the element's playback area. Note that the absence of this attribute does not imply that the video will always be played in fullscreen."
},
"poster": {
diff --git a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/Svg.json b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/Svg.json
index c4c285af60bd..dd9821c97438 100644
--- a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/Svg.json
+++ b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/Svg.json
@@ -3654,9 +3654,7 @@
"ChromeAndroid": "65",
"Edge": "79",
"Firefox": "63",
- "Opera": "52",
- "Safari": "11.1",
- "SafariIOS": "11.3"
+ "Opera": "52"
},
"doc": "The decoding attribute, valid on <image> elements, provides a hint to the browser as to whether it should perform image decoding along with rendering other content in a single presentation step that looks more \"correct\" (sync), or render and present the other content first and then decode the image and present it later (async). In practice, async means that the next paint does not wait for the image to decode.\n
It is often difficult to perceive any noticeable effect when using decoding on static <image> elements. They'll likely be initially rendered as empty images while the image files are fetched (either from the network or from the cache) and then handled independently anyway, so the \"syncing\" of content updates is less apparent. However, the blocking of rendering while decoding happens, while often quite small, can be measured — even if it is difficult to observe with the human eye.\n
Using different decoding types can result in more noticeable differences when dynamically inserting <image> elements into the DOM via JavaScript — see SVGImageElement.decoding for more details.\n
Allowed values:\n
syncDecode the image synchronously along with rendering the other content, and present everything together.\n
asyncDecode the image asynchronously, after rendering and presenting the other content.\n
autoNo preference for the decoding mode; the browser decides what is best for the user. This is the default value.\n
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The CharacterBoundsUpdateEvent interface is a DOM event that represents a request from the operating system to know the bounds of certain characters within an editable region that's attached to an EditContext instance.\n
This interface inherits properties from Event."
},
@@ -8531,7 +8532,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The CharacterBoundsUpdateEvent() constructor returns a new CharacterBoundsUpdateEvent object.",
"parameters": {
@@ -8547,7 +8549,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The CharacterBoundsUpdateEvent.rangeEnd read-only property represents the offset of the last character within the editable text region for which the operating system needs the bounds."
},
@@ -8559,7 +8562,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The CharacterBoundsUpdateEvent.rangeStart read-only property represents the offset of the first character within the editable text region for which the operating system needs the bounds."
},
@@ -9106,6 +9110,7 @@
],
"compatibility": {
"Edge": "79",
+ "Firefox": "preview",
"Opera": "63",
"Safari": "13.1",
"SafariIOS": "13.4"
@@ -9125,10 +9130,7 @@
"StandardTrack"
],
"compatibility": {
- "Chrome": "66",
- "ChromeAndroid": "66",
- "Edge": "79",
- "Opera": "53",
+ "Firefox": "preview",
"Safari": "13.1",
"SafariIOS": "13.4"
},
@@ -9148,6 +9150,7 @@
"Chrome": "66",
"ChromeAndroid": "66",
"Edge": "79",
+ "Firefox": "preview",
"Opera": "63",
"Safari": "13.1",
"SafariIOS": "13.4"
@@ -9246,6 +9249,7 @@
"Chrome": "76",
"ChromeAndroid": "84",
"Edge": "79",
+ "Firefox": "preview",
"Opera": "63",
"Safari": "13.1",
"SafariIOS": "13.4"
@@ -9261,6 +9265,7 @@
"Chrome": "98",
"ChromeAndroid": "98",
"Edge": "98",
+ "Firefox": "preview",
"Opera": "84",
"Safari": "13.1",
"SafariIOS": "13.4"
@@ -9280,6 +9285,7 @@
"Chrome": "76",
"ChromeAndroid": "84",
"Edge": "79",
+ "Firefox": "preview",
"Opera": "63",
"Safari": "13.1",
"SafariIOS": "13.4"
@@ -9300,6 +9306,7 @@
"StandardTrack"
],
"compatibility": {
+ "Firefox": "preview",
"Safari": "13.1",
"SafariIOS": "13.4"
},
@@ -9314,6 +9321,7 @@
"Chrome": "76",
"ChromeAndroid": "84",
"Edge": "79",
+ "Firefox": "preview",
"Opera": "63",
"Safari": "13.1",
"SafariIOS": "13.4"
@@ -12015,7 +12023,8 @@
"compatibility": {
"Chrome": "121",
"ChromeAndroid": "121",
- "Firefox": "114"
+ "Firefox": "114",
+ "Opera": "107"
},
"doc": "The read-only supportsText property of the CSSImportRule interface returns the supports condition specified by the @import at-rule."
},
@@ -13757,6 +13766,7 @@
"compatibility": {
"Chrome": "118",
"ChromeAndroid": "118",
+ "Edge": "118",
"Opera": "104"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The CSSScopeRule interface of the CSS Object Model represents a CSS @scope at-rule."
@@ -13770,6 +13780,7 @@
"compatibility": {
"Chrome": "118",
"ChromeAndroid": "118",
+ "Edge": "118",
"Opera": "104"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The end property of the CSSScopeRule interface returns a string containing the value of the @scope at-rule's scope limit."
@@ -13783,6 +13794,7 @@
"compatibility": {
"Chrome": "118",
"ChromeAndroid": "118",
+ "Edge": "118",
"Opera": "104"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The start property of the CSSScopeRule interface returns a string containing the value of the @scope at-rule's scope root."
diff --git a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-e.json b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-e.json
index 2d7652fcd99b..bc0070a97e16 100644
--- a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-e.json
+++ b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-e.json
@@ -33,7 +33,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The EditContext interface represents the text edit context of an element that was made editable by using the EditContext API.\n
The EditContext API can be used to build rich text editors on the web that support advanced text input experiences, such as Input Method Editor (IME) composition, emoji picker, or any other platform-specific editing-related UI surfaces." }, @@ -45,7 +46,8 @@ ], "compatibility": { "Chrome": "121", - "Edge": "121" + "Edge": "121", + "Opera": "107" }, "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The attachedElements() method of the EditContext interface returns an Array that contains only one item. This item is the element that's associated with the EditContext object.",
"returns": "An Array containing one HTMLElement object.\n
There can only be one element associated to an EditContext instance, so the returned array will always contain one element. If the API is extended in the future to support multiple associated elements, the return value will be an array containing multiple elements."
@@ -58,7 +60,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The characterBounds() method of the EditContext interface returns an Array containing the list of bounding rectangles for the characters in the EditContext object.\n
The position and size of the characters in an EditContext object is used by the operating system to correctly position platform-specific editing-related UI surfaces such as an Input Method Editor (IME) window when needed. This is especially important in situations where the operating system can't automatically detect the position and size of the characters, such as when rendering text in a <canvas> element.\n
Web developers will most likely be interested in using the characterboundsupdate event together with the EditContext.updateCharacterBounds() method to update the character bounds when the operating system indicates that it requires information about the position and size of the characters.\n
The characterBounds() method returns the list of character bounds that were last updated with updateCharacterBounds(). The list doesn't contain an item for every character in the EditContext object, only for the characters that were updated with updateCharacterBounds(). To know where the characters are located in the EditContext object, use the EditContext.characterBoundsRangeStart property.",
"returns": "An Array containing DOMRect objects."
@@ -71,7 +74,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The characterBoundsRangeStart read-only property of the EditContext interface indicates the index of the character, within the editable text content, that corresponds to the first item in the characterBounds array.\n
For example, if the EditContent contains the characters abc, and if characterBoundRangeStart is 1, the first item in the characterBounds array contains the bounds for the character b."
},
@@ -83,7 +87,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The EditContext() constructor returns a new EditContext object.",
"parameters": {
@@ -98,7 +103,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The selectionEnd read-only property of the EditContext refers to the offset, within the editable text content, of the end of the current selection."
},
@@ -110,7 +116,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The selectionStart read-only property of the EditContext refers to the offset, within the editable text content, of the start of the current selection."
},
@@ -122,7 +129,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The text read-only property of the EditContext interface represents the editable content of the element."
},
@@ -134,7 +142,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The EditContext.updateCharacterBounds() method of the EditContext interface should be called as response to a characterboundsupdate event to inform the operating system about the position and size of the characters in the EditContext object.\n
The characterboundsupdate event is the only time you need to call the updateCharacterBounds() method.\n
The character bounds information is then used by the operating system to correctly position the Input Method Editor (IME) window when needed. This is especially important in situations where the operating system can't automatically detect the position and size of the characters, such as when rendering text in a <canvas> element.",
"parameters": {
@@ -150,7 +159,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The EditContext.updateControlBounds() method of the EditContext interface is used to inform the operating system about the position and size of the editable text region of the EditContext object.\n
Call this method to tell the operating system the bounds of the current editable region. You should call it when initializing the EditContext, and whenever the editable region's bounds change such as when the webpage is resized. These bounds are used to position platform-specific editing-related UI surfaces such as an Input Method Editor (IME) window.", "parameters": { @@ -165,7 +175,8 @@ ], "compatibility": { "Chrome": "121", - "Edge": "121" + "Edge": "121", + "Opera": "107" }, "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The updateSelection() method of the EditContext interface updates the internal state of the selection within the editable text context. This method is used to update the selection state when the user interacts with the text rendering in the EditContext's associated element, such as by clicking or dragging the mouse, or by using the keyboard.",
"parameters": {
@@ -181,7 +192,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The EditContext.updateSelectionBounds() method of the EditContext interface is used to inform the operating system about the bounds of the text selection within the editable region that's associated with the EditContext object.\n
Call this method to tell the operating system the bounds of the user's current selection. You should call the method whenever the user's selection changes in the editable region. The selection bounds are used by the operating system to help position the IME window or any other platform-specific editing-related UI surfaces.", "parameters": { @@ -196,7 +208,8 @@ ], "compatibility": { "Chrome": "121", - "Edge": "121" + "Edge": "121", + "Opera": "107" }, "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The updateText() method of the EditContext interface updates the internal text content of an EditContext object.\n
This method doesn't need to be used when the user types text in the associated element. The EditContext object will automatically update its internal text content, and will fire textupdate events as needed.\n
This method can, however, be used when the user interacts with the text content in other ways, such as when pasting text from the clipboard.",
"parameters": {
@@ -945,7 +958,7 @@
},
"doc": "The Element.attachShadow() method attaches a shadow DOM tree to the specified element and returns a reference to its ShadowRoot.",
"parameters": {
- "options": "An object which contains the following fields:
modeA string specifying the encapsulation mode for the shadow DOM tree. This can be one of:
openElements of the shadow root are accessible from JavaScript outside the root, for example using Element.shadowRoot:
closedDenies access to the node(s) of a closed shadow root from JavaScript outside it:
delegatesFocus OptionalA boolean that, when set to true, specifies behavior that mitigates custom element issues around focusability. When a non-focusable part of the shadow DOM is clicked, the first focusable part is given focus, and the shadow host is given any available :focus styling. Its default value is false.
slotAssignment OptionalA string specifying the slot assignment mode for the shadow DOM tree. This can be one of:
namedElements are automatically assigned to <slot> elements within this shadow root. Any descendants of the host with a slot attribute which matches the name attribute of a <slot> within this shadow root will be assigned to that slot. Any top-level children of the host with no slot attribute will be assigned to a <slot> with no name attribute (the \"default slot\") if one is present.
manualElements are not automatically assigned to <slot> elements. Instead, they must be manually assigned with HTMLSlotElement.assign(). Its default value is named.
modeA string specifying the encapsulation mode for the shadow DOM tree. This can be one of:
openElements of the shadow root are accessible from JavaScript outside the root, for example using Element.shadowRoot:
closedDenies access to the node(s) of a closed shadow root from JavaScript outside it:
clonable OptionalA boolean that specifies whether the shadow root is clonable: when set to true, the shadow host cloned with Node.cloneNode() or Document.importNode() will include shadow root in the copy. Its default value is false, unless the shadow root is created via declarative shadow DOM.
delegatesFocus OptionalA boolean that, when set to true, specifies behavior that mitigates custom element issues around focusability. When a non-focusable part of the shadow DOM is clicked, the first focusable part is given focus, and the shadow host is given any available :focus styling. Its default value is false.
slotAssignment OptionalA string specifying the slot assignment mode for the shadow DOM tree. This can be one of:
namedElements are automatically assigned to <slot> elements within this shadow root. Any descendants of the host with a slot attribute which matches the name attribute of a <slot> within this shadow root will be assigned to that slot. Any top-level children of the host with no slot attribute will be assigned to a <slot> with no name attribute (the \"default slot\") if one is present.
manualElements are not automatically assigned to <slot> elements. Instead, they must be manually assigned with HTMLSlotElement.assign(). Its default value is named.
ShadowRoot object.",
"throws": {
@@ -1332,7 +1345,7 @@
"SafariIOS": "3.2"
},
"doc": "The Element.getBoundingClientRect() method returns a\nDOMRect object providing information about the size of an element and its\nposition relative to the viewport.",
- "returns": "The returned value is a DOMRect object which is the smallest rectangle\n which contains the entire element, including its padding and border-width. The\n left, top, right, bottom,\n x, y, width, and height properties\n describe the position and size of the overall rectangle in pixels. Properties other than\n width and height are relative to the top-left of the viewport.\n\n
The width and height properties of the DOMRect\n object returned by the method include the padding and\n border-width, not only the content width/height. In the standard box model,\n this would be equal to the width or height property of the\n element + padding + border-width. But\n if box-sizing: border-box is\n set for the element this would be directly equal to its width or\n height.\n
The returned value can be thought of as the union of the rectangles returned by\n getClientRects() for the element, i.e., the CSS\n border-boxes associated with the element.\n
Empty border-boxes are completely ignored. If all the element's border-boxes are empty,\n then a rectangle is returned with a width and height of zero\n and where the top and left are the top-left of the border-box\n for the first CSS box (in content order) for the element.\n
The amount of scrolling that has been done of the viewport area (or any other\n scrollable element) is taken into account when computing the bounding rectangle. This\n means that the rectangle's boundary edges (top, right,\n bottom, left) change their values every time the scrolling\n position changes (because their values are relative to the viewport and not absolute).\n
If you need the bounding rectangle relative to the top-left corner of the document,\n just add the current scrolling position to the top and left\n properties (these can be obtained using window.scrollY and\n window.scrollX) to get a bounding rectangle which is independent from the\n current scrolling position."
+ "returns": "The returned value is a DOMRect object which is the smallest rectangle\n which contains the entire element, including its padding and border-width. The\n left, top, right, bottom,\n x, y, width, and height properties\n describe the position and size of the overall rectangle in pixels. Properties other than\n width and height are relative to the top-left of the viewport.\n
\n
The width and height properties of the DOMRect\n object returned by the method include the padding and\n border-width, not only the content width/height. In the standard box model,\n this would be equal to the width or height property of the\n element + padding + border-width. But\n if box-sizing: border-box is\n set for the element this would be directly equal to its width or\n height.\n
The returned value can be thought of as the union of the rectangles returned by\n getClientRects() for the element, i.e., the CSS\n border-boxes associated with the element.\n
Empty border-boxes are completely ignored. If all the element's border-boxes are empty,\n then a rectangle is returned with a width and height of zero\n and where the top and left are the top-left of the border-box\n for the first CSS box (in content order) for the element.\n
The amount of scrolling that has been done of the viewport area (or any other\n scrollable element) is taken into account when computing the bounding rectangle. This\n means that the rectangle's boundary edges (top, right,\n bottom, left) change their values every time the scrolling\n position changes (because their values are relative to the viewport and not absolute).\n
If you need the bounding rectangle relative to the top-left corner of the document,\n just add the current scrolling position to the top and left\n properties (these can be obtained using window.scrollY and\n window.scrollX) to get a bounding rectangle which is independent from the\n current scrolling position."
},
"element.getclientrects": {
"url": "$MDN_URL$/web/api/element/getclientrects",
@@ -12606,6 +12619,21 @@
},
"doc": "The HTMLAnchorElement.pathname property is a\nstring containing an initial '/' followed by the path of\nthe URL not including the query string or fragment (or the empty string if there is no\npath)."
},
+ "htmlanchorelement.ping": {
+ "url": "$MDN_URL$/web/api/htmlanchorelement/ping",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "12",
+ "ChromeAndroid": "",
+ "Edge": "17",
+ "Opera": "15",
+ "Safari": "5.1",
+ "SafariIOS": "5"
+ },
+ "doc": "The ping property of the HTMLAnchorElement interface is a space-separated list of URLs. When the link is followed, the browser will send POST requests with the body PING to the URLs.\n
It reflects the ping attribute of the <a> element.\n
Note: This property is not effective in Firefox and its usage may be limited due to privacy and security concerns.\n
target property of the HTMLAnchorElement interface is a string that indicates where to display the linked resource.\nIt reflects the target attribute of the <a> element."
},
+ "htmlanchorelement.text": {
+ "url": "$MDN_URL$/web/api/htmlanchorelement/text",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "",
+ "Opera": "12.1",
+ "Safari": "",
+ "SafariIOS": ""
+ },
+ "doc": "The text property of the HTMLAnchorElement represents the text inside the the element.\nThis property represents the same information as Node.textContent."
+ },
"htmlanchorelement.tostring": {
"url": "$MDN_URL$/web/api/htmlanchorelement/tostring",
"status": [
@@ -12735,6 +12779,22 @@
"doc": "The HTMLAnchorElement.toString() stringifier\nmethod returns a string containing the whole URL. It is a read-only\nversion of HTMLAnchorElement.href.",
"returns": "A string containing the element's complete URL."
},
+ "htmlanchorelement.type": {
+ "url": "$MDN_URL$/web/api/htmlanchorelement/type",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "",
+ "Opera": "12.1",
+ "Safari": "",
+ "SafariIOS": ""
+ },
+ "doc": "The type property of the HTMLAnchorElement interface is a string that indicates the MIME type of the linked resource.\n
It reflects the type attribute of the <a> element."
+ },
"htmlanchorelement.username": {
"url": "$MDN_URL$/web/api/htmlanchorelement/username",
"status": [
@@ -12879,6 +12939,21 @@
},
"doc": "The HTMLAreaElement.pathname property is a\nstring containing an initial '/' followed by the path of\nthe URL not including the query string or fragment (or the empty string if there is no\npath)."
},
+ "htmlareaelement.ping": {
+ "url": "$MDN_URL$/web/api/htmlareaelement/ping",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "12",
+ "ChromeAndroid": "",
+ "Edge": "17",
+ "Opera": "15",
+ "Safari": "5.1",
+ "SafariIOS": "5"
+ },
+ "doc": "The ping property of the HTMLAreaElement interface is a space-separated list of URLs. When the link is followed, the browser will send POST requests with the body PING to the URLs.\n
It reflects the ping attribute of the <area> element.\n
Note: This property is not effective in Firefox and its usage may be limited due to privacy and security concerns.\n
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The editContext property of the HTMLElement interface gets and sets an element's associated EditContext object.\n
The EditContext API can be used to build rich text editors on the web that support advanced text input experiences, such as Input Method Editor (IME) composition, emoji picker, or any other platform-specific editing-related UI surfaces."
},
@@ -14329,6 +14405,38 @@
},
"doc": "The HTMLEmbedElement interface provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating <embed> elements.\n
Note: This topic describes the HTMLEmbedElement interface as defined in the standard. It does not address earlier, non-standardized version of the interface.\n
height property of the HTMLEmbedElement interface returns a string that reflects the height attribute of the <embed> element, indicating the displayed height of the resource in CSS pixels."
+ },
+ "htmlembedelement.width": {
+ "url": "$MDN_URL$/web/api/htmlembedelement/width",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "",
+ "Opera": "12.1",
+ "Safari": "3",
+ "SafariIOS": ""
+ },
+ "doc": "The width property of the HTMLEmbedElement interface returns a string that reflects the width attribute of the <embed> element, indicating the displayed width of the resource in CSS pixels."
+ },
"htmlfieldsetelement": {
"url": "$MDN_URL$/web/api/htmlfieldsetelement",
"status": [
@@ -14798,6 +14906,21 @@
},
"doc": "The HTMLIFrameElement interface provides special properties and methods (beyond those of the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of inline frame elements."
},
+ "htmliframeelement.allowfullscreen": {
+ "url": "$MDN_URL$/web/api/htmliframeelement/allowFullscreen",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "38",
+ "ChromeAndroid": "38",
+ "Edge": "",
+ "Firefox": "22",
+ "Opera": "25",
+ "Safari": "10.1"
+ },
+ "doc": "The allowFullscreen property of the HTMLIFrameElement interface is a boolean value that reflects the allowfullscreen attribute of the <iframe> element, indicating whether to allow the iframe's contents to use requestFullscreen().\n\n" + }, "htmliframeelement.allowpaymentrequest": { "url": "$MDN_URL$/web/api/htmliframeelement/allowpaymentrequest", "status": [ @@ -14885,6 +15008,22 @@ }, "doc": "Note: This property is considered a legacy property. Use
allow=\"fullscreen\"and domxref(\"HTMLIFrameElement.allow\")}} instead.\n
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The featurePolicy read-only\nproperty of the HTMLIFrameElement interface returns the\nFeaturePolicy interface which provides a simple API for introspecting\nthe Permissions Policies applied to a specific frame."
},
+ "htmliframeelement.height": {
+ "url": "$MDN_URL$/web/api/htmliframeelement/height",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "",
+ "Opera": "12.1",
+ "Safari": "3",
+ "SafariIOS": ""
+ },
+ "doc": "The height property of the HTMLIFrameElement interface returns a string that reflects the height attribute of the <iframe> element, indicating the height of the frame in CSS pixels."
+ },
"htmliframeelement.loading": {
"url": "$MDN_URL$/web/api/htmliframeelement/loading",
"status": [
@@ -14901,6 +15040,22 @@
},
"doc": "The loading property of the HTMLIFrameElement interface is a string that provides a hint to the user agent indicating whether the iframe should be loaded immediately on page load, or only when it is needed.\n
This can be used to optimize the loading of the document's contents.\nIframes that are visible when the page loads can be downloaded immediately (eagerly), while iframes that are likely to be offscreen on initial page load can be downloaded lazily — just before they will appear in the window's visual viewport."
},
+ "htmliframeelement.name": {
+ "url": "$MDN_URL$/web/api/htmliframeelement/name",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "",
+ "Opera": "12.1",
+ "Safari": "3",
+ "SafariIOS": ""
+ },
+ "doc": "The name property of the HTMLIFrameElement interface is a string value that reflects the name attribute of the <iframe> element, indicating the specific name of the <iframe> element."
+ },
"htmliframeelement.referrerpolicy": {
"url": "$MDN_URL$/web/api/htmliframeelement/referrerpolicy",
"status": [
@@ -14949,6 +15104,22 @@
},
"doc": "The srcdoc property of the HTMLIFrameElement specifies the content of the page."
},
+ "htmliframeelement.width": {
+ "url": "$MDN_URL$/web/api/htmliframeelement/width",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "",
+ "Opera": "12.1",
+ "Safari": "3",
+ "SafariIOS": ""
+ },
+ "doc": "The width property of the HTMLIFrameElement interface returns a string that reflects the width attribute of the <iframe> element, indicating the width of the frame in CSS pixels."
+ },
"htmlimageelement": {
"url": "$MDN_URL$/web/api/htmlimageelement",
"status": [
@@ -15295,7 +15466,7 @@
"Safari": "9.1",
"SafariIOS": "9.3"
},
- "doc": "The HTMLImageElement property\nsizes allows you to specify the layout width of the\nimage for each of a list of media conditions. This provides the ability to\nautomatically select among different images—even images of different orientations or\naspect ratios—as the document state changes to match different media\nconditions.\n
Each condition is specified using the same conditional format used\nby media queries."
+ "doc": "The HTMLImageElement property\nsizes allows you to specify the layout width of the\nimage for each of a list of media conditions. This provides the ability to\nautomatically select among different images—even images of different orientations or\naspect ratios—as the document state changes to match different media\nconditions.\n
Each condition is specified using the same conditional format used\nby media queries."
},
"htmlimageelement.src": {
"url": "$MDN_URL$/web/api/htmlimageelement/src",
@@ -17291,6 +17462,54 @@
},
"doc": "The HTMLProgressElement.labels read-only property returns\na NodeList of the <label> elements associated with the\n<progress> element."
},
+ "htmlprogresselement.max": {
+ "url": "$MDN_URL$/web/api/htmlprogresselement/max",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "6",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "6",
+ "Opera": "12.1",
+ "Safari": "6",
+ "SafariIOS": "6"
+ },
+ "doc": "The max property of the HTMLProgressElement interface represents the upper bound of the <progress> element's range."
+ },
+ "htmlprogresselement.position": {
+ "url": "$MDN_URL$/web/api/htmlprogresselement/position",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "6",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "6",
+ "Opera": "12.1",
+ "Safari": "6",
+ "SafariIOS": "6"
+ },
+ "doc": "The position read-only property of the HTMLProgressElement interface returns current progress of the <progress> element."
+ },
+ "htmlprogresselement.value": {
+ "url": "$MDN_URL$/web/api/htmlprogresselement/value",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "6",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "6",
+ "Opera": "12.1",
+ "Safari": "6",
+ "SafariIOS": "6"
+ },
+ "doc": "The value property of the HTMLProgressElement interface represents the current progress of the <progress> element."
+ },
"htmlquoteelement": {
"url": "$MDN_URL$/web/api/htmlquoteelement",
"status": [
@@ -17605,7 +17824,8 @@
"Chrome": "121",
"ChromeAndroid": "121",
"Edge": "121",
- "Firefox": "122"
+ "Firefox": "122",
+ "Opera": "107"
},
"doc": "The HTMLSelectElement.showPicker() method displays the browser picker for a select element.\n
This is the same picker that would normally be displayed when the element is selected, but can be triggered from a button press or other user interaction.",
"returns": "None (undefined).",
@@ -18578,6 +18798,25 @@
},
"doc": "Implemented by the <video> element, the HTMLVideoElement interface provides special properties and methods for manipulating video objects. It also inherits properties and methods of HTMLMediaElement and HTMLElement.\n
The list of supported media formats varies from one browser to the other. You should either provide your video in a single format that all the relevant browsers supports, or provide multiple video sources in enough different formats that all the browsers you need to support are covered."
},
+ "htmlvideoelement.cancelvideoframecallback": {
+ "url": "$MDN_URL$/web/api/htmlvideoelement/cancelvideoframecallback",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "83",
+ "ChromeAndroid": "83",
+ "Edge": "83",
+ "Opera": "69",
+ "Safari": "15.4",
+ "SafariIOS": "15.4"
+ },
+ "doc": "The cancelVideoFrameCallback() method of the HTMLVideoElement interface cancels a previously-registered video frame callback.",
+ "parameters": {
+ "id": "A number representing the ID of the video frame callback you want to cancel. This will be the value returned by the corresponding HTMLVideoElement.requestVideoFrameCallback call."
+ },
+ "returns": "None (undefined)."
+ },
"htmlvideoelement.disablepictureinpicture": {
"url": "$MDN_URL$/web/api/htmlvideoelement/disablepictureinpicture",
"status": [
@@ -18610,6 +18849,22 @@
"doc": "The HTMLVideoElement method\ngetVideoPlaybackQuality() creates and returns a\nVideoPlaybackQuality object containing metrics including how many\nframes have been lost.\n
The data returned can be used to evaluate the quality of the video stream.",
"returns": "A VideoPlaybackQuality object providing information about the video\n element's current playback quality."
},
+ "htmlvideoelement.height": {
+ "url": "$MDN_URL$/web/api/htmlvideoelement/height",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "3",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "3.5",
+ "Opera": "10.5",
+ "Safari": "3.1",
+ "SafariIOS": "3"
+ },
+ "doc": "The height property of the HTMLVideoElement interface returns an integer that reflects the height attribute of the <video> element, specifying the displayed height of the resource in CSS pixels."
+ },
"htmlvideoelement.requestpictureinpicture": {
"url": "$MDN_URL$/web/api/htmlvideoelement/requestpictureinpicture",
"status": [
@@ -18632,6 +18887,25 @@
"NotAllowedError DOMException": "Thrown if document.pictureInPictureElement is null and the document does not have transient activation."
}
},
+ "htmlvideoelement.requestvideoframecallback": {
+ "url": "$MDN_URL$/web/api/htmlvideoelement/requestvideoframecallback",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "83",
+ "ChromeAndroid": "83",
+ "Edge": "83",
+ "Opera": "69",
+ "Safari": "15.4",
+ "SafariIOS": "15.4"
+ },
+ "doc": "The requestVideoFrameCallback() method of the HTMLVideoElement interface registers a callback function that runs when a new video frame is sent to the compositor. This enables developers to perform efficient operations on each video frame.",
+ "parameters": {
+ "callback": "The callback function that runs when a new video frame is sent to the compositor. This contains two parameters:
nowA DOMHighResTimeStamp representing the time when the callback was called.
metadataAn object containing the following properties:
expectedDisplayTime: A DOMHighResTimeStamp representing the time when the browser expects the frame to be visible.height: A number, in media pixels, representing the height of the video frame (the visible decoded pixels, without aspect ratio adjustments).mediaTime: A number, in seconds, representing the media presentation timestamp of the presented frame. This is equal to the frame's timestamp on the HTMLMediaElement.currentTime timeline.presentationTime: A DOMHighResTimeStamp representing the time when the browser submitted the frame for composition.presentedFrames: A number representing the number of frames submitted for composition so far alongside the current callback. This can be used to detect whether frames were missed between callback instances.processingDuration: A number, in seconds, representing the duration between the submission of the encoded packet with the same presentation timestamp as this frame to the decoder (i.e., the mediaTime) and the decoded frame being ready for presentation.width: A number, in media pixels, representing the width of the video frame (the visible decoded pixels, without aspect ratio adjustments).Additional metadata properties may be available within requestVideoFrameCallback() callbacks used in WebRTC applications:
captureTime: A DOMHighResTimeStamp representing the time when the frame was captured. This applies to video frames coming from a local or remote source. For a remote source, the capture time is estimated using clock synchronization and RTCP sender reports to convert RTP timestamps to capture time.receiveTime: A DOMHighResTimeStamp representing the time when the encoded frame was received by the platform. This applies to video frames coming from a remote source. Specifically, this corresponds to the time when the last packet belonging to this frame was received over the network.rtpTimestamp: A number representing the RTP timestamp associated with this video frame.This can be passed to HTMLVideoElement.cancelVideoFrameCallback() to cancel the callback registration."
+ },
"htmlvideoelement.videoheight": {
"url": "$MDN_URL$/web/api/htmlvideoelement/videoheight",
"status": [
@@ -18664,6 +18938,22 @@
},
"doc": "The HTMLVideoElement interface's read-only videoWidth property indicates the intrinsic width of the video, expressed in CSS pixels.\nIn simple terms, this is the width of the media in its natural size.\n
See HTMLVideoElement.videoHeight > About intrinsic width and height for more details."
},
+ "htmlvideoelement.width": {
+ "url": "$MDN_URL$/web/api/htmlvideoelement/width",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Chrome": "3",
+ "ChromeAndroid": "",
+ "Edge": "",
+ "Firefox": "3.5",
+ "Opera": "10.5",
+ "Safari": "3.1",
+ "SafariIOS": "3"
+ },
+ "doc": "The width property of the HTMLVideoElement interface returns an integer that that reflects the width attribute of the <video> element, specifying the displayed width of the resource in CSS pixels."
+ },
"idbcursor": {
"url": "$MDN_URL$/web/api/idbcursor",
"status": [
@@ -19812,7 +20102,7 @@
"parameters": {
"indexName": "The name of the index to create. Note that it is possible to create an index with an empty name.",
"keyPath": "The key path for the index to use. Note that it is possible to create an index with an empty keyPath, and also to pass in a sequence (array) as a keyPath.",
- "options": "An object which can include the following properties:
uniqueIf true, the index will not allow duplicate values for a single key. Defaults to false.
multiEntryIf true, the index will add an entry in the index for each array element when the keyPath resolves to an array. If false, it will add one single entry containing the array. Defaults to false.
locale Currently Firefox-only (43+), this allows you to specify a locale for the index. Any sorting operations performed on the data via key ranges will then obey sorting rules of that locale (see locale-aware sorting). You can specify its value in one of three ways:
string: A string containing a specific locale code, e.g. en-US, or pl.auto: The platform default locale will be used (may be changed by user agent settings).null or undefined: If no locale is specified, normal JavaScript sorting will be used — not locale-aware.uniqueIf true, the index will not allow duplicate values for a single key. Defaults to false.
multiEntryIf true, the index will add an entry in the index for each array element when the keyPath resolves to an array. If false, it will add one single entry containing the array. Defaults to false.
locale Allows you to specify a locale for the index. Any sorting operations performed on the data via key ranges will then obey sorting rules of that locale (see locale-aware sorting). You can specify its value in one of three ways:
string: A string containing a specific locale code, e.g. en-US, or pl.auto: The platform default locale will be used (may be changed by user agent settings).null or undefined: If no locale is specified, normal JavaScript sorting will be used — not locale-aware.IDBIndex object: the newly created index.",
"throws": {
diff --git a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-l.json b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-l.json
index 709314b41e39..51a28788a252 100644
--- a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-l.json
+++ b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-l.json
@@ -2307,7 +2307,7 @@
"Safari": "14.1",
"SafariIOS": "14.5"
},
- "doc": "The MediaRecorder.pause() method (part\nof the MediaStream Recording API) is used\nto pause recording of media streams.\nWhen a MediaRecorder object's pause()method is called, the\nbrowser queues a task that runs the below steps:\n
MediaRecorder.state is \"inactive\", raise a DOM\nInvalidState error and terminate these steps. If not, continue to the\nnext step.\nMediaRecorder.state to \"paused\".Blob, but keep it available so\nthat recording can be resumed later on.\npause event.pause() method of the MediaRecorder interface is used\nto pause recording of media streams.\nWhen a MediaRecorder object's pause()method is called, the\nbrowser queues a task that runs the below steps:\n
MediaRecorder.state is \"inactive\", raise a DOM\nInvalidState error and terminate these steps. If not, continue to the\nnext step.\nMediaRecorder.state to \"paused\".Blob, but keep it available so\nthat recording can be resumed later on.\npause event.undefined).",
"throws": {
"InvalidStateError DOMException": "Thrown if the MediaRecorder is currently \"inactive\"; you cannot pause the recording if the MediaRecorder is not active. If you call pause() while already paused, the method silently does nothing."
@@ -2347,8 +2347,11 @@
"Safari": "14.1",
"SafariIOS": "14.5"
},
- "doc": "The MediaRecorder.resume()\nmethod (part of the MediaStream Recording API) is used to resume media recording when it has been previously\npaused.\nWhen the resume() method is invoked, the browser queues a task that runs\nthe following steps:\n
MediaRecorder.state is \"inactive\", raise a DOM\nInvalidState error and terminate these steps. If\nMediaRecorder.state is not \"inactive\", continue to the next step.\nMediaRecorder.state to \"recording\".Blob.resume event.undefined)."
+ "doc": "The resume() method of the MediaRecorder interface is used to resume media recording when it has been previously paused.\nIf MediaRecorder.state is already \"recording\", calling resume() has no effect.\n
When the resume() method is invoked, the browser queues a task that runs\nthe following steps:\n
MediaRecorder.state is \"inactive\", raise a DOM\nInvalidStateError exception and terminate these steps. If\nMediaRecorder.state is not \"inactive\", continue to the next step.\nMediaRecorder.state to \"recording\".Blob.resume event.undefined).",
+ "throws": {
+ "InvalidStateError DOMException": "Thrown if the MediaRecorder is currently \"inactive\"."
+ }
},
"mediarecorder.start": {
"url": "$MDN_URL$/web/api/mediarecorder/start",
@@ -2364,17 +2367,15 @@
"Safari": "14.1",
"SafariIOS": "14"
},
- "doc": "The MediaRecorder method\nstart(), which is part of the MediaStream Recording API,\nbegins recording media into one or more Blob objects.\nYou can\nrecord the entire duration of the media into a single Blob (or until you\ncall requestData()), or you can specify the\nnumber of milliseconds to record at a time. Then, each time that amount of media has\nbeen recorded, an event will be delivered to let you act upon the recorded media, while\na new Blob is created to record the next slice of the media.\n
Assuming the MediaRecorder's state\nis inactive, start() sets the state to\nrecording, then begins capturing media from the input stream. A\nBlob is created and the data is collected in it until the time slice period\nelapses or the source media ends. Each time a Blob is filled up to that\npoint (the timeslice duration or the end-of-media, if no slice duration was provided), a\ndataavailable event is sent to the MediaRecorder with the\nrecorded data. If the source is still playing, a new Blob is created and\nrecording continues into that, and so forth.\n
When the source stream ends, state is set to inactive and\ndata gathering stops. A final dataavailable event is sent to the\nMediaRecorder, followed by a stop event.\n
Note: If the browser is unable to start recording or continue\nrecording, it will raise an error event, followed by a\ndataavailable event containing the Blob it\nhas gathered, followed by the stop event.\n
start() method of the MediaRecorder interface begins recording media into one or more Blob objects.\nYou can\nrecord the entire duration of the media into a single Blob (or until you\ncall requestData()), or you can specify the\nnumber of milliseconds to record at a time. Then, each time that amount of media has\nbeen recorded, an event will be delivered to let you act upon the recorded media, while\na new Blob is created to record the next slice of the media.\n
Assuming the MediaRecorder's state\nis inactive, start() sets the state to\nrecording, then begins capturing media from the input stream. A\nBlob is created and the data is collected in it until the time slice period\nelapses or the source media ends. Each time a Blob is filled up to that\npoint (the timeslice duration or the end-of-media, if no slice duration was provided), a\ndataavailable event is sent to the MediaRecorder with the\nrecorded data. If the source is still playing, a new Blob is created and\nrecording continues into that, and so forth.\n
When the source stream ends, state is set to inactive and\ndata gathering stops. A final dataavailable event is sent to the\nMediaRecorder, followed by a stop event.\n
Note: If the browser is unable to start recording or continue\nrecording, it will raise an error event, followed by a\ndataavailable event containing the Blob it\nhas gathered, followed by the stop event.\n
Blob. If this parameter isn't included, the entire media duration is recorded into a single Blob unless the requestData() method is called to obtain the Blob and trigger the creation of a new Blob into which the media continues to be recorded."
},
"returns": "None (undefined).",
"throws": {
- "InvalidModificationError DOMException": "Thrown if the number of tracks on the stream being recorded has changed. You cannot add or remove tracks while recording media.",
"InvalidStateError DOMException": "Thrown if the MediaRecorder is not in the inactive state; you cannot start recording media if it is already being recorded. See the state property.",
- "NotSupportedError DOMException": "Thrown if the media stream you are attempting to record is inactive, or one or more of the stream's tracks is in a format that cannot be recorded using the current configuration.",
- "SecurityError DOMException": "Thrown if the MediaStream is configured to disallow recording. This may be the case, for example, with sources obtained using getUserMedia() when the user denies permission to use an input device. This exception may also be delivered as an error event if the security options for the source media change after recording begins.",
- "UnknownError DOMException": "Thrown if something else went wrong during the recording process."
+ "NotSupportedError DOMException": "Thrown if: videoKeyFrameIntervalDuration and videoKeyFrameIntervalCount parameter are both specificed when creating the MediaRecorder.MediaStream is configured to disallow recording. This may be the case, for example, with sources obtained using getUserMedia() when the user denies permission to use an input device. This exception may also be delivered as an error event if the security options for the source media change after recording begins."
}
},
"mediarecorder.state": {
@@ -2407,8 +2408,11 @@
"Safari": "14.1",
"SafariIOS": "14"
},
- "doc": "The MediaRecorder.stop() method\n(part of the MediaStream Recording API) is\nused to stop media capture.\nWhen the stop() method is invoked, the UA queues a task that runs the\nfollowing steps:\n
MediaRecorder.state is \"inactive\", raise a DOM\nInvalidState error and terminate these steps. If the\nMediaRecorder.state is not \"inactive\", continue on to the next step.\nMediaRecorder.state to \"inactive\" and stop capturing media.dataavailable event containing the Blob of data that has been\ngathered.\nstop event.undefined)."
+ "doc": "The stop() method of the MediaRecorder interface is\nused to stop media capture.\nWhen the stop() method is invoked, the UA queues a task that runs the\nfollowing steps:\n
MediaRecorder.state is \"inactive\", raise a DOM\nInvalidState error and terminate these steps. If the\nMediaRecorder.state is not \"inactive\", continue on to the next step.\nMediaRecorder.state to \"inactive\" and stop capturing media.dataavailable event containing the Blob of data that has been\ngathered.\nstop event.undefined).",
+ "throws": {
+ "InvalidStateError DOMException": "Thrown if the MediaRecorder is currently \"inactive\"; you cannot stop the recording if the MediaRecorder is not active."
+ }
},
"mediarecorder.stream": {
"url": "$MDN_URL$/web/api/mediarecorder/stream",
@@ -3408,7 +3412,6 @@
"Chrome": "38",
"ChromeAndroid": "38",
"Edge": "",
- "Firefox": "59",
"Opera": "25",
"Safari": "11",
"SafariIOS": "11"
@@ -4590,7 +4593,7 @@
"Nodejs": "15.0.0",
"Deno": "1.12"
},
- "doc": "The MessageChannel() constructor of the MessageChannel\ninterface returns a new MessageChannel object with two new\nMessagePort objects.Note: This feature is available in Web Workers\n
MessageChannel() constructor of the MessageChannel\ninterface returns a new MessageChannel object with two new\nMessagePort objects.Note: This feature is available in Web Workers\n
MessageChannel object."
},
"messagechannel.port1": {
@@ -9505,7 +9508,7 @@
"Safari": "7",
"SafariIOS": "16.4"
},
- "doc": "Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The Notification interface of the Notifications API is used to configure and display desktop notifications to the user.\n
These notifications' appearance and specific functionality vary across platforms but generally they provide a way to asynchronously provide information to the user." + "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The Notification interface of the Notifications API is used to configure and display desktop notifications to the user.\n
These notifications' appearance and specific functionality vary across platforms but generally they provide a way to asynchronously provide information to the user.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The actions read-only property of the Notification interface provides the actions available for users to choose from for interacting with the notification.\n
The actions are set using the actions option of the second argument for the showNotification() method and Notification() constructor.\n
Note: Browsers typically limit the maximum number of actions they will display for a particular notification. Check the static Notification.maxActions property to determine the limit.\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The actions read-only property of the Notification interface provides the actions available for users to choose from for interacting with the notification.\n
The actions are set using the actions option of the second argument for the showNotification() method and Notification() constructor.\n
Note: Browsers typically limit the maximum number of actions they will display for a particular notification. Check the static Notification.maxActions property to determine the limit.\n
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The badge property of the Notification\ninterface returns a string containing the URL of an image to represent the notification when there is not enough space to display the notification itself such as for example, the Android Notification Bar. On Android devices, the badge should accommodate devices up to 4x resolution, about 96 by 96 px, and the image will be automatically masked."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The badge property of the Notification\ninterface returns a string containing the URL of an image to represent the notification when there is not enough space to display the notification itself such as for example, the Android Notification Bar. On Android devices, the badge should accommodate devices up to 4x resolution, about 96 by 96 px, and the image will be automatically masked.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The body read-only property of the\nNotification interface indicates the body string of the notification, as\nspecified in the body option of the\nNotification() constructor."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The body read-only property of the\nNotification interface indicates the body string of the notification, as\nspecified in the body option of the\nNotification() constructor.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The close() method of the Notification interface is used to\nclose/remove a previously displayed notification.\n
Note: This API shouldn't be used just to have the notification\nremoved from the screen after a fixed delay since this method will also remove the\nnotification from any notification tray, preventing users from interacting with it\nafter it was initially shown. A valid use for this API would be to remove a\nnotification that is no longer relevant (e.g. the user already read the notification\non the webpage in the case of a messaging app or the following song is already playing\nin a music app).\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The close() method of the Notification interface is used to\nclose/remove a previously displayed notification.\n
Note: This API shouldn't be used just to have the notification\nremoved from the screen after a fixed delay since this method will also remove the\nnotification from any notification tray, preventing users from interacting with it\nafter it was initially shown. A valid use for this API would be to remove a\nnotification that is no longer relevant (e.g. the user already read the notification\non the webpage in the case of a messaging app or the following song is already playing\nin a music app).\n
Note: This feature is available in Web Workers\n
undefined)."
},
"notification.data": {
@@ -9583,7 +9586,7 @@
"Safari": "16",
"SafariIOS": "16.4"
},
- "doc": "Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The data read-only property of the\nNotification interface returns a structured clone of the notification's\ndata, as specified in the data option of the\nNotification() constructor.\n
The notification's data can be any arbitrary data that you want associated with the\nnotification." + "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The data read-only property of the\nNotification interface returns a structured clone of the notification's\ndata, as specified in the data option of the\nNotification() constructor.\n
The notification's data can be any arbitrary data that you want associated with the\nnotification.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The dir read-only property of the Notification interface indicates the text direction of the notification, as specified in the dir option of the Notification() constructor."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The dir read-only property of the Notification interface indicates the text direction of the notification, as specified in the dir option of the Notification() constructor.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The icon read-only property of the\nNotification interface contains the URL of an icon to be displayed as\npart of the notification, as specified in the icon option of the\nNotification() constructor."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The icon read-only property of the\nNotification interface contains the URL of an icon to be displayed as\npart of the notification, as specified in the icon option of the\nNotification() constructor.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The image read-only property of the\nNotification interface contains the URL of an image to be displayed as\npart of the notification, as specified in the image option of the\nNotification() constructor."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The image read-only property of the\nNotification interface contains the URL of an image to be displayed as\npart of the notification, as specified in the image option of the\nNotification() constructor.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The lang read-only property of the\nNotification interface indicates the language used in the notification,\nas specified in the lang option of the\nNotification() constructor.\n
The language itself is specified using a string representing a language tag according to RFC 5646: Tags for Identifying Languages (also known as BCP 47).\nSee the Sitepoint ISO 2 letter language codes page for a simple reference." + "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The lang read-only property of the\nNotification interface indicates the language used in the notification,\nas specified in the lang option of the\nNotification() constructor.\n
The language itself is specified using a string representing a language tag according to RFC 5646: Tags for Identifying Languages (also known as BCP 47).\nSee the Sitepoint ISO 2 letter language codes page for a simple reference.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The maxActions read-only static property of the\nNotification interface returns the maximum number of actions supported by\nthe device and the User Agent. Effectively, this is the maximum number of elements in\nNotification.actions array which will be respected by the User Agent."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The maxActions read-only static property of the\nNotification interface returns the maximum number of actions supported by\nthe device and the User Agent. Effectively, this is the maximum number of elements in\nNotification.actions array which will be respected by the User Agent.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The Notification() constructor creates a new\nNotification object instance, which represents a user notification.",
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The Notification() constructor creates a new\nNotification object instance, which represents a user notification.
Note: This feature is available in Web Workers\n
dir OptionalThe direction in which to display the notification. It defaults to auto, which just adopts the browser's language setting behavior, but you can override that behavior by setting values of ltr and rtl (although most browsers seem to ignore these settings.)
lang OptionalThe notification's language, as specified using a string representing a language tag according to RFC 5646: Tags for Identifying Languages (also known as BCP 47). See the Sitepoint ISO 2 letter language codes page for a simple reference. The default is the empty string.
badge OptionalA string containing the URL of the image used to represent the notification when there isn't enough space to display the notification itself.
body OptionalA string representing the body text of the notification, which is displayed below the title. The default is the empty string.
tag OptionalA string representing an identifying tag for the notification. The default is the empty string.
icon OptionalA string containing the URL of an icon to be displayed in the notification.
image Optionala string containing the URL of an image to be displayed in the notification.
data OptionalArbitrary data that you want associated with the notification. This can be of any data type. The default is null.
vibrate OptionalA vibration pattern for the device's vibration hardware to emit with the notification. If specified, silent must not be true.
timestamp OptionalA number representing the time at which a notification is created or applicable (past, present, or future).
renotify OptionalA boolean value specifying whether the user should be notified after a new notification replaces an old one. The default is false, which means they won't be notified. If true, then tag also must be set.
requireInteraction OptionalIndicates that a notification should remain active until the user clicks or dismisses it, rather than closing automatically. The default value is false.
actions OptionalAn array of actions to display in the notification, for which the default is an empty array. Each element in the array can be an object with the following members:
actionA string identifying a user action to be displayed on the notification.
titleA string containing action text to be shown to the user.
icon OptionalA string containing the URL of an icon to display with the action.
Appropriate responses are built using event.action within the notificationclick event.
silent OptionalA boolean value specifying whether the notification is silent (no sounds or vibrations issued), regardless of the device settings. The default is null. If true, then vibrate must not be present.
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The permission read-only static property of the Notification\ninterface indicates the current permission granted by the user for the current origin to\ndisplay web notifications."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The permission read-only static property of the Notification\ninterface indicates the current permission granted by the user for the current origin to\ndisplay web notifications.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The renotify read-only property of the\nNotification interface specifies whether the user should be notified\nafter a new notification replaces an old one, as specified in the renotify\noption of the Notification() constructor."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The renotify read-only property of the\nNotification interface specifies whether the user should be notified\nafter a new notification replaces an old one, as specified in the renotify\noption of the Notification() constructor.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The requireInteraction read-only property of the Notification interface returns a boolean value indicating that a notification should remain active until the user clicks or dismisses it, rather than closing automatically.\n
Note: This can be set when the notification is first created by setting the requireInteraction option to true in the options object of the Notification() constructor.\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The requireInteraction read-only property of the Notification interface returns a boolean value indicating that a notification should remain active until the user clicks or dismisses it, rather than closing automatically.\n
Note: This can be set when the notification is first created by setting the requireInteraction option to true in the options object of the Notification() constructor.\n
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The silent read-only property of the\nNotification interface specifies whether the notification should be\nsilent, i.e., no sounds or vibrations should be issued, regardless of the device\nsettings. This is specified in the silent option of the\nNotification() constructor."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The silent read-only property of the\nNotification interface specifies whether the notification should be\nsilent, i.e., no sounds or vibrations should be issued, regardless of the device\nsettings. This is specified in the silent option of the\nNotification() constructor.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The tag read-only property of the\nNotification interface signifies an identifying tag for the notification,\nas specified in the tag option of the\nNotification() constructor.\n
The idea of notification tags is that more than one notification can share the same\ntag, linking them together. One notification can then be programmatically replaced with\nanother to avoid the users' screen being filled up with a huge number of similar\nnotifications." + "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The tag read-only property of the\nNotification interface signifies an identifying tag for the notification,\nas specified in the tag option of the\nNotification() constructor.\n
The idea of notification tags is that more than one notification can share the same\ntag, linking them together. One notification can then be programmatically replaced with\nanother to avoid the users' screen being filled up with a huge number of similar\nnotifications.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The timestamp read-only property of the\nNotification interface returns a number, as\nspecified in the timestamp option of the\nNotification() constructor.\n
The notification's timestamp can represent the time, in milliseconds since 00:00:00 UTC\non 1 January 1970, of the event for which the notification was created, or it can be an\narbitrary timestamp that you want associated with the notification. For example, a\ntimestamp for an upcoming meeting could be set in the future, whereas a timestamp for a\nmissed message could be set in the past." + "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The timestamp read-only property of the\nNotification interface returns a number, as\nspecified in the timestamp option of the\nNotification() constructor.\n
The notification's timestamp can represent the time, in milliseconds since 00:00:00 UTC\non 1 January 1970, of the event for which the notification was created, or it can be an\narbitrary timestamp that you want associated with the notification. For example, a\ntimestamp for an upcoming meeting could be set in the future, whereas a timestamp for a\nmissed message could be set in the past.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The title read-only property of the\nNotification interface indicates the title of the notification, as\nspecified in the title parameter of the\nNotification() constructor."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The title read-only property of the\nNotification interface indicates the title of the notification, as\nspecified in the title parameter of the\nNotification() constructor.
Note: This feature is available in Web Workers\n
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The vibrate read-only property of the Notification\ninterface specifies a vibration pattern\nfor the device's vibration hardware to emit when the notification fires. This is\nspecified in the vibrate option of the\nNotification() constructor."
+ "doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The vibrate read-only property of the Notification\ninterface specifies a vibration pattern\nfor the device's vibration hardware to emit when the notification fires. This is\nspecified in the vibrate option of the\nNotification() constructor.
Note: This feature is available in Web Workers\n
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The PaymentRequest interface's\nshow() method instructs the user agent to begin the\nprocess of showing and handling the user interface for the payment request to the\nuser.\n
Only one payment request can be in the process of being handled at once, across all\ndocuments. Once one PaymentRequest's show() method has been\ncalled, any other call to show() will by rejected with an\nAbortError until the returned promise has been concluded, either by being\nfulfilled with a PaymentResponse indicating the results of the payment\nrequest, or by being rejected with an error.\n
Note: In reality, despite the fact that the specification says this\ncan't be done, some browsers, including Firefox, support multiple active payment\nrequests at a time.\n
If your architecture doesn't necessarily have all of the data ready to go at the moment\nit instantiates the payment interface by calling show(), specify the\ndetailsPromise parameter, providing a Promise that is\nfulfilled once the data is ready. If this is provided, show() will not\nallow the user to interact with the payment interface until the promise is fulfilled, so\nthat data can be updated prior to the user engaging with the payment process.\n
Processing the result and, if necessary, calling PaymentResponse.retry()\nto retry a failed payment can all be done either asynchronously or synchronously,\ndepending on your needs. For the best user experience, asynchronous solutions are\ntypically the best way to go. Most examples on MDN and elsewhere use\nasync/await\nto wait asynchronously while results are validated and so forth.",
"parameters": {
- "detailsPromise": "An optional Promise that you can provide if your architecture requires that the payment request's details need to be updated between instantiating the payment interface and the user beginning to interact with it. The promise should resolve with an object containing the updated information:
displayItems OptionalAn array of objects, each describing one line item for the payment request. These represent the line items on a receipt or invoice, each with the following properties:
amountAn object describing the monetary value of the item. This object includes the following fields:
currencyA string containing a valid 3-letter ISO 4217 currency identifier (ISO 4217) indicating the currency used for the payment value.
valueA string containing a valid decimal value representing the mount of currency constituting the payment amount. This string must only contain an optional leading \"-\" to indicate a negative value, then one or more digits from 0 to 9, and an optional decimal point (\".\", regardless of locale) followed by at least one more digit. No whitespace is permitted.
labelA string specifying a human-readable name or description of the item or service being charged for. This may be displayed to the user by the user agent, depending on the design of the interface.
pendingA Boolean value which is true if the specified amount has not yet been finalized. This can be used to show items such as shipping or tax amounts that depend upon the selection of shipping address, shipping option, or so forth. The user agent may show this information but is not required to do so.
error Optional A string specifying an error message to present to the user*.* When calling updateWith(), including error in the updated data causes the user agent to display the text as a general error message. For address field specific errors, use shippingAddressErrors.
modifiers OptionalAn array of PaymentDetailsModifier objects, each describing a modifier for particular payment method identifiers. For example, you can use one to adjust the total payment amount based on the selected payment method (\"5% cash discount!\").
shippingAddressErrors Optional An AddressErrors object which includes an error message for each property of the shipping address that could not be validated.
shippingOptions OptionalAn array of PaymentShippingOption objects, each describing one available shipping option from which the user may choose.
total OptionalAn object with the same properties as the objects in displayItems providing an updated total for the payment. Make sure this equals the sum of all of the items in displayItems. This is not calculated automatically. You must update this value yourself anytime the total amount due changes. This lets you have flexibility for how to handle things like tax, discounts, and other adjustments to the total price charged.
Promise that you can provide if your architecture requires that the payment request's details need to be updated between instantiating the payment interface and the user beginning to interact with it. The promise should resolve with an object containing the updated information: displayItems OptionalAn array of objects, each describing one line item for the payment request. These represent the line items on a receipt or invoice, each with the following properties:
amountAn object describing the monetary value of the item. This object includes the following fields:
currencyA string containing a valid 3-letter ISO 4217 currency identifier (ISO 4217) indicating the currency used for the payment value.
valueA string containing a valid decimal value representing the mount of currency constituting the payment amount. This string must only contain an optional leading \"-\" to indicate a negative value, then one or more digits from 0 to 9, and an optional decimal point (\".\", regardless of locale) followed by at least one more digit. No whitespace is permitted.
labelA string specifying a human-readable name or description of the item or service being charged for. This may be displayed to the user by the user agent, depending on the design of the interface.
pendingA Boolean value which is true if the specified amount has not yet been finalized. This can be used to show items such as shipping or tax amounts that depend upon the selection of shipping address, shipping option, or so forth. The user agent may show this information but is not required to do so.
error Optional A string specifying an error message to present to the user*.* When calling updateWith(), including error in the updated data causes the user agent to display the text as a general error message. For address-field specific errors, use the shippingAddressErrors field.
modifiers OptionalAn array of objects, each describing a modifier for particular payment method identifiers, each with the following properties:
supportedMethodsA string that represents the payment method identifier. The payment method identifier only applies if the user selects this payment method.
total OptionalAn object that overrides the total property of the detailsPromise parameter if this payment method is selected by the user. The property takes the same input with the total property of the detailsPromise parameter.
additionalDisplayItems OptionalAn Array of objects provide additional display items that are appended to the displayItems property of the detailsPromise parameter if this payment method is selected by the user. This property is commonly used to add a discount or surcharge line item indicating the reason for the different total amount for the selected payment method that the user agent may display. The property takes the same input with the displayItems property of the detailsPromise parameter.
data OptionalA serializable object that provides optional information that might be needed by the supported payment methods.
For example, you can use one to adjust the total payment amount based on the selected payment method (\"5% cash discount!\").
shippingAddressErrors Optional An object which includes an error message for each property of the shipping address that could not be validated.
shippingOptions Optional An array of objects, each describing one available shipping option from which the user may choose.
total OptionalAn object with the same properties as the objects in displayItems providing an updated total for the payment. Make sure this equals the sum of all of the items in displayItems. This is not calculated automatically. You must update this value yourself anytime the total amount due changes. This lets you have flexibility for how to handle things like tax, discounts, and other adjustments to the total price charged.
Promise that eventually resolves with a PaymentResponse.\n The promise is resolved when the user accepts the payment request (such as by clicking a\n \"Pay\" button in the browser's payment sheet).",
"throws": {
@@ -11522,7 +11525,7 @@
"methodName": "The name of the payment method to be used.",
"methodDetails": "An object containing method-specific details that are being updated."
},
- "returns": "A Promise that resolves with a PaymentRequestDetailsUpdate object. This object contains the following properties:\nerrorA string that explains why the user-selected payment method cannot be used.\n
totalAn updated total based on the changed payment method. The total can change, for example, because the billing address of the payment method selected by the user changes the applicable sales tax.\n
modifiersAn array of PaymentDetailsModifier objects.\n
paymentMethodErrorsAn object containing validation errors for the payment method, if any.\n
Promise that resolves with a PaymentRequestDetailsUpdate object. This object contains the following properties:\nerrorA string that explains why the user-selected payment method cannot be used.\n
totalAn updated total based on the changed payment method. The total can change, for example, because the billing address of the payment method selected by the user changes the applicable sales tax.\n
modifiersAn Array of PaymentDetailsModifier objects, whose properties are described in PaymentRequestEvent.modifiers.\n
paymentMethodErrorsAn object containing validation errors for the payment method, if any.\n
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The modifiers read-only property of the\nPaymentRequestEvent interface returns an array of PaymentDetailsModifier objects containing modifiers for payment details."
+ "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The modifiers read-only property of the\nPaymentRequestEvent interface returns an Array of PaymentDetailsModifier objects containing modifiers for payment details."
},
"paymentrequestevent.openwindow": {
"url": "$MDN_URL$/web/api/paymentrequestevent/openwindow",
@@ -11700,7 +11703,7 @@
"SafariIOS": "11.3"
},
"doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The PaymentRequestUpdateEvent() constructor creates a new\nPaymentRequestUpdateEvent object which enables a web page to update the\ndetails of a PaymentRequest in response to a user action. Actual updates\nare made by passing options to the\nupdateWith() method.",
- "returns": "A new PaymentRequestUpdateEvent"
+ "returns": "A new PaymentRequestUpdateEvent."
},
"paymentrequestupdateevent.updatewith": {
"url": "$MDN_URL$/web/api/paymentrequestupdateevent/updatewith",
@@ -11717,7 +11720,7 @@
},
"doc": "
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The updateWith() method of the\nPaymentRequestUpdateEvent interface updates the details of an existing\nPaymentRequest.",
"parameters": {
- "details": "An object specifying the changes applied to the payment request:
displayItems OptionalAn array of objects, each describing one line item for the payment request. These represent the line items on a receipt or invoice, each with the following properties:
amountAn object describing the monetary value of the item. This object includes the following fields:
currencyA string containing a valid 3-letter ISO 4217 currency identifier (ISO 4217) indicating the currency used for the payment value.
valueA string containing a valid decimal value representing the mount of currency constituting the payment amount. This string must only contain an optional leading \"-\" to indicate a negative value, then one or more digits from 0 to 9, and an optional decimal point (\".\", regardless of locale) followed by at least one more digit. No whitespace is permitted.
labelA string specifying a human-readable name or description of the item or service being charged for. This may be displayed to the user by the user agent, depending on the design of the interface.
pendingA Boolean value which is true if the specified amount has not yet been finalized. This can be used to show items such as shipping or tax amounts that depend upon the selection of shipping address, shipping option, or so forth. The user agent may show this information but is not required to do so.
error Optional A string specifying an error message to present to the user*.* When calling updateWith(), including error in the updated data causes the user agent to display the text as a general error message. For address field specific errors, use shippingAddressErrors.
modifiers OptionalAn array of PaymentDetailsModifier objects, each describing a modifier for particular payment method identifiers. For example, you can use one to adjust the total payment amount based on the selected payment method (\"5% cash discount!\").
shippingAddressErrors Optional An AddressErrors object which includes an error message for each property of the shipping address that could not be validated.
shippingOptions OptionalAn array of PaymentShippingOption objects, each describing one available shipping option from which the user may choose.
total OptionalAn object with the same properties as the objects in displayItems providing an updated total for the payment. Make sure this equals the sum of all of the items in displayItems. This is not calculated automatically. You must update this value yourself anytime the total amount due changes. This lets you have flexibility for how to handle things like tax, discounts, and other adjustments to the total price charged.
displayItems OptionalAn array of objects, each describing one line item for the payment request. These represent the line items on a receipt or invoice, each with the following properties:
amountAn object describing the monetary value of the item. This object includes the following fields:
currencyA string containing a valid 3-letter ISO 4217 currency identifier (ISO 4217) indicating the currency used for the payment value.
valueA string containing a valid decimal value representing the mount of currency constituting the payment amount. This string must only contain an optional leading \"-\" to indicate a negative value, then one or more digits from 0 to 9, and an optional decimal point (\".\", regardless of locale) followed by at least one more digit. No whitespace is permitted.
labelA string specifying a human-readable name or description of the item or service being charged for. This may be displayed to the user by the user agent, depending on the design of the interface.
pendingA Boolean value which is true if the specified amount has not yet been finalized. This can be used to show items such as shipping or tax amounts that depend upon the selection of shipping address, shipping option, or so forth. The user agent may show this information but is not required to do so.
error Optional A string specifying an error message to present to the user*.* When calling updateWith(), including error in the updated data causes the user agent to display the text as a general error message. For address field-specific errors, use the shippingAddressErrors field.
modifiers OptionalAn Array of PaymentDetailsModifier objects, whose properties are described in PaymentRequestEvent.modifiers.
For example, you can use one to adjust the total payment amount based on the selected payment method (\"5% cash discount!\").
shippingAddressErrors Optional An object which includes an error message for each property of the shipping address that could not be validated.
shippingOptions Optional An array of objects, each describing one available shipping option from which the user may choose.
total OptionalAn object with the same properties as the objects in displayItems providing an updated total for the payment. Make sure this equals the sum of all of the items in displayItems. This is not calculated automatically. You must update this value yourself anytime the total amount due changes. This lets you have flexibility for how to handle things like tax, discounts, and other adjustments to the total price charged.
undefined)."
},
@@ -14128,7 +14131,7 @@
"Edge": "80",
"Opera": "67"
},
- "doc": "Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The PeriodicSyncEvent interface of the Web Periodic Background Synchronization API provides a way to run tasks in the service worker with network connectivity.\n
An instance of this event is passed to the periodicsync handler. This happens periodically, at an interval greater than or equal to that set in the PeriodicSyncManager.register() method. Other implementation-specific factors such as the user's engagement with the site decide the actual interval."
+ "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The PeriodicSyncEvent interface of the Web Periodic Background Synchronization API provides a way to run tasks in the service worker with network connectivity.\n
An instance of this event is passed to the periodicsync handler. This happens periodically, at an interval greater than or equal to that set in the PeriodicSyncManager.register() method. Other implementation-specific factors such as the user's engagement with the site decide the actual interval."
},
"periodicsyncevent.periodicsyncevent": {
"url": "$MDN_URL$/web/api/periodicsyncevent/periodicsyncevent",
@@ -14175,7 +14178,7 @@
"Edge": "80",
"Opera": "67"
},
- "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The PeriodicSyncManager interface of the Web Periodic Background Synchronization API provides a way to register tasks to be run in a service worker at periodic intervals with network connectivity. These tasks are referred to as periodic background sync requests. Access PeriodicSyncManager through the ServiceWorkerRegistration.periodicSync."
+ "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The PeriodicSyncManager interface of the Web Periodic Background Synchronization API provides a way to register tasks to be run in a service worker at periodic intervals with network connectivity. These tasks are referred to as periodic background sync requests. Access PeriodicSyncManager through the ServiceWorkerRegistration.periodicSync."
},
"periodicsyncmanager.gettags": {
"url": "$MDN_URL$/web/api/periodicsyncmanager/gettags",
@@ -14206,10 +14209,10 @@
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The register() method of the\nPeriodicSyncManager interface registers a periodic sync request with the\nbrowser with the specified tag and options. It returns a Promise that\nresolves when the registration completes.",
"parameters": {
- "tag": "A unique String identifier",
+ "tag": "A unique String identifier.",
"options": "An Object containing the following optional data:
minIntervalThe minimum interval time, in milliseconds, at which the periodic sync should occur.
Promise that resolves with undefined",
+ "returns": "Returns a Promise that resolves with undefined.",
"throws": {
"InvalidStateError DOMException": "Returned if there is no active ServiceWorker present.",
"NotAllowedError DOMException": "Returned if permission for background periodic sync is not granted.",
@@ -14232,7 +14235,7 @@
"parameters": {
"tag": "The unique String descriptor for the specific background sync."
},
- "returns": "A resolved Promise."
+ "returns": "Returns a Promise that resolves with undefined."
},
"periodicwave": {
"url": "$MDN_URL$/web/api/periodicwave",
diff --git a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-r.json b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-r.json
index 8d798f953550..b7ef1d479b16 100644
--- a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-r.json
+++ b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-r.json
@@ -3902,7 +3902,7 @@
},
"rtcicecandidatepairstats.priority": {
"url": "$MDN_URL$/web/api/rtcicecandidatepairstats/priority",
- "doc": "Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
The obsolete RTCIceCandidatePairStats\nproperty priority reports the priority of the candidate\npair as an integer value. The higher the value, the more likely the WebRTC\nlayer is to select the candidate pair when the time comes to establish (or re-establish)\na connection between the two peers."
+ "doc": "
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The obsolete RTCIceCandidatePairStats\nproperty priority reports the priority of the candidate\npair as an integer value. The higher the value, the more likely the WebRTC\nlayer is to select the candidate pair when the time comes to establish (or re-establish)\na connection between the two peers."
},
"rtcicecandidatepairstats.readable": {
"url": "$MDN_URL$/web/api/rtcicecandidatepairstats/readable",
@@ -8082,7 +8082,7 @@
"doc": "The clients read-only property of the\nServiceWorkerGlobalScope interface returns the Clients\nobject associated with the service worker."
},
"serviceworkerglobalscope.cookiestore": {
- "url": "$MDN_URL$/web/api/serviceworkerglobalscope/cookieStore",
+ "url": "$MDN_URL$/web/api/serviceworkerglobalscope/cookiestore",
"status": [
"Experimental",
"StandardTrack"
@@ -8351,7 +8351,7 @@
"Edge": "79",
"Opera": "36"
},
- "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The sync property of the\nServiceWorkerRegistration interface returns a reference to the\nSyncManager interface, which manages background synchronization\nprocesses.
Note: This feature is available in Web Workers\n
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The sync read-only property of the\nServiceWorkerRegistration interface returns a reference to the\nSyncManager interface, which manages background synchronization\nprocesses.
Note: This feature is available in Web Workers\n
adoptedStyleSheets property of the ShadowRoot interface sets an array of constructed stylesheets to be used by the shadow DOM subtree.\nNote: A constructed stylesheet is a stylesheet created programmatically using the CSSStyleSheet() constructor (as compared to one created by a user-agent when importing a stylesheet from a script, imported using <style> and @import, or linked to via <link>).\n
The same constructed stylesheet can be adopted by multiple ShadowRoot instances, and by the parent document (using the Document.adoptedStyleSheets property).\nChanging an adopted stylesheet will affect all the adopting objects.\n
Stylesheets in the adoptedStyleSheets property are considered along with the shadow DOM's other stylesheets.\nFor the purpose of determining the final computed CSS of any element, they are considered to have been added after the other stylesheets in the shadow DOM (ShadowRoot.styleSheets).\n
Only stylesheets created using the CSSStyleSheet() constructor, and from within the same parent Document as the shadow root, may be adopted."
},
+ "shadowroot.clonable": {
+ "url": "$MDN_URL$/web/api/shadowroot/clonable",
+ "status": [
+ "StandardTrack"
+ ],
+ "compatibility": {
+ "Firefox": "preview"
+ },
+ "doc": "The clonable read-only property of the ShadowRoot interface returns true if the shadow root is clonable, and false otherwise. It always returns true for shadow roots created via declarative shadow DOM. It can be set to true using the clonable option of the Element.attachShadow() method."
+ },
"shadowroot.delegatesfocus": {
"url": "$MDN_URL$/web/api/shadowroot/delegatesfocus",
"status": [
@@ -14492,7 +14502,7 @@
"Edge": "79",
"Opera": "36"
},
- "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The SyncEvent interface represents a sync action that is dispatched on the ServiceWorkerGlobalScope of a ServiceWorker.\n
This interface inherits from the ExtendableEvent interface."
+ "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The SyncEvent interface of the Background Synchronization API represents a sync action that is dispatched on the ServiceWorkerGlobalScope of a ServiceWorker.\n
This interface inherits from the ExtendableEvent interface."
},
"syncevent.lastchance": {
"url": "$MDN_URL$/web/api/syncevent/lastchance",
@@ -14506,7 +14516,7 @@
"Edge": "79",
"Opera": "36"
},
- "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The SyncEvent.lastChance read-only property of the\nSyncEvent interface returns true if the user agent will not\nmake further synchronization attempts after the current attempt. This is the value\npassed in the lastChance parameter of the\nSyncEvent() constructor."
+ "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The lastChance read-only property of the\nSyncEvent interface returns true if the user agent will not\nmake further synchronization attempts after the current attempt. This is the value\npassed in the lastChance parameter of the\nSyncEvent() constructor."
},
"syncevent.syncevent": {
"url": "$MDN_URL$/web/api/syncevent/syncevent",
@@ -14539,7 +14549,7 @@
"Edge": "79",
"Opera": "36"
},
- "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The SyncEvent.tag read-only property of the\nSyncEvent interface returns the developer-defined identifier for\nthis SyncEvent. This is the value passed in the tag parameter\nof the SyncEvent() constructor."
+ "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The tag read-only property of the\nSyncEvent interface returns the developer-defined identifier for\nthis SyncEvent. This is the value passed in the tag parameter\nof the SyncEvent() constructor."
},
"syncmanager": {
"url": "$MDN_URL$/web/api/syncmanager",
@@ -14553,7 +14563,7 @@
"Edge": "79",
"Opera": "36"
},
- "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The SyncManager interface of the ServiceWorker API provides an interface for registering and listing sync registrations."
+ "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The SyncManager interface of the Background Synchronization API provides an interface for registering and listing sync registrations."
},
"syncmanager.gettags": {
"url": "$MDN_URL$/web/api/syncmanager/gettags",
@@ -14567,7 +14577,7 @@
"Edge": "79",
"Opera": "36"
},
- "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The SyncManager.getTags method of the\nSyncManager interface returns a list of developer-defined identifiers for\nSyncManager registrations.",
+ "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The getTags() method of the\nSyncManager interface returns a list of developer-defined identifiers for\nSyncManager registrations.",
"returns": "A Promise that resolves to an array of strings\n containing developer-defined identifiers for SyncManager registrations."
},
"syncmanager.register": {
@@ -14582,11 +14592,15 @@
"Edge": "79",
"Opera": "36"
},
- "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The SyncManager.register method of the SyncManager interface registers a synchronization event, triggering a sync event inside the associated service worker as soon as network connectivity is available.",
+ "doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The register() method of the SyncManager interface registers a synchronization event, triggering a sync event inside the associated service worker as soon as network connectivity is available.",
"parameters": {
"tag": "An identifier for this synchronization event. This will be the value of the tag property of the SyncEvent that gets passed into the service worker's sync event handler."
},
- "returns": "A Promise that resolves to undefined."
+ "returns": "A Promise that resolves to undefined.",
+ "throws": {
+ "InvalidStateError DOMException": "Thrown if current service worker is not active.",
+ "NotAllowedError DOMException": "Thrown if background sync has been disabled by the user."
+ }
},
"taskattributiontiming": {
"url": "$MDN_URL$/web/api/taskattributiontiming",
@@ -15352,7 +15366,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextFormat interface represents specific formatting that should be applied to a range of text in an editable text region that's attached to an EditContext instance. The text formatting is requested by the Input Method Editor (IME) window that the user is composing text with.\n
When using one of the default editable regions of the web, such as a <textarea> element, IME composition is handled by the browser and operating system for you. For example, when using Japanese IME in a textarea, on Windows, the following text formats can be applied:\n
When creating your own custom editable region by using the EditContext API, you need to handle IME composition yourself. You should listen for the textformatupdate event, which gives you the list of text formats that the IME window wants to apply to the text being composed. You should then update the formatting of the text displayed in your editable region accordingly."
},
@@ -15364,7 +15379,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The rangeEnd property of the TextFormat interface indicates the end position of the text range that needs to be formatted with the given text format."
},
@@ -15376,7 +15392,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The rangeStart property of the TextFormat interface indicates the start position of the text range that needs to be formatted with the given text format."
},
@@ -15388,7 +15405,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextFormat() constructor returns a new TextFormat object.",
"parameters": {
@@ -15403,7 +15421,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The underlineStyle property of the TextFormat interface indicates the style of the underline that needs to be applied to the text range that is being formatted."
},
@@ -15415,7 +15434,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The underlineThickness property of the TextFormat interface indicates the thickness of the underline that needs to be applied to the text range that is being formatted."
},
@@ -15427,7 +15447,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextFormatUpdateEvent interface is a DOM event that represents a list of text formats that an Input Method Editor (IME) window wants to apply to the text being composed in an editable region that's attached to an EditContext instance.\n
This interface inherits properties from Event."
},
@@ -15439,7 +15460,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The getTextFormats() method of the TextFormatUpdateEvent interface returns an Array of TextFormat objects that represent the formats that an Input Method Editor (IME) window wants to apply to the text being composed.",
"returns": "An Array containing TextFormat objects."
@@ -15452,7 +15474,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextFormatUpdateEvent() constructor returns a new TextFormatUpdateEvent object.",
"parameters": {
@@ -16058,7 +16081,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextUpdateEvent interface is a DOM event that represents a text or selection update in an editable text region that's attached to an EditContext instance.\n
This interface inherits properties from Event."
},
@@ -16070,7 +16094,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextUpdateEvent.selectionEnd read-only property indicates the position of the end of the selection (or caret) within the text content of the editable region attached to the EditContext object."
},
@@ -16082,7 +16107,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextUpdateEvent.selectionStart read-only property indicates the position of the end of the selection (or caret) within the text content of the editable region attached to the EditContext object."
},
@@ -16094,7 +16120,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextUpdateEvent.text read-only property contains the text that was inserted within the updated range of a EditContext's textupdate event."
},
@@ -16106,7 +16133,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextUpdateEvent() constructor returns a new TextUpdateEvent object.",
"parameters": {
@@ -16122,7 +16150,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextUpdateEvent.updateRangeEnd read-only property indicates the end position of the text range that is being replaced in the EditContext object."
},
@@ -16134,7 +16163,8 @@
],
"compatibility": {
"Chrome": "121",
- "Edge": "121"
+ "Edge": "121",
+ "Opera": "107"
},
"doc": "
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The TextUpdateEvent.updateRangeStart read-only property indicates the start position of the text range that is being replaced in the EditContext object."
},
diff --git a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-u.json b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-u.json
index aa62d1760111..ced860220998 100644
--- a/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-u.json
+++ b/xml/xml-psi-impl/gen/com/intellij/documentation/mdn/WebApi-u.json
@@ -11899,7 +11899,7 @@
"doc": "The Window.console property returns a reference to the console object, which provides methods for logging information to the browser's console. These methods are intended for debugging purposes only and should not be relied on for presenting information to end users."
},
"window.cookiestore": {
- "url": "$MDN_URL$/web/api/window/cookieStore",
+ "url": "$MDN_URL$/web/api/window/cookiestore",
"status": [
"Experimental",
"StandardTrack"
diff --git a/xml/xml-psi-impl/mdn-doc-gen/src/GenerateMdnDocumentation.kt b/xml/xml-psi-impl/mdn-doc-gen/src/GenerateMdnDocumentation.kt
index b7e72bcb4725..4c5b0208876a 100644
--- a/xml/xml-psi-impl/mdn-doc-gen/src/GenerateMdnDocumentation.kt
+++ b/xml/xml-psi-impl/mdn-doc-gen/src/GenerateMdnDocumentation.kt
@@ -1275,7 +1275,7 @@ private fun String.patchProse(): String =
.replace(""", "\"")
.replace(" ", " ")
.replace(Regex("
\\s+"), "
") - .replace(Regex("(^
\\s*)|(\\s*
)|(\\s*\\s*)|(\\s*
)|(\\s*block\n."
}
}
+ },
+ "button": {
+ "doc": "",
+ "attrs":{
+ "autocomplete": {
+ "url": "$MDN_URL$/web/html/element/button#autocomplete",
+ "compatibility": {
+ "Firefox": "4"
+ },
+ "doc": "This attribute on a <button> is nonstandard and Firefox-specific. Unlike other browsers, Firefox persists the dynamic disabled state of a <button> across page loads. Setting autocomplete=\"off\" on the button disables this feature; see Firefox bug 654072."
+ }
+ }
}
}
}
\ No newline at end of file