You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
They were once named "localDOM" and "lightDOM", but they now use
lowercase abbreviations "localDom" and "lightDom". Make sure the Primer
doc refers to the correct names.
Copy file name to clipboardExpand all lines: PRIMER.md
+25-25
Original file line number
Diff line number
Diff line change
@@ -453,7 +453,7 @@ Example:
453
453
<aname="dom-api"></a>
454
454
## DOM API
455
455
456
-
Polymer provides custom API for manipulating dom such that local DOM and light DOM trees are properly maintained. An element has a `lightDOM` property and a `localDOM` each of which are used to manipulate their respective dom trees. The following methods are provided:
456
+
Polymer provides custom API for manipulating dom such that local DOM and light DOM trees are properly maintained. An element has a `lightDom` property and a `localDom` each of which are used to manipulate their respective dom trees. The following methods are provided:
var allSpans = this.localDOM.querySelectorAll('span');
474
+
var allSpans = this.localDom.querySelectorAll('span');
475
475
```
476
476
477
477
For manipulating dom in elements that themselves do not have local dom, the above api's support an extra argument which is the container `node` in which the operation should be performed.
**NOTE:** It's only strictly necessary to use `lightDOM/localDOM` when performing dom manipulation on elements whose composed dom and local dom is distinct. This includes elements with local dom and elements that are parents of insertion points. It is recommended, however, that `lightDOM/localDOM` be used whenever manipulating element dom.
496
+
**NOTE:** It's only strictly necessary to use `lightDom/localDom` when performing dom manipulation on elements whose composed dom and local dom is distinct. This includes elements with local dom and elements that are parents of insertion points. It is recommended, however, that `lightDom/localDom` be used whenever manipulating element dom.
497
497
498
498
When multiple dom operations need to occur at once time, it's more efficient to batch these operations together. A batching mechanism is provided to support this use case.
0 commit comments