CSS
This domain exposes CSS read/write operations. All CSS objects (stylesheets, rules, and styles) have an associated id
used in subsequent operations on the related object. Each object type has a specific id
structure, and those are not interchangeable between objects of different kinds. CSS objects can be loaded using the get*ForNode()
calls (which accept a DOM node id). A client can also keep track of stylesheets via the styleSheetAdded
/styleSheetRemoved
events and subsequently load the required stylesheet contents using the getStyleSheet[Text]()
methods.
Enables the CSS agent for the given page. Clients should not assume that the CSS agent has been enabled until the result of this command is received.
Disables the CSS agent for the given page.
Returns the styles defined inline (explicitly in the "style" attribute and implicitly, using DOM
attributes) for a DOM node identified by nodeId
.
Parameters | ||
---|---|---|
nodeId | DOM.NodeId |
Returns | ||
---|---|---|
inlineStyle optional |
CSSStyle |
Inline style for the specified DOM node. |
attributesStyle optional |
CSSStyle |
Attribute-defined element style (e.g. resulting from "width=20 height=100%"). |
Returns requested styles for a DOM node identified by nodeId
.
Parameters | ||
---|---|---|
nodeId | DOM.NodeId |
Returns | ||
---|---|---|
inlineStyle optional |
CSSStyle |
Inline style for the specified DOM node. |
attributesStyle optional |
CSSStyle |
Attribute-defined element style (e.g. resulting from "width=20 height=100%"). |
matchedCSSRules optional |
RuleMatch[] |
CSS rules matching this node, from all applicable stylesheets. |
pseudoElements optional |
PseudoElementMatches[] |
Pseudo style matches for this node. |
inherited optional |
InheritedStyleEntry[] |
A chain of inherited styles (from the immediate node parent up to the DOM tree root). |
cssKeyframesRules optional |
CSSKeyframesRule[] |
A list of CSS keyframed animations matching this node. |
Requests information about platform fonts which we used to render child TextNodes in the given node.
Parameters | ||
---|---|---|
nodeId | DOM.NodeId |
Returns | ||
---|---|---|
fonts | PlatformFontUsage[] |
Usage statistics for every employed platform font. |
Returns the computed style for a DOM node identified by nodeId
.
Parameters | ||
---|---|---|
nodeId | DOM.NodeId |
Returns | ||
---|---|---|
computedStyle | CSSComputedStyleProperty[] |
Computed style for the specified DOM node. |
Fired whenever an active document stylesheet is added.
Parameters | ||
---|---|---|
header | CSSStyleSheetHeader |
Added stylesheet metainfo. |
Fired whenever a stylesheet is changed as a result of the client operation.
Parameters | ||
---|---|---|
styleSheetId | StyleSheetId |
Fired whenever an active document stylesheet is removed.
Parameters | ||
---|---|---|
styleSheetId | StyleSheetId |
Identifier of the removed stylesheet. |
CSS rule collection for a single pseudo style.
Properties | ||
---|---|---|
pseudoType | DOM.PseudoType |
Pseudo element type. |
matches | RuleMatch[] |
Matches of CSS rules applicable to the pseudo style. |
Inherited CSS rule collection from ancestor node.
Properties | ||
---|---|---|
inlineStyle optional |
CSSStyle |
The ancestor node's inline style, if any, in the style inheritance chain. |
matchedCSSRules | RuleMatch[] |
Matches of CSS rules matching the ancestor node in the style inheritance chain. |
Match data for a CSS rule.
Properties | ||
---|---|---|
rule | CSSRule |
CSS rule in the match. |
Data for a simple selector (these are delimited by commas in a selector list).
Properties | ||
---|---|---|
text | string |
Value text. |
range optional |
SourceRange |
Value range in the underlying resource (if available). |
Selector list data.
Properties | ||
---|---|---|
selectors | Value[] |
Selectors in the list. |
text | string |
Rule selector text. |
CSS rule representation.
Properties | ||
---|---|---|
styleSheetId optional |
StyleSheetId |
The css style sheet identifier (absent for user agent stylesheet and user-specified stylesheet rules) this rule came from. |
selectorList optional |
SelectorList |
Rule selector data. |
origin optional |
<StyleSheetOrigin |
Parent stylesheet's origin. |
style | CSSStyle |
Associated style declaration. |
media optional |
CSSMedia[] |
Media list array (for rules involving media queries). The array enumerates media queries starting with the innermost one, going outwards. |
Text range within a resource. All numbers are zero-based.
Properties | ||
---|---|---|
startLine | integer |
Start line of range. |
startColumn | integer |
Start column of range (inclusive). |
endLine | integer |
End line of range |
endColumn | integer |
End column of range (exclusive). |
Properties | ||
---|---|---|
name | string |
Shorthand name. |
value | string |
Shorthand value. |
important optional |
boolean |
Whether the property has "!important" annotation (implies `false` if absent). |
CSS style representation.
Properties | ||
---|---|---|
styleSheetId optional |
StyleSheetId |
The css style sheet identifier (absent for user agent stylesheet and user-specified stylesheet rules) this rule came from. |
cssProperties | CSSProperty[] |
CSS properties in the style. |
shorthandEntries | ShorthandEntry[] |
Computed values for all shorthands found in the style. |
cssText optional |
string |
Style declaration text (if available). |
range optional |
SourceRange |
Style declaration range in the enclosing stylesheet (if available). |
CSS property declaration data.
Properties | ||
---|---|---|
name | string |
The property name. |
value | string |
The property value. |
important optional |
boolean |
Whether the property has "!important" annotation (implies `false` if absent). |
implicit optional |
boolean |
Whether the property is implicit (implies `false` if absent). |
text optional |
string |
The full property text as specified in the style. |
parsedOk optional |
boolean |
Whether the property is understood by the browser (implies `true` if absent). |
disabled optional |
boolean |
Whether the property is disabled by the user (present for source-based properties only). |
range optional |
SourceRange |
The entire property range in the enclosing style declaration (if available). |
CSS media rule descriptor.
Properties | ||
---|---|---|
text | string |
Media query text. |
source | string Allowed values: mediaRule, importRule, linkedSheet, inlineSheet |
Source of the media query: "mediaRule" if specified by a @media rule, "importRule" if specified by an @import rule, "linkedSheet" if specified by a "media" attribute in a linked stylesheet's LINK tag, "inlineSheet" if specified by a "media" attribute in an inline stylesheet's STYLE tag. |
sourceURL optional |
string |
URL of the document containing the media query description. |
range optional |
SourceRange |
The associated rule (@media or @import) header range in the enclosing stylesheet (if available). |
styleSheetId optional |
StyleSheetId |
Identifier of the stylesheet containing this object (if exists). |
mediaList optional |
MediaQuery[] |
Array of media queries. |
Media query descriptor.
Properties | ||
---|---|---|
expressions | MediaQueryExpression[] |
Array of media query expressions. |
active | boolean |
Whether the media query condition is satisfied. |
Media query expression descriptor.
Properties | ||
---|---|---|
value | number |
Media query expression value. |
unit | string |
Media query expression units. |
feature | string |
Media query expression feature. |
valueRange optional |
SourceRange |
The associated range of the value text in the enclosing stylesheet (if available). |
computedLength optional |
number |
Computed length of media query expression (if applicable). |
Information about amount of glyphs that were rendered with given font.
Properties | ||
---|---|---|
familyName | string |
Font's family name reported by platform. |
isCustomFont | boolean |
Indicates if the font was downloaded or resolved locally. |
glyphCount | number |
Amount of glyphs that were rendered with this font. |
CSS keyframes rule representation.
Properties | ||
---|---|---|
animationName | Value |
Animation name. |
keyframes | CSSKeyframeRule[] |
List of keyframes. |
CSS keyframe rule representation.
Properties | ||
---|---|---|
styleSheetId optional |
StyleSheetId |
The css style sheet identifier (absent for user agent stylesheet and user-specified stylesheet rules) this rule came from. |
origin | StyleSheetOrigin |
Parent stylesheet's origin. |
keyText | Value |
Associated key text. |
style | CSSStyle |
Associated style declaration. |
Properties | ||
---|---|---|
name | string |
Computed style property name. |
value | string |
Computed style property value. |
CSS stylesheet metainformation.
Properties | ||
---|---|---|
styleSheetId | StyleSheetId |
The stylesheet identifier. |
sourceURL | string |
Stylesheet resource URL. |
disabled | boolean |
Denotes whether the stylesheet is disabled. |
isInline | boolean |
Whether this stylesheet is created for STYLE tag by parser. This flag is not set for document.written STYLE tags. |
startLine | number |
Line offset of the stylesheet within the resource (zero based). |
startColumn | number |
Column offset of the stylesheet within the resource (zero based). |
length | number |
Size of the content (in characters). |