Index: mojo/public/dart/third_party/html/lib/dom.dart |
diff --git a/mojo/public/dart/third_party/html/lib/dom.dart b/mojo/public/dart/third_party/html/lib/dom.dart |
new file mode 100644 |
index 0000000000000000000000000000000000000000..9e647595788d84da842c7c44b0c645d7af679472 |
--- /dev/null |
+++ b/mojo/public/dart/third_party/html/lib/dom.dart |
@@ -0,0 +1,1004 @@ |
+/// A simple tree API that results from parsing html. Intended to be compatible |
+/// with dart:html, but it is missing many types and APIs. |
+library dom; |
+ |
+// TODO(jmesserly): lots to do here. Originally I wanted to generate this using |
+// our Blink IDL generator, but another idea is to directly use the excellent |
+// http://dom.spec.whatwg.org/ and http://html.spec.whatwg.org/ and just |
+// implement that. |
+ |
+import 'dart:collection'; |
+import 'package:source_span/source_span.dart'; |
+ |
+import 'src/constants.dart'; |
+import 'src/css_class_set.dart'; |
+import 'src/list_proxy.dart'; |
+import 'src/query_selector.dart' as query; |
+import 'src/token.dart'; |
+import 'src/tokenizer.dart'; |
+import 'dom_parsing.dart'; |
+import 'parser.dart'; |
+ |
+export 'src/css_class_set.dart' show CssClassSet; |
+ |
+// TODO(jmesserly): this needs to be replaced by an AttributeMap for attributes |
+// that exposes namespace info. |
+class AttributeName implements Comparable { |
+ /// The namespace prefix, e.g. `xlink`. |
+ final String prefix; |
+ |
+ /// The attribute name, e.g. `title`. |
+ final String name; |
+ |
+ /// The namespace url, e.g. `http://www.w3.org/1999/xlink` |
+ final String namespace; |
+ |
+ const AttributeName(this.prefix, this.name, this.namespace); |
+ |
+ String toString() { |
+ // Implement: |
+ // http://www.whatwg.org/specs/web-apps/current-work/multipage/the-end.html#serializing-html-fragments |
+ // If we get here we know we are xml, xmlns, or xlink, because of |
+ // [HtmlParser.adjustForeignAttriubtes] is the only place we create |
+ // an AttributeName. |
+ return prefix != null ? '$prefix:$name' : name; |
+ } |
+ |
+ int get hashCode { |
+ int h = prefix.hashCode; |
+ h = 37 * (h & 0x1FFFFF) + name.hashCode; |
+ h = 37 * (h & 0x1FFFFF) + namespace.hashCode; |
+ return h & 0x3FFFFFFF; |
+ } |
+ |
+ int compareTo(other) { |
+ // Not sure about this sort order |
+ if (other is! AttributeName) return 1; |
+ int cmp = (prefix != null ? prefix : "") |
+ .compareTo((other.prefix != null ? other.prefix : "")); |
+ if (cmp != 0) return cmp; |
+ cmp = name.compareTo(other.name); |
+ if (cmp != 0) return cmp; |
+ return namespace.compareTo(other.namespace); |
+ } |
+ |
+ bool operator ==(x) { |
+ if (x is! AttributeName) return false; |
+ return prefix == x.prefix && name == x.name && namespace == x.namespace; |
+ } |
+} |
+ |
+// http://dom.spec.whatwg.org/#parentnode |
+abstract class _ParentNode implements Node { |
+ // TODO(jmesserly): this is only a partial implementation |
+ |
+ /// Seaches for the first descendant node matching the given selectors, using |
+ /// a preorder traversal. |
+ /// |
+ /// NOTE: Not all selectors from |
+ /// [selectors level 4](http://dev.w3.org/csswg/selectors-4/) |
+ /// are implemented. For example, nth-child does not implement An+B syntax |
+ /// and *-of-type is not implemented. If a selector is not implemented this |
+ /// method will throw [UniplmentedError]. |
+ Element querySelector(String selector) => query.querySelector(this, selector); |
+ |
+ /// Returns all descendant nodes matching the given selectors, using a |
+ /// preorder traversal. |
+ /// |
+ /// NOTE: Not all selectors from |
+ /// [selectors level 4](http://dev.w3.org/csswg/selectors-4/) |
+ /// are implemented. For example, nth-child does not implement An+B syntax |
+ /// and *-of-type is not implemented. If a selector is not implemented this |
+ /// method will throw [UniplmentedError]. |
+ List<Element> querySelectorAll(String selector) => |
+ query.querySelectorAll(this, selector); |
+} |
+ |
+// http://dom.spec.whatwg.org/#interface-nonelementparentnode |
+abstract class _NonElementParentNode implements _ParentNode { |
+ // TODO(jmesserly): could be faster, should throw on invalid id. |
+ Element getElementById(String id) => querySelector('#$id'); |
+} |
+ |
+// This doesn't exist as an interface in the spec, but it's useful to merge |
+// common methods from these: |
+// http://dom.spec.whatwg.org/#interface-document |
+// http://dom.spec.whatwg.org/#element |
+abstract class _ElementAndDocument implements _ParentNode { |
+ // TODO(jmesserly): could be faster, should throw on invalid tag/class names. |
+ |
+ List<Element> getElementsByTagName(String localName) => |
+ querySelectorAll(localName); |
+ |
+ List<Element> getElementsByClassName(String classNames) => querySelectorAll( |
+ classNames.splitMapJoin(' ', |
+ onNonMatch: (m) => m.isNotEmpty ? '.$m' : m, onMatch: (m) => '')); |
+} |
+ |
+/// Really basic implementation of a DOM-core like Node. |
+abstract class Node { |
+ static const int ATTRIBUTE_NODE = 2; |
+ static const int CDATA_SECTION_NODE = 4; |
+ static const int COMMENT_NODE = 8; |
+ static const int DOCUMENT_FRAGMENT_NODE = 11; |
+ static const int DOCUMENT_NODE = 9; |
+ static const int DOCUMENT_TYPE_NODE = 10; |
+ static const int ELEMENT_NODE = 1; |
+ static const int ENTITY_NODE = 6; |
+ static const int ENTITY_REFERENCE_NODE = 5; |
+ static const int NOTATION_NODE = 12; |
+ static const int PROCESSING_INSTRUCTION_NODE = 7; |
+ static const int TEXT_NODE = 3; |
+ |
+ /// The parent of the current node (or null for the document node). |
+ Node parentNode; |
+ |
+ /// The parent element of this node. |
+ /// |
+ /// Returns null if this node either does not have a parent or its parent is |
+ /// not an element. |
+ Element get parent => parentNode is Element ? parentNode : null; |
+ |
+ // TODO(jmesserly): should move to Element. |
+ /// A map holding name, value pairs for attributes of the node. |
+ /// |
+ /// Note that attribute order needs to be stable for serialization, so we use |
+ /// a LinkedHashMap. Each key is a [String] or [AttributeName]. |
+ LinkedHashMap<dynamic, String> attributes = new LinkedHashMap(); |
+ |
+ /// A list of child nodes of the current node. This must |
+ /// include all elements but not necessarily other node types. |
+ final NodeList nodes = new NodeList._(); |
+ |
+ List<Element> _elements; |
+ |
+ // TODO(jmesserly): consider using an Expando for this, and put it in |
+ // dom_parsing. Need to check the performance affect. |
+ /// The source span of this node, if it was created by the [HtmlParser]. |
+ FileSpan sourceSpan; |
+ |
+ /// The attribute spans if requested. Otherwise null. |
+ LinkedHashMap<dynamic, FileSpan> _attributeSpans; |
+ LinkedHashMap<dynamic, FileSpan> _attributeValueSpans; |
+ |
+ Node._() { |
+ nodes._parent = this; |
+ } |
+ |
+ /// If [sourceSpan] is available, this contains the spans of each attribute. |
+ /// The span of an attribute is the entire attribute, including the name and |
+ /// quotes (if any). For example, the span of "attr" in `<a attr="value">` |
+ /// would be the text `attr="value"`. |
+ LinkedHashMap<dynamic, FileSpan> get attributeSpans { |
+ _ensureAttributeSpans(); |
+ return _attributeSpans; |
+ } |
+ |
+ /// If [sourceSpan] is available, this contains the spans of each attribute's |
+ /// value. Unlike [attributeSpans], this span will inlcude only the value. |
+ /// For example, the value span of "attr" in `<a attr="value">` would be the |
+ /// text `value`. |
+ LinkedHashMap<dynamic, FileSpan> get attributeValueSpans { |
+ _ensureAttributeSpans(); |
+ return _attributeValueSpans; |
+ } |
+ |
+ List<Element> get children { |
+ if (_elements == null) { |
+ _elements = new FilteredElementList(this); |
+ } |
+ return _elements; |
+ } |
+ |
+ /// Returns a copy of this node. |
+ /// |
+ /// If [deep] is `true`, then all of this node's children and decendents are |
+ /// copied as well. If [deep] is `false`, then only this node is copied. |
+ Node clone(bool deep); |
+ |
+ int get nodeType; |
+ |
+ // http://domparsing.spec.whatwg.org/#extensions-to-the-element-interface |
+ String get _outerHtml { |
+ var str = new StringBuffer(); |
+ _addOuterHtml(str); |
+ return str.toString(); |
+ } |
+ |
+ String get _innerHtml { |
+ var str = new StringBuffer(); |
+ _addInnerHtml(str); |
+ return str.toString(); |
+ } |
+ |
+ // Implemented per: http://dom.spec.whatwg.org/#dom-node-textcontent |
+ String get text => null; |
+ set text(String value) {} |
+ |
+ void append(Node node) => nodes.add(node); |
+ |
+ Node get firstChild => nodes.isNotEmpty ? nodes[0] : null; |
+ |
+ void _addOuterHtml(StringBuffer str); |
+ |
+ void _addInnerHtml(StringBuffer str) { |
+ for (Node child in nodes) child._addOuterHtml(str); |
+ } |
+ |
+ Node remove() { |
+ // TODO(jmesserly): is parent == null an error? |
+ if (parentNode != null) { |
+ parentNode.nodes.remove(this); |
+ } |
+ return this; |
+ } |
+ |
+ /// Insert [node] as a child of the current node, before [refNode] in the |
+ /// list of child nodes. Raises [UnsupportedOperationException] if [refNode] |
+ /// is not a child of the current node. If refNode is null, this adds to the |
+ /// end of the list. |
+ void insertBefore(Node node, Node refNode) { |
+ if (refNode == null) { |
+ nodes.add(node); |
+ } else { |
+ nodes.insert(nodes.indexOf(refNode), node); |
+ } |
+ } |
+ |
+ /// Replaces this node with another node. |
+ Node replaceWith(Node otherNode) { |
+ if (parentNode == null) { |
+ throw new UnsupportedError('Node must have a parent to replace it.'); |
+ } |
+ parentNode.nodes[parentNode.nodes.indexOf(this)] = otherNode; |
+ return this; |
+ } |
+ |
+ // TODO(jmesserly): should this be a property or remove? |
+ /// Return true if the node has children or text. |
+ bool hasContent() => nodes.length > 0; |
+ |
+ /// Move all the children of the current node to [newParent]. |
+ /// This is needed so that trees that don't store text as nodes move the |
+ /// text in the correct way. |
+ void reparentChildren(Node newParent) { |
+ newParent.nodes.addAll(nodes); |
+ nodes.clear(); |
+ } |
+ |
+ bool hasChildNodes() => !nodes.isEmpty; |
+ |
+ bool contains(Node node) => nodes.contains(node); |
+ |
+ /// Initialize [attributeSpans] using [sourceSpan]. |
+ void _ensureAttributeSpans() { |
+ if (_attributeSpans != null) return; |
+ |
+ _attributeSpans = new LinkedHashMap<dynamic, FileSpan>(); |
+ _attributeValueSpans = new LinkedHashMap<dynamic, FileSpan>(); |
+ |
+ if (sourceSpan == null) return; |
+ |
+ var tokenizer = new HtmlTokenizer(sourceSpan.text, |
+ generateSpans: true, attributeSpans: true); |
+ |
+ tokenizer.moveNext(); |
+ var token = tokenizer.current as StartTagToken; |
+ |
+ if (token.attributeSpans == null) return; // no attributes |
+ |
+ for (var attr in token.attributeSpans) { |
+ var offset = sourceSpan.start.offset; |
+ _attributeSpans[attr.name] = |
+ sourceSpan.file.span(offset + attr.start, offset + attr.end); |
+ if (attr.startValue != null) { |
+ _attributeValueSpans[attr.name] = sourceSpan.file.span( |
+ offset + attr.startValue, offset + attr.endValue); |
+ } |
+ } |
+ } |
+ |
+ _clone(Node shallowClone, bool deep) { |
+ if (deep) { |
+ for (var child in nodes) { |
+ shallowClone.append(child.clone(true)); |
+ } |
+ } |
+ return shallowClone; |
+ } |
+} |
+ |
+class Document extends Node |
+ with _ParentNode, _NonElementParentNode, _ElementAndDocument { |
+ Document() : super._(); |
+ factory Document.html(String html) => parse(html); |
+ |
+ int get nodeType => Node.DOCUMENT_NODE; |
+ |
+ // TODO(jmesserly): optmize this if needed |
+ Element get documentElement => querySelector('html'); |
+ Element get head => documentElement.querySelector('head'); |
+ Element get body => documentElement.querySelector('body'); |
+ |
+ /// Returns a fragment of HTML or XML that represents the element and its |
+ /// contents. |
+ // TODO(jmesserly): this API is not specified in: |
+ // <http://domparsing.spec.whatwg.org/> nor is it in dart:html, instead |
+ // only Element has outerHtml. However it is quite useful. Should we move it |
+ // to dom_parsing, where we keep other custom APIs? |
+ String get outerHtml => _outerHtml; |
+ |
+ String toString() => "#document"; |
+ |
+ void _addOuterHtml(StringBuffer str) => _addInnerHtml(str); |
+ |
+ Document clone(bool deep) => _clone(new Document(), deep); |
+ |
+ Element createElement(String tag) => new Element.tag(tag); |
+ |
+ // TODO(jmesserly): this is only a partial implementation of: |
+ // http://dom.spec.whatwg.org/#dom-document-createelementns |
+ Element createElementNS(String namespaceUri, String tag) { |
+ if (namespaceUri == '') namespaceUri = null; |
+ return new Element._(tag, namespaceUri); |
+ } |
+ |
+ DocumentFragment createDocumentFragment() => new DocumentFragment(); |
+} |
+ |
+class DocumentFragment extends Node with _ParentNode, _NonElementParentNode { |
+ DocumentFragment() : super._(); |
+ factory DocumentFragment.html(String html) => parseFragment(html); |
+ |
+ int get nodeType => Node.DOCUMENT_FRAGMENT_NODE; |
+ |
+ /// Returns a fragment of HTML or XML that represents the element and its |
+ /// contents. |
+ // TODO(jmesserly): this API is not specified in: |
+ // <http://domparsing.spec.whatwg.org/> nor is it in dart:html, instead |
+ // only Element has outerHtml. However it is quite useful. Should we move it |
+ // to dom_parsing, where we keep other custom APIs? |
+ String get outerHtml => _outerHtml; |
+ |
+ String toString() => "#document-fragment"; |
+ |
+ DocumentFragment clone(bool deep) => _clone(new DocumentFragment(), deep); |
+ |
+ void _addOuterHtml(StringBuffer str) => _addInnerHtml(str); |
+ |
+ String get text => _getText(this); |
+ set text(String value) => _setText(this, value); |
+} |
+ |
+class DocumentType extends Node { |
+ final String name; |
+ final String publicId; |
+ final String systemId; |
+ |
+ DocumentType(String name, this.publicId, this.systemId) |
+ // Note: once Node.tagName is removed, don't pass "name" to super |
+ : name = name, |
+ super._(); |
+ |
+ int get nodeType => Node.DOCUMENT_TYPE_NODE; |
+ |
+ String toString() { |
+ if (publicId != null || systemId != null) { |
+ // TODO(jmesserly): the html5 serialization spec does not add these. But |
+ // it seems useful, and the parser can handle it, so for now keeping it. |
+ var pid = publicId != null ? publicId : ''; |
+ var sid = systemId != null ? systemId : ''; |
+ return '<!DOCTYPE $name "$pid" "$sid">'; |
+ } else { |
+ return '<!DOCTYPE $name>'; |
+ } |
+ } |
+ |
+ void _addOuterHtml(StringBuffer str) { |
+ str.write(toString()); |
+ } |
+ |
+ DocumentType clone(bool deep) => new DocumentType(name, publicId, systemId); |
+} |
+ |
+class Text extends Node { |
+ /// The text node's data, stored as either a String or StringBuffer. |
+ /// We support storing a StringBuffer here to support fast [appendData]. |
+ /// It will flatten back to a String on read. |
+ var _data; |
+ |
+ Text(String data) : _data = data != null ? data : '', super._(); |
+ |
+ int get nodeType => Node.TEXT_NODE; |
+ |
+ String get data => _data = _data.toString(); |
+ set data(String value) { |
+ _data = value != null ? value : ''; |
+ } |
+ |
+ String toString() => '"$data"'; |
+ |
+ void _addOuterHtml(StringBuffer str) => writeTextNodeAsHtml(str, this); |
+ |
+ Text clone(bool deep) => new Text(data); |
+ |
+ void appendData(String data) { |
+ if (_data is! StringBuffer) _data = new StringBuffer(_data); |
+ StringBuffer sb = _data; |
+ sb.write(data); |
+ } |
+ |
+ String get text => data; |
+ set text(String value) { |
+ data = value; |
+ } |
+} |
+ |
+// TODO(jmesserly): Elements should have a pointer back to their document |
+class Element extends Node with _ParentNode, _ElementAndDocument { |
+ final String namespaceUri; |
+ |
+ /// The [local name](http://dom.spec.whatwg.org/#concept-element-local-name) |
+ /// of this element. |
+ final String localName; |
+ |
+ // TODO(jmesserly): consider using an Expando for this, and put it in |
+ // dom_parsing. Need to check the performance affect. |
+ /// The source span of the end tag this element, if it was created by the |
+ /// [HtmlParser]. May be `null` if does not have an implicit end tag. |
+ FileSpan endSourceSpan; |
+ |
+ Element._(this.localName, [this.namespaceUri]) : super._(); |
+ |
+ Element.tag(this.localName) |
+ : namespaceUri = Namespaces.html, |
+ super._(); |
+ |
+ static final _START_TAG_REGEXP = new RegExp('<(\\w+)'); |
+ |
+ static final _CUSTOM_PARENT_TAG_MAP = const { |
+ 'body': 'html', |
+ 'head': 'html', |
+ 'caption': 'table', |
+ 'td': 'tr', |
+ 'colgroup': 'table', |
+ 'col': 'colgroup', |
+ 'tr': 'tbody', |
+ 'tbody': 'table', |
+ 'tfoot': 'table', |
+ 'thead': 'table', |
+ 'track': 'audio', |
+ }; |
+ |
+ // TODO(jmesserly): this is from dart:html _ElementFactoryProvider... |
+ // TODO(jmesserly): have a look at fixing some things in dart:html, in |
+ // particular: is the parent tag map complete? Is it faster without regexp? |
+ // TODO(jmesserly): for our version we can do something smarter in the parser. |
+ // All we really need is to set the correct parse state. |
+ factory Element.html(String html) { |
+ |
+ // TODO(jacobr): this method can be made more robust and performant. |
+ // 1) Cache the dummy parent elements required to use innerHTML rather than |
+ // creating them every call. |
+ // 2) Verify that the html does not contain leading or trailing text nodes. |
+ // 3) Verify that the html does not contain both <head> and <body> tags. |
+ // 4) Detatch the created element from its dummy parent. |
+ String parentTag = 'div'; |
+ String tag; |
+ final match = _START_TAG_REGEXP.firstMatch(html); |
+ if (match != null) { |
+ tag = match.group(1).toLowerCase(); |
+ if (_CUSTOM_PARENT_TAG_MAP.containsKey(tag)) { |
+ parentTag = _CUSTOM_PARENT_TAG_MAP[tag]; |
+ } |
+ } |
+ |
+ var fragment = parseFragment(html, container: parentTag); |
+ Element element; |
+ if (fragment.children.length == 1) { |
+ element = fragment.children[0]; |
+ } else if (parentTag == 'html' && fragment.children.length == 2) { |
+ // You'll always get a head and a body when starting from html. |
+ element = fragment.children[tag == 'head' ? 0 : 1]; |
+ } else { |
+ throw new ArgumentError('HTML had ${fragment.children.length} ' |
+ 'top level elements but 1 expected'); |
+ } |
+ element.remove(); |
+ return element; |
+ } |
+ |
+ int get nodeType => Node.ELEMENT_NODE; |
+ |
+ // TODO(jmesserly): we can make this faster |
+ Element get previousElementSibling { |
+ if (parentNode == null) return null; |
+ var siblings = parentNode.nodes; |
+ for (int i = siblings.indexOf(this) - 1; i >= 0; i--) { |
+ var s = siblings[i]; |
+ if (s is Element) return s; |
+ } |
+ return null; |
+ } |
+ |
+ Element get nextElementSibling { |
+ if (parentNode == null) return null; |
+ var siblings = parentNode.nodes; |
+ for (int i = siblings.indexOf(this) + 1; i < siblings.length; i++) { |
+ var s = siblings[i]; |
+ if (s is Element) return s; |
+ } |
+ return null; |
+ } |
+ |
+ String toString() { |
+ var prefix = Namespaces.getPrefix(namespaceUri); |
+ return "<${prefix == null ? '' : '$prefix '}$localName>"; |
+ } |
+ |
+ String get text => _getText(this); |
+ set text(String value) => _setText(this, value); |
+ |
+ /// Returns a fragment of HTML or XML that represents the element and its |
+ /// contents. |
+ String get outerHtml => _outerHtml; |
+ |
+ /// Returns a fragment of HTML or XML that represents the element's contents. |
+ /// Can be set, to replace the contents of the element with nodes parsed from |
+ /// the given string. |
+ String get innerHtml => _innerHtml; |
+ // TODO(jmesserly): deprecate in favor of: |
+ // <https://api.dartlang.org/apidocs/channels/stable/#dart-dom-html.Element@id_setInnerHtml> |
+ set innerHtml(String value) { |
+ nodes.clear(); |
+ // TODO(jmesserly): should be able to get the same effect by adding the |
+ // fragment directly. |
+ nodes.addAll(parseFragment(value, container: localName).nodes); |
+ } |
+ |
+ void _addOuterHtml(StringBuffer str) { |
+ // http://www.whatwg.org/specs/web-apps/current-work/multipage/the-end.html#serializing-html-fragments |
+ // Element is the most complicated one. |
+ str.write('<'); |
+ str.write(_getSerializationPrefix(namespaceUri)); |
+ str.write(localName); |
+ |
+ if (attributes.length > 0) { |
+ attributes.forEach((key, v) { |
+ // Note: AttributeName.toString handles serialization of attribute |
+ // namespace, if needed. |
+ str.write(' '); |
+ str.write(key); |
+ str.write('="'); |
+ str.write(htmlSerializeEscape(v, attributeMode: true)); |
+ str.write('"'); |
+ }); |
+ } |
+ |
+ str.write('>'); |
+ |
+ if (nodes.length > 0) { |
+ if (localName == 'pre' || |
+ localName == 'textarea' || |
+ localName == 'listing') { |
+ final first = nodes[0]; |
+ if (first is Text && first.data.startsWith('\n')) { |
+ // These nodes will remove a leading \n at parse time, so if we still |
+ // have one, it means we started with two. Add it back. |
+ str.write('\n'); |
+ } |
+ } |
+ |
+ _addInnerHtml(str); |
+ } |
+ |
+ // void elements must not have an end tag |
+ // http://dev.w3.org/html5/markup/syntax.html#void-elements |
+ if (!isVoidElement(localName)) str.write('</$localName>'); |
+ } |
+ |
+ static String _getSerializationPrefix(String uri) { |
+ if (uri == null || |
+ uri == Namespaces.html || |
+ uri == Namespaces.mathml || |
+ uri == Namespaces.svg) { |
+ return ''; |
+ } |
+ var prefix = Namespaces.getPrefix(uri); |
+ // TODO(jmesserly): the spec doesn't define "qualified name". |
+ // I'm not sure if this is correct, but it should parse reasonably. |
+ return prefix == null ? '' : '$prefix:'; |
+ } |
+ |
+ Element clone(bool deep) { |
+ var result = new Element._(localName, namespaceUri) |
+ ..attributes = new LinkedHashMap.from(attributes); |
+ return _clone(result, deep); |
+ } |
+ |
+ // http://dom.spec.whatwg.org/#dom-element-id |
+ String get id { |
+ var result = attributes['id']; |
+ return result != null ? result : ''; |
+ } |
+ |
+ set id(String value) { |
+ attributes['id'] = '$value'; |
+ } |
+ |
+ // http://dom.spec.whatwg.org/#dom-element-classname |
+ String get className { |
+ var result = attributes['class']; |
+ return result != null ? result : ''; |
+ } |
+ |
+ set className(String value) { |
+ attributes['class'] = '$value'; |
+ } |
+ |
+ /** |
+ * The set of CSS classes applied to this element. |
+ * |
+ * This set makes it easy to add, remove or toggle the classes applied to |
+ * this element. |
+ * |
+ * element.classes.add('selected'); |
+ * element.classes.toggle('isOnline'); |
+ * element.classes.remove('selected'); |
+ */ |
+ CssClassSet get classes => new ElementCssClassSet(this); |
+} |
+ |
+class Comment extends Node { |
+ String data; |
+ |
+ Comment(this.data) : super._(); |
+ |
+ int get nodeType => Node.COMMENT_NODE; |
+ |
+ String toString() => "<!-- $data -->"; |
+ |
+ void _addOuterHtml(StringBuffer str) { |
+ str.write("<!--$data-->"); |
+ } |
+ |
+ Comment clone(bool deep) => new Comment(data); |
+ |
+ String get text => data; |
+ set text(String value) { |
+ this.data = value; |
+ } |
+} |
+ |
+// TODO(jmesserly): fix this to extend one of the corelib classes if possible. |
+// (The requirement to remove the node from the old node list makes it tricky.) |
+// TODO(jmesserly): is there any way to share code with the _NodeListImpl? |
+class NodeList extends ListProxy<Node> { |
+ // Note: this is conceptually final, but because of circular reference |
+ // between Node and NodeList we initialize it after construction. |
+ Node _parent; |
+ |
+ NodeList._(); |
+ |
+ Node get first => this[0]; |
+ |
+ Node _setParent(Node node) { |
+ // Note: we need to remove the node from its previous parent node, if any, |
+ // before updating its parent pointer to point at our parent. |
+ node.remove(); |
+ node.parentNode = _parent; |
+ return node; |
+ } |
+ |
+ void add(Node value) { |
+ if (value is DocumentFragment) { |
+ addAll(value.nodes); |
+ } else { |
+ super.add(_setParent(value)); |
+ } |
+ } |
+ |
+ void addLast(Node value) => add(value); |
+ |
+ void addAll(Iterable<Node> collection) { |
+ // Note: we need to be careful if collection is another NodeList. |
+ // In particular: |
+ // 1. we need to copy the items before updating their parent pointers, |
+ // _flattenDocFragments does a copy internally. |
+ // 2. we should update parent pointers in reverse order. That way they |
+ // are removed from the original NodeList (if any) from the end, which |
+ // is faster. |
+ var list = _flattenDocFragments(collection); |
+ for (var node in list.reversed) _setParent(node); |
+ super.addAll(list); |
+ } |
+ |
+ void insert(int index, Node value) { |
+ if (value is DocumentFragment) { |
+ insertAll(index, value.nodes); |
+ } else { |
+ super.insert(index, _setParent(value)); |
+ } |
+ } |
+ |
+ Node removeLast() => super.removeLast()..parentNode = null; |
+ |
+ Node removeAt(int i) => super.removeAt(i)..parentNode = null; |
+ |
+ void clear() { |
+ for (var node in this) node.parentNode = null; |
+ super.clear(); |
+ } |
+ |
+ void operator []=(int index, Node value) { |
+ if (value is DocumentFragment) { |
+ removeAt(index); |
+ insertAll(index, value.nodes); |
+ } else { |
+ this[index].parentNode = null; |
+ super[index] = _setParent(value); |
+ } |
+ } |
+ |
+ // TODO(jmesserly): These aren't implemented in DOM _NodeListImpl, see |
+ // http://code.google.com/p/dart/issues/detail?id=5371 |
+ void setRange(int start, int rangeLength, List<Node> from, |
+ [int startFrom = 0]) { |
+ if (from is NodeList) { |
+ // Note: this is presumed to make a copy |
+ from = from.sublist(startFrom, startFrom + rangeLength); |
+ } |
+ // Note: see comment in [addAll]. We need to be careful about the order of |
+ // operations if [from] is also a NodeList. |
+ for (int i = rangeLength - 1; i >= 0; i--) { |
+ this[start + i] = from[startFrom + i]; |
+ } |
+ } |
+ |
+ void replaceRange(int start, int end, Iterable<Node> newContents) { |
+ removeRange(start, end); |
+ insertAll(start, newContents); |
+ } |
+ |
+ void removeRange(int start, int rangeLength) { |
+ for (int i = start; i < rangeLength; i++) this[i].parentNode = null; |
+ super.removeRange(start, rangeLength); |
+ } |
+ |
+ void removeWhere(bool test(Element e)) { |
+ for (var node in where(test)) { |
+ node.parentNode = null; |
+ } |
+ super.removeWhere(test); |
+ } |
+ |
+ void retainWhere(bool test(Element e)) { |
+ for (var node in where((n) => !test(n))) { |
+ node.parentNode = null; |
+ } |
+ super.retainWhere(test); |
+ } |
+ |
+ void insertAll(int index, Iterable<Node> collection) { |
+ // Note: we need to be careful how we copy nodes. See note in addAll. |
+ var list = _flattenDocFragments(collection); |
+ for (var node in list.reversed) _setParent(node); |
+ super.insertAll(index, list); |
+ } |
+ |
+ _flattenDocFragments(Iterable<Node> collection) { |
+ // Note: this function serves two purposes: |
+ // * it flattens document fragments |
+ // * it creates a copy of [collections] when `collection is NodeList`. |
+ var result = []; |
+ for (var node in collection) { |
+ if (node is DocumentFragment) { |
+ result.addAll(node.nodes); |
+ } else { |
+ result.add(node); |
+ } |
+ } |
+ return result; |
+ } |
+} |
+ |
+/// An indexable collection of a node's descendants in the document tree, |
+/// filtered so that only elements are in the collection. |
+// TODO(jmesserly): this was copied from dart:html |
+// TODO(jmesserly): "implements List<Element>" is a workaround for analyzer bug. |
+class FilteredElementList extends IterableBase<Element> with ListMixin<Element> |
+ implements List<Element> { |
+ final Node _node; |
+ final List<Node> _childNodes; |
+ |
+ /// Creates a collection of the elements that descend from a node. |
+ /// |
+ /// Example usage: |
+ /// |
+ /// var filteredElements = new FilteredElementList(query("#container")); |
+ /// // filteredElements is [a, b, c]. |
+ FilteredElementList(Node node) |
+ : _childNodes = node.nodes, |
+ _node = node; |
+ |
+ // We can't memoize this, since it's possible that children will be messed |
+ // with externally to this class. |
+ // |
+ // TODO(nweiz): we don't always need to create a new list. For example |
+ // forEach, every, any, ... could directly work on the _childNodes. |
+ List<Element> get _filtered => |
+ new List<Element>.from(_childNodes.where((n) => n is Element)); |
+ |
+ void forEach(void f(Element element)) { |
+ _filtered.forEach(f); |
+ } |
+ |
+ void operator []=(int index, Element value) { |
+ this[index].replaceWith(value); |
+ } |
+ |
+ void set length(int newLength) { |
+ final len = this.length; |
+ if (newLength >= len) { |
+ return; |
+ } else if (newLength < 0) { |
+ throw new ArgumentError("Invalid list length"); |
+ } |
+ |
+ removeRange(newLength, len); |
+ } |
+ |
+ String join([String separator = ""]) => _filtered.join(separator); |
+ |
+ void add(Element value) { |
+ _childNodes.add(value); |
+ } |
+ |
+ void addAll(Iterable<Element> iterable) { |
+ for (Element element in iterable) { |
+ add(element); |
+ } |
+ } |
+ |
+ bool contains(Element element) { |
+ return element is Element && _childNodes.contains(element); |
+ } |
+ |
+ Iterable<Element> get reversed => _filtered.reversed; |
+ |
+ void sort([int compare(Element a, Element b)]) { |
+ throw new UnsupportedError('TODO(jacobr): should we impl?'); |
+ } |
+ |
+ void setRange(int start, int end, Iterable<Element> iterable, |
+ [int skipCount = 0]) { |
+ throw new UnimplementedError(); |
+ } |
+ |
+ void fillRange(int start, int end, [Element fillValue]) { |
+ throw new UnimplementedError(); |
+ } |
+ |
+ void replaceRange(int start, int end, Iterable<Element> iterable) { |
+ throw new UnimplementedError(); |
+ } |
+ |
+ void removeRange(int start, int end) { |
+ _filtered.sublist(start, end).forEach((el) => el.remove()); |
+ } |
+ |
+ void clear() { |
+ // Currently, ElementList#clear clears even non-element nodes, so we follow |
+ // that behavior. |
+ _childNodes.clear(); |
+ } |
+ |
+ Element removeLast() { |
+ final result = this.last; |
+ if (result != null) { |
+ result.remove(); |
+ } |
+ return result; |
+ } |
+ |
+ Iterable map(f(Element element)) => _filtered.map(f); |
+ Iterable<Element> where(bool f(Element element)) => _filtered.where(f); |
+ Iterable expand(Iterable f(Element element)) => _filtered.expand(f); |
+ |
+ void insert(int index, Element value) { |
+ _childNodes.insert(index, value); |
+ } |
+ |
+ void insertAll(int index, Iterable<Element> iterable) { |
+ _childNodes.insertAll(index, iterable); |
+ } |
+ |
+ Element removeAt(int index) { |
+ final result = this[index]; |
+ result.remove(); |
+ return result; |
+ } |
+ |
+ bool remove(Object element) { |
+ if (element is! Element) return false; |
+ for (int i = 0; i < length; i++) { |
+ Element indexElement = this[i]; |
+ if (identical(indexElement, element)) { |
+ indexElement.remove(); |
+ return true; |
+ } |
+ } |
+ return false; |
+ } |
+ |
+ Element reduce(Element combine(Element value, Element element)) { |
+ return _filtered.reduce(combine); |
+ } |
+ |
+ dynamic fold(dynamic initialValue, |
+ dynamic combine(dynamic previousValue, Element element)) { |
+ return _filtered.fold(initialValue, combine); |
+ } |
+ |
+ bool every(bool f(Element element)) => _filtered.every(f); |
+ bool any(bool f(Element element)) => _filtered.any(f); |
+ List<Element> toList({bool growable: true}) => |
+ new List<Element>.from(this, growable: growable); |
+ Set<Element> toSet() => new Set<Element>.from(this); |
+ Element firstWhere(bool test(Element value), {Element orElse()}) { |
+ return _filtered.firstWhere(test, orElse: orElse); |
+ } |
+ |
+ Element lastWhere(bool test(Element value), {Element orElse()}) { |
+ return _filtered.lastWhere(test, orElse: orElse); |
+ } |
+ |
+ Element singleWhere(bool test(Element value)) { |
+ return _filtered.singleWhere(test); |
+ } |
+ |
+ Element elementAt(int index) { |
+ return this[index]; |
+ } |
+ |
+ bool get isEmpty => _filtered.isEmpty; |
+ int get length => _filtered.length; |
+ Element operator [](int index) => _filtered[index]; |
+ Iterator<Element> get iterator => _filtered.iterator; |
+ List<Element> sublist(int start, [int end]) => _filtered.sublist(start, end); |
+ Iterable<Element> getRange(int start, int end) => |
+ _filtered.getRange(start, end); |
+ int indexOf(Element element, [int start = 0]) => |
+ _filtered.indexOf(element, start); |
+ |
+ int lastIndexOf(Element element, [int start = null]) { |
+ if (start == null) start = length - 1; |
+ return _filtered.lastIndexOf(element, start); |
+ } |
+ |
+ Element get first => _filtered.first; |
+ |
+ Element get last => _filtered.last; |
+ |
+ Element get single => _filtered.single; |
+} |
+ |
+// http://dom.spec.whatwg.org/#dom-node-textcontent |
+// For Element and DocumentFragment |
+String _getText(Node node) => |
+ (new _ConcatTextVisitor()..visit(node)).toString(); |
+ |
+void _setText(Node node, String value) { |
+ node.nodes.clear(); |
+ node.append(new Text(value)); |
+} |
+ |
+class _ConcatTextVisitor extends TreeVisitor { |
+ final _str = new StringBuffer(); |
+ |
+ String toString() => _str.toString(); |
+ |
+ visitText(Text node) { |
+ _str.write(node.data); |
+ } |
+} |