Trang này được dịch bởi Cloud Translation API.

Class Element

Hình minh hoạ một nút Element XML.

// Adds up the values listed in a sample XML document and adds a new element with the total.
var xml = '<things>'
    + '<plates>12</plates>'
    + '<bowls>18</bowls>'
    + '<cups>25</cups>'
    + '</things>';
var document = XmlService.parse(xml);
var root = document.getRootElement();
var items = root.getChildren();
var total = 0;
for (var i = 0; i < items.length; i++) {
  total += Number(items[i].getText());
}
var totalElement = XmlService.createElement('total').setText(total);
root.addContent(totalElement);
xml = XmlService.getPrettyFormat().format(document);
Logger.log(xml);

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`addContent(content)`	`Element`	Thêm nút đã cho làm nút con cuối cùng của nút `Element`.
`addContent(index, content)`	`Element`	Chèn nút đã cho tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của Nút `Element`.
`cloneContent()`	`Content[]`	Tạo bản sao chưa được đính kèm của tất cả các nút là con trực tiếp của nút {@code Element}.
`detach()`	`Content`	Tách nút này khỏi nút `Element` mẹ.
`getAllContent()`	`Content[]`	Lấy tất cả các nút là con trực tiếp của nút {@code Element}.
`getAttribute(name)`	`Attribute`	Lấy thuộc tính của nút `Element` này kèm theo tên đã cho và không có vùng chứa tên.
`getAttribute(name, namespace)`	`Attribute`	Lấy thuộc tính của nút `Element` này cùng với tên và không gian tên đã cho.
`getAttributes()`	`Attribute[]`	Lấy tất cả thuộc tính của nút `Element` này theo thứ tự xuất hiện trong tài liệu.
`getChild(name)`	`Element`	Lấy nút `Element` đầu tiên có tên đã cho và không có vùng chứa tên nào là ngay lập tức phần tử con của nút `Element` này.
`getChild(name, namespace)`	`Element`	Lấy nút `Element` đầu tiên có tên và không gian tên đã cho phần tử con của nút `Element` này.
`getChildText(name)`	`String`	Lấy giá trị văn bản của nút có tên đã cho và không có không gian tên, nếu nút đó là một phần tử con trực tiếp của nút `Element`.
`getChildText(name, namespace)`	`String`	Lấy giá trị văn bản của nút có tên và không gian tên đã cho, nếu nút đó là nút tức thì phần tử con của nút `Element`.
`getChildren()`	`Element[]`	Lấy tất cả các nút `Element` là nút con trực tiếp của nút `Element` này, trong thứ tự xuất hiện trong tài liệu.
`getChildren(name)`	`Element[]`	Lấy tất cả các nút `Element` có tên đã cho và không có vùng chứa tên nào là phần tử con trực tiếp của nút `Element` này, theo thứ tự xuất hiện trong tài liệu.
`getChildren(name, namespace)`	`Element[]`	Lấy tất cả các nút `Element` có tên và không gian tên đã cho là phần tử con trực tiếp của nút `Element` này, theo thứ tự xuất hiện trong tài liệu.
`getContent(index)`	`Content`	Lấy nút tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của Nút {@code Element}.
`getContentSize()`	`Integer`	Lấy số lượng nút là nút con trực tiếp của nút {@code Element}.
`getDescendants()`	`Content[]`	Lấy tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút {@code Element} theo thứ tự chúng sẽ xuất hiện trong tài liệu.
`getDocument()`	`Document`	Lấy tài liệu XML chứa nút {@code Element}.
`getName()`	`String`	Lấy tên cục bộ của nút `Element`.
`getNamespace()`	`Namespace`	Lấy không gian tên cho nút `Element`.
`getNamespace(prefix)`	`Namespace`	Lấy không gian tên có tiền tố đã cho cho nút `Element`.
`getParentElement()`	`Element`	Lấy nút `Element` mẹ của nút này.
`getQualifiedName()`	`String`	Lấy tên cục bộ và tiền tố không gian tên của nút `Element`, có dạng `[namespacePrefix]:[localName]`.
`getText()`	`String`	Lấy giá trị văn bản của nút `Element`.
`getValue()`	`String`	Lấy giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó theo thứ tự chúng sẽ xuất hiện trong tài liệu.
`isAncestorOf(other)`	`Boolean`	Xác định xem nút `Element` này là nút mẹ trực tiếp hay gián tiếp của một nút `Element` nhất định.
`isRootElement()`	`Boolean`	Xác định xem nút `Element` có phải là nút gốc của tài liệu hay không.
`removeAttribute(attribute)`	`Boolean`	Xoá thuộc tính đã cho cho nút `Element` này nếu có thuộc tính như vậy.
`removeAttribute(attributeName)`	`Boolean`	Xoá thuộc tính có tên đã cho và không có vùng chứa tên của nút `Element` này, nếu có thuộc tính như vậy.
`removeAttribute(attributeName, namespace)`	`Boolean`	Xoá thuộc tính của nút `Element` này cùng với tên và không gian tên đã cho, nếu đúng thuộc tính tồn tại.
`removeContent()`	`Content[]`	Xóa tất cả các nút là con trực tiếp của nút {@code Element}.
`removeContent(content)`	`Boolean`	Xóa nút đã cho, nếu nút này là phần tử con trực tiếp của nút {@code Element}.
`removeContent(index)`	`Content`	Xoá nút tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của Nút {@code Element}.
`setAttribute(attribute)`	`Element`	Đặt thuộc tính đã cho cho nút `Element` này.
`setAttribute(name, value)`	`Element`	Đặt thuộc tính cho nút `Element` này bằng tên, giá trị đã cho và không có vùng chứa tên.
`setAttribute(name, value, namespace)`	`Element`	Đặt thuộc tính cho nút `Element` này bằng tên, giá trị và không gian tên đã cho.
`setName(name)`	`Element`	Đặt tên cục bộ cho nút `Element`.
`setNamespace(namespace)`	`Element`	Đặt không gian tên cho nút `Element`.
`setText(text)`	`Element`	Đặt giá trị văn bản của nút `Element`.

Tài liệu chi tiết

`addContent(content)`

Thêm nút đã cho làm nút con cuối cùng của nút Element. content đối số có thể là đối tượng Element hoặc bất kỳ đối tượng nút nào tương ứng với một loại được liệt kê trong ContentType.

Tham số

Tên	Loại	Mô tả
`content`	`Content`	nút cần nối

Cầu thủ trả bóng

Element – nút Element, để tạo chuỗi

`addContent(index, content)`

Chèn nút đã cho tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của Nút Element. Đối số content có thể là đối tượng Element hoặc bất kỳ đối tượng nào đối tượng nút tương ứng với một loại được liệt kê trong ContentType.

Tham số

Tên	Loại	Mô tả
`index`	`Integer`	chỉ mục cần chèn nút vào số tất cả các nút là nút con trực tiếp của nút `Element`
`content`	`Content`	nút cần chèn

Cầu thủ trả bóng

Element – nút Element, để tạo chuỗi

`cloneContent()`

Tạo bản sao chưa được đính kèm của tất cả các nút là con trực tiếp của nút {@code Element}.

Cầu thủ trả bóng

Content[] – một mảng các bản sao chưa được đính kèm của tất cả các nút là phần tử con trực tiếp của Nút {@code Element}

`detach()`

Tách nút này khỏi nút Element mẹ. Nếu nút này không có thư mục mẹ, phương pháp này không có hiệu quả.

Cầu thủ trả bóng

Content – nút đã tách

`getAllContent()`

Lấy tất cả các nút là con trực tiếp của nút {@code Element}.

Cầu thủ trả bóng

Content[] – một mảng gồm tất cả các nút là phần tử con trực tiếp của nút {@code Element}

`getAttribute(name)`

Lấy thuộc tính của nút Element này kèm theo tên đã cho và không có vùng chứa tên. Nếu có không có thuộc tính nào như vậy, phương thức này sẽ trả về null.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên thuộc tính

Cầu thủ trả bóng

Attribute – thuộc tính này hoặc null nếu không có thuộc tính nào có tên đã cho và không có không gian tên

`getAttribute(name, namespace)`

Lấy thuộc tính của nút Element này cùng với tên và không gian tên đã cho. Nếu có không có nút nào như vậy, phương thức này sẽ trả về null.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên thuộc tính
`namespace`	`Namespace`	không gian tên của thuộc tính

Cầu thủ trả bóng

Attribute – thuộc tính này hoặc null nếu không có thuộc tính nào có tên và không gian tên

`getAttributes()`

Lấy tất cả thuộc tính của nút Element này theo thứ tự xuất hiện trong tài liệu.

Cầu thủ trả bóng

Attribute[] – một mảng gồm tất cả thuộc tính cho nút Element này

`getChild(name)`

Lấy nút Element đầu tiên có tên đã cho và không có vùng chứa tên nào là ngay lập tức phần tử con của nút Element này. Nếu không có nút nào như vậy, phương thức này sẽ trả về null.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của nút con `Element`

Cầu thủ trả bóng

Element – nút Element hoặc null nếu không có nút con Element ngay lập tức có tên đã cho và không có vùng chứa tên

`getChild(name, namespace)`

Lấy nút Element đầu tiên có tên và không gian tên đã cho phần tử con của nút Element này. Nếu không có nút nào như vậy, phương thức này sẽ trả về null.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của nút con `Element`
`namespace`	`Namespace`	không gian tên của nút con `Element`

Cầu thủ trả bóng

Element – nút Element hoặc null nếu không có nút con Element ngay lập tức có tên và không gian tên đã cho

`getChildText(name)`

Lấy giá trị văn bản của nút có tên đã cho và không có không gian tên, nếu nút đó là một phần tử con trực tiếp của nút Element. Nếu không có nút nào như vậy, phương thức này sẽ trả về null.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của nút con

Cầu thủ trả bóng

String – giá trị văn bản của nút con hoặc null nếu không có nút con ngay có tên đã cho và không có không gian tên

`getChildText(name, namespace)`

Lấy giá trị văn bản của nút có tên và không gian tên đã cho, nếu nút đó là nút tức thì phần tử con của nút Element. Nếu không có nút nào như vậy, phương thức này sẽ trả về null.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của nút con
`namespace`	`Namespace`	không gian tên của nút con

Cầu thủ trả bóng

String – giá trị văn bản của nút con hoặc null nếu không có nút con ngay bằng tên và không gian tên đã cho

`getChildren()`

Lấy tất cả các nút Element là nút con trực tiếp của nút Element này, trong thứ tự xuất hiện trong tài liệu.

Cầu thủ trả bóng

Element[] – một mảng gồm tất cả các nút Element là phần tử con trực tiếp của nút Element này

`getChildren(name)`

Lấy tất cả các nút Element có tên đã cho và không có vùng chứa tên nào là phần tử con trực tiếp của nút Element này, theo thứ tự xuất hiện trong tài liệu.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của các nút con `Element`

Cầu thủ trả bóng

Element[] – một mảng gồm tất cả các nút Element có tên đã cho và không có không gian tên nào phần tử con trực tiếp của nút Element này

`getChildren(name, namespace)`

Lấy tất cả các nút Element có tên và không gian tên đã cho là phần tử con trực tiếp của nút Element này, theo thứ tự xuất hiện trong tài liệu.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của các nút con `Element`
`namespace`	`Namespace`	không gian tên của các nút con `Element`

Cầu thủ trả bóng

Element[] – một mảng gồm tất cả các nút Element có tên và không gian tên đã cho phần tử con trực tiếp của nút Element này

`getContent(index)`

Lấy nút tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của Nút {@code Element}. Nếu không có nút nào tại chỉ mục đã cho, phương thức này sẽ trả về null.

Tham số

Tên	Loại	Mô tả
`index`	`Integer`	chỉ mục cho nút trong số tất cả các nút là nút con trực tiếp của nút Nút {@code Element}

Cầu thủ trả bóng

Content – nút này hoặc null nếu không có nút nào tại chỉ mục đã cho

`getContentSize()`

Lấy số lượng nút là nút con trực tiếp của nút {@code Element}.

Cầu thủ trả bóng

Integer — số lượng nút là con trực tiếp của nút {@code Element}

`getDescendants()`

Lấy tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút {@code Element} theo thứ tự chúng sẽ xuất hiện trong tài liệu.

Cầu thủ trả bóng

Content[] – một mảng gồm tất cả các nút là phần tử con trực tiếp hoặc gián tiếp của nút {@code Element}

`getDocument()`

Lấy tài liệu XML chứa nút {@code Element}.

Cầu thủ trả bóng

Document – tài liệu chứa nút {@code Element}

`getName()`

Lấy tên cục bộ của nút Element. Nếu nút có tiền tố không gian tên, hãy sử dụng getQualifiedName() hoặc getNamespace().getPrefix() thành lấy tiền tố.

Cầu thủ trả bóng

String – tên cục bộ của nút Element

`getNamespace()`

Lấy không gian tên cho nút Element.

Cầu thủ trả bóng

Namespace – không gian tên cho nút Element

`getNamespace(prefix)`

Lấy không gian tên có tiền tố đã cho cho nút Element.

Tham số

Tên	Loại	Mô tả
`prefix`	`String`	tiền tố cho không gian tên

Cầu thủ trả bóng

Namespace – không gian tên có tiền tố đã cho cho nút Element

`getParentElement()`

Lấy nút Element mẹ của nút này. Nếu nút này không có thư mục mẹ, phương thức này sẽ trả về null.

Cầu thủ trả bóng

Element – nút Element mẹ

`getQualifiedName()`

Lấy tên cục bộ và tiền tố không gian tên của nút Element, có dạng [namespacePrefix]:[localName]. Nếu nút này không có tiền tố không gian tên, hãy sử dụng getName().

Cầu thủ trả bóng

String – tên cục bộ và tiền tố không gian tên của nút Element, ở dạng [namespacePrefix]:[localName]

`getText()`

Lấy giá trị văn bản của nút Element.

Cầu thủ trả bóng

String — giá trị văn bản của nút Element

`getValue()`

Lấy giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó theo thứ tự chúng sẽ xuất hiện trong tài liệu.

Cầu thủ trả bóng

String – giá trị văn bản của tất cả các nút là con trực tiếp hoặc gián tiếp của nút đó

`isAncestorOf(other)`

Xác định xem nút Element này là nút mẹ trực tiếp hay gián tiếp của một nút Element nhất định.

Tham số

Tên	Loại	Mô tả
`other`	`Element`	nút `Element` khác

Cầu thủ trả bóng

Boolean – true nếu nút Element này là nút gốc trực tiếp hoặc gián tiếp của nút nhất định Nút Element; false nếu không

`isRootElement()`

Xác định xem nút Element có phải là nút gốc của tài liệu hay không.

Cầu thủ trả bóng

Boolean – true nếu nút Element là nút gốc của tài liệu; false nếu không

`removeAttribute(attribute)`

Xoá thuộc tính đã cho cho nút Element này nếu có thuộc tính như vậy.

Tham số

Tên	Loại	Mô tả
`attribute`	`Attribute`	thuộc tính

Cầu thủ trả bóng

Boolean – true nếu thuộc tính đã tồn tại và đã bị xoá; false nếu không

`removeAttribute(attributeName)`

Xoá thuộc tính có tên đã cho và không có vùng chứa tên của nút Element này, nếu có thuộc tính như vậy.

Tham số

Tên	Loại	Mô tả
`attributeName`	`String`	tên thuộc tính

Cầu thủ trả bóng

Boolean – true nếu thuộc tính đã tồn tại và đã bị xoá; false nếu không

`removeAttribute(attributeName, namespace)`

Xoá thuộc tính của nút Element này cùng với tên và không gian tên đã cho, nếu đúng thuộc tính tồn tại.

Tham số

Tên	Loại	Mô tả
`attributeName`	`String`	tên thuộc tính
`namespace`	`Namespace`	không gian tên của thuộc tính

Cầu thủ trả bóng

Boolean – true nếu thuộc tính đã tồn tại và đã bị xoá; false nếu không

`removeContent()`

Xóa tất cả các nút là con trực tiếp của nút {@code Element}.

Cầu thủ trả bóng

Content[] – một mảng gồm tất cả các nút là phần tử con trực tiếp của nút {@code Element} trước khi chúng đã bị xoá

`removeContent(content)`

Xóa nút đã cho, nếu nút này là phần tử con trực tiếp của nút {@code Element}. Đối số content có thể là đối tượng Element hoặc bất kỳ đối tượng nút nào tương ứng với loại được liệt kê trong ContentType.

Tham số

Tên	Loại	Mô tả
`content`	`Content`	nút cần xoá

Cầu thủ trả bóng

Boolean – true nếu nút là phần tử con trực tiếp và đã bị xoá; false nếu không

`removeContent(index)`

Xoá nút tại chỉ mục đã cho trong số tất cả các nút là nút con trực tiếp của Nút {@code Element}. Nếu không có nút nào tại chỉ mục đã cho, phương thức này sẽ trả về null.

Tham số

Tên	Loại	Mô tả
`index`	`Integer`	chỉ mục cho nút trong số tất cả các nút là nút con trực tiếp của nút Nút {@code Element}

Cầu thủ trả bóng

Content – nút đã bị xoá hoặc null nếu không có nút nào tại chỉ mục đã cho

`setAttribute(attribute)`

Đặt thuộc tính đã cho cho nút Element này.

Tham số

Tên	Loại	Mô tả
`attribute`	`Attribute`	thuộc tính cần đặt

Cầu thủ trả bóng

Element – nút Element, để tạo chuỗi

`setAttribute(name, value)`

Đặt thuộc tính cho nút Element này bằng tên, giá trị đã cho và không có vùng chứa tên.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của thuộc tính cần đặt
`value`	`String`	giá trị của thuộc tính cần đặt

Cầu thủ trả bóng

Element – nút Element, để tạo chuỗi

`setAttribute(name, value, namespace)`

Đặt thuộc tính cho nút Element này bằng tên, giá trị và không gian tên đã cho.

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên của thuộc tính cần đặt
`value`	`String`	giá trị của thuộc tính cần đặt
`namespace`	`Namespace`	không gian tên của thuộc tính cần đặt

Cầu thủ trả bóng

Element – nút Element, để tạo chuỗi

`setName(name)`

Đặt tên cục bộ cho nút Element. Để đặt tiền tố không gian tên cho nút, hãy sử dụng setNamespace(namespace) kết hợp với XmlService.getNamespace(prefix, uri).

Tham số

Tên	Loại	Mô tả
`name`	`String`	tên cục bộ để đặt

Cầu thủ trả bóng

Element – nút Element, để tạo chuỗi

`setNamespace(namespace)`

Đặt không gian tên cho nút Element.

Tham số

Tên	Loại	Mô tả
`namespace`	`Namespace`	không gian tên cần đặt

Cầu thủ trả bóng

Element – nút Element, để tạo chuỗi

`setText(text)`

Đặt giá trị văn bản của nút Element. Nếu nút đã chứa giá trị văn bản hoặc bất kỳ nút con nào, phương thức này sẽ ghi đè nội dung cũ. Để thêm hoặc chèn nội dung, hãy làm như sau: hãy sử dụng addContent(content) hoặc addContent(index, content).

Tham số

Tên	Loại	Mô tả
`text`	`String`	văn bản cần đặt

Cầu thủ trả bóng

Element – nút Element, để tạo chuỗi