CSS Custom Highlight API
The values() method of the Highlight interface returns a new Iterator object that contains the values for each AbstractRange object in the Highlight object in insertion order.
[!NOTE] The
keys()method is an alias for this method. It behaves exactly the same and returns values ofHighlightelements.
Highlight is a Set-like object, so this is similar to using Set.values().
Syntax
values()
Parameters
None.
Return value
A new iterator object containing each AbstractRange object in the given Highlight, in insertion order.
Examples
The following code snippet shows how to create a new Highlight object with three AbstractRange objects, and use the iterator returned by the values() method to log the three ranges:
const myHighlight = new Highlight();
myHighlight.add(new Range());
myHighlight.add(new Range());
myHighlight.add(new Range());
const iter = myHighlight.values();
for (value of iter) {
console.log(value); // Range
}
Specifications
Browser compatibility
See also
- css_custom_highlight_api
- CSS Custom Highlight API: The Future of Highlighting Text Ranges on the Web
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
