Skip to content

Commit 2d95d1e

Browse files
committed
docs(dom): edit document.getElementsByTagName
1 parent 7b4c045 commit 2d95d1e

File tree

2 files changed

+10
-10
lines changed

2 files changed

+10
-10
lines changed

docs/dom/document.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -496,7 +496,7 @@ document.querySelectorAll('DIV, A, SCRIPT');
496496

497497
### document.getElementsByTagName()
498498

499-
`document.getElementsByTagName`方法搜索 HTML 标签名,返回符合条件的元素。它的返回值是一个类似数组对象(`HTMLCollection`实例),可以实时反映 HTML 文档的变化。如果没有任何匹配的元素,就返回一个空集。
499+
`document.getElementsByTagName()`方法搜索 HTML 标签名,返回符合条件的元素。它的返回值是一个类似数组对象(`HTMLCollection`实例),可以实时反映 HTML 文档的变化。如果没有任何匹配的元素,就返回一个空集。
500500

501501
```javascript
502502
var paras = document.getElementsByTagName('p');
@@ -505,7 +505,7 @@ paras instanceof HTMLCollection // true
505505

506506
上面代码返回当前文档的所有`p`元素节点。
507507

508-
HTML 标签名是大小写不敏感的,因此`getElementsByTagName`方法也是大小写不敏感的。另外,返回结果中,各个成员的顺序就是它们在文档中出现的顺序。
508+
HTML 标签名是大小写不敏感的,因此`getElementsByTagName()`方法的参数也是大小写不敏感的。另外,返回结果中,各个成员的顺序就是它们在文档中出现的顺序。
509509

510510
如果传入`*`,就可以返回文档中所有 HTML 元素。
511511

@@ -524,7 +524,7 @@ var spans = firstPara.getElementsByTagName('span');
524524

525525
### document.getElementsByClassName()
526526

527-
`document.getElementsByClassName`方法返回一个类似数组的对象(`HTMLCollection`实例),包括了所有`class`名字符合指定条件的元素,元素的变化实时反映在返回结果中。
527+
`document.getElementsByClassName()`方法返回一个类似数组的对象(`HTMLCollection`实例),包括了所有`class`名字符合指定条件的元素,元素的变化实时反映在返回结果中。
528528

529529
```javascript
530530
var elements = document.getElementsByClassName(names);
@@ -542,7 +542,7 @@ var elements = document.getElementsByClassName('foo bar');
542542

543543
注意,正常模式下,CSS 的`class`是大小写敏感的。(`quirks mode`下,大小写不敏感。)
544544

545-
`getElementsByTagName`方法一样,`getElementsByClassName`方法不仅可以在`document`对象上调用,也可以在任何元素节点上调用。
545+
`getElementsByTagName()`方法一样,`getElementsByClassName()`方法不仅可以在`document`对象上调用,也可以在任何元素节点上调用。
546546

547547
```javascript
548548
// 非document对象上调用
@@ -551,7 +551,7 @@ var elements = rootElement.getElementsByClassName(names);
551551

552552
### document.getElementsByName()
553553

554-
`document.getElementsByName`方法用于选择拥有`name`属性的 HTML 元素(比如`<form>``<radio>``<img>``<frame>``<embed>``<object>`等),返回一个类似数组的的对象(`NodeList`实例),因为`name`属性相同的元素可能不止一个。
554+
`document.getElementsByName()`方法用于选择拥有`name`属性的 HTML 元素(比如`<form>``<radio>``<img>``<frame>``<embed>``<object>`等),返回一个类似数组的的对象(`NodeList`实例),因为`name`属性相同的元素可能不止一个。
555555

556556
```javascript
557557
// 表单为 <form name="x"></form>
@@ -561,15 +561,15 @@ forms[0].tagName // "FORM"
561561

562562
### document.getElementById()
563563

564-
`document.getElementById`方法返回匹配指定`id`属性的元素节点。如果没有发现匹配的节点,则返回`null`
564+
`document.getElementById()`方法返回匹配指定`id`属性的元素节点。如果没有发现匹配的节点,则返回`null`
565565

566566
```javascript
567567
var elem = document.getElementById('para1');
568568
```
569569

570570
注意,该方法的参数是大小写敏感的。比如,如果某个节点的`id`属性是`main`,那么`document.getElementById('Main')`将返回`null`
571571

572-
`document.getElementById`方法与`document.querySelector`方法都能获取元素节点,不同之处是`document.querySelector`方法的参数使用 CSS 选择器语法,`document.getElementById`方法的参数是元素的`id`属性。
572+
`document.getElementById()`方法与`document.querySelector()`方法都能获取元素节点,不同之处是`document.querySelector()`方法的参数使用 CSS 选择器语法,`document.getElementById()`方法的参数是元素的`id`属性。
573573

574574
```javascript
575575
document.getElementById('myElement')
@@ -582,7 +582,7 @@ document.querySelector('#myElement')
582582

583583
### document.elementFromPoint(),document.elementsFromPoint()
584584

585-
`document.elementFromPoint`方法返回位于页面指定位置最上层的元素节点。
585+
`document.elementFromPoint()`方法返回位于页面指定位置最上层的元素节点。
586586

587587
```javascript
588588
var element = document.elementFromPoint(50, 50);

docs/dom/element.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -603,14 +603,14 @@ for (var i = 0; i< matches.length; i++) {
603603

604604
### Element.getElementsByTagName()
605605

606-
`Element.getElementsByTagName`方法返回一个`HTMLCollection`实例,成员是当前节点的所有匹配指定标签名的子元素节点。该方法与`document.getElementsByClassName`方法的用法类似,只是搜索范围不是整个文档,而是当前元素节点。
606+
`Element.getElementsByTagName()`方法返回一个`HTMLCollection`实例,成员是当前节点的所有匹配指定标签名的子元素节点。该方法与`document.getElementsByClassName()`方法的用法类似,只是搜索范围不是整个文档,而是当前元素节点。
607607

608608
```javascript
609609
var table = document.getElementById('forecast-table');
610610
var cells = table.getElementsByTagName('td');
611611
```
612612

613-
注意,该方法的参数是大小写不敏感的。
613+
注意,该方法的参数是大小写不敏感的,因为 HTML 标签名也是大小写不敏感
614614

615615
### Element.closest()
616616

0 commit comments

Comments
 (0)