Class Element

Phần tử

Biểu thị nút Element XML. 

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

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
addContent(content)ElementThêm nút đã cho làm nút con cuối cùng của nút Element.
addContent(index, content)ElementChè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 đí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()ContentTách nút này khỏi nút Element mẹ.
getAllContent()Content[]Lấy tất cả các nút là phần tử con trực tiếp của nút {@code Element}.
getAttribute(name)AttributeLấy thuộc tính cho nút Element này có tên đã cho và không có không gian tên.
getAttribute(name, namespace)AttributeLấy thuộc tính cho nút Element này bằng tên và không gian tên đã cho.
getAttributes()Attribute[]Lấy tất cả thuộc tính cho nút Element này, theo thứ tự xuất hiện trong tài liệu.
getChild(name)ElementLấy nút Element đầu tiên có tên đã cho và không có không gian tên nào là nút con ngay lập tức của nút Element này.
getChild(name, namespace)ElementLấy nút Element đầu tiên có tên và không gian tên đã cho là nút con ngay lập tức của nút Element này.
getChildText(name)StringLấ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à nút con trực tiếp của nút Element.
getChildText(name, namespace)StringLấ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 con trực tiếp của nút Element.
getChildren()Element[]Lấy tất cả các nút Element 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)Element[]Lấy tất cả các nút Element có tên đã cho và không có không gian 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à các 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)ContentLấy nút tại chỉ mục đã cho trong số tất cả các nút là phần tử con trực tiếp của nút{@code Element}.
getContentSize()IntegerLấy số lượng nút là phầ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ự xuất hiện trong tài liệu.
getDocument()DocumentLấy tài liệu XML chứa nút {@code Element}.
getName()StringLấy tên cục bộ của nút Element.
getNamespace()NamespaceLấy không gian tên cho nút Element.
getNamespace(prefix)NamespaceLấy không gian tên có tiền tố đã cho cho nút Element.
getParentElement()ElementLấy nút Element mẹ của nút.
getQualifiedName()StringLấy tên cục bộ và tiền tố không gian tên của nút Element, ở dạng [namespacePrefix]:[localName].
getText()StringLấy giá trị văn bản của nút Element.
getValue()StringLấy giá trị văn bản của 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, theo thứ tự xuất hiện trong tài liệu.
isAncestorOf(other)BooleanXá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()BooleanXá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)BooleanXoá thuộc tính đã cho cho nút Element này, nếu có thuộc tính như vậy.
removeAttribute(attributeName)BooleanXoá thuộc tính cho nút Element này có tên đã cho và không có không gian tên, nếu thuộc tính đó tồn tại.
removeAttribute(attributeName, namespace)BooleanXoá thuộc tính cho nút Element này bằng tên và không gian tên đã cho, nếu có thuộc tính như vậy.
removeContent()Content[]Xoá tất cả nút là phần tử con trực tiếp của nút {@code Element}.
removeContent(content)BooleanXoá nút đã cho nếu nút đó là nút con trực tiếp của nút {@code Element}.
removeContent(index)ContentXoá nút tại chỉ mục đã cho trong số tất cả các nút là phầ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ó không gian 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ộ của 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. Đố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 một loại được liệt kê trong ContentType.

Tham số

TênLoạiMô tả
contentContentnút cần thêm vào

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út nào tương ứng với một loại được liệt kê trong ContentType.

Tham số

TênLoạiMô tả
indexIntegerchỉ mục để chèn nút trong số tất cả các nút là phần tử con trực tiếp của nút Element
contentContentnú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 đí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}.

Cầu thủ trả bóng

Content[] – một mảng các bản sao chưa đí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 không có nút mẹ, phương thức này sẽ không có hiệu lực.

Cầu thủ trả bóng

Content – nút đã tách

getAllContent()

Lấy tất cả các nút là phần tử 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 cho nút Element này có tên đã cho và không có không gian tên. Nếu 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ênLoạiMô tả
nameStringtên thuộc tính

Cầu thủ trả bóng

Attribute – thuộc tính 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 cho nút Element này bằng tên và không gian tên đã cho. 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ênLoạiMô tả
nameStringtên thuộc tính
namespaceNamespacekhông gian tên của thuộc tính

Cầu thủ trả bóng

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

getAttributes()

Lấy tất cả thuộc tính cho 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ả cá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ó không gian tên nào là nút con ngay lập tức 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ênLoạiMô tả
nameStringtên của nút Element con

Cầu thủ trả bóng

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

getChild(name, namespace)

Lấy nút Element đầu tiên có tên và không gian tên đã cho là nút con ngay lập tức 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ênLoạiMô tả
nameStringtên của nút Element con
namespaceNamespacekhông gian tên của nút Element con

Cầu thủ trả bóng

Element – nút Element hoặc null nếu không có nút Element con cấp dưới 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à 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ênLoạiMô tả
nameStringtê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 cấp trên 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 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ênLoạiMô tả
nameStringtên của nút con
namespaceNamespacekhô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 cấp trên trực tiếp nào có tên và không gian tên đã cho

getChildren()

Lấy tất cả các nút Element 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.

Cầu thủ trả bóng

Element[] – một mảng gồm tất cả các nút Element là 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ó không gian 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ênLoạiMô tả
nameStringtên của các nút Element con

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 là các 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à các 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ênLoạiMô tả
nameStringtên của các nút Element con
namespaceNamespacekhông gian tên của các nút Element con

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 nhất định, là các 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à phầ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ênLoạiMô tả
indexIntegerchỉ mục cho nút trong số tất cả các nút là phần tử con trực tiếp của nút {@code Element}

Cầu thủ trả bóng

Content – nút 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à phầ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à nút 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ự 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() để 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ênLoạiMô tả
prefixStringtiền tố cho không gian tên

Cầu thủ trả bóng

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

getParentElement()

Lấy nút Element mẹ của nút. Nếu nút không có nút 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, ở dạng [namespacePrefix]:[localName]. Nếu nút 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à phần tử con trực tiếp hoặc gián tiếp của nút, theo thứ tự 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à phần tử 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ênLoạiMô tả
otherElementnút Element khác

Cầu thủ trả bóng

Boolean – true nếu nút Element này là nút mẹ trực tiếp hoặc gián tiếp của nút Element đã cho; 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ênLoạiMô tả
attributeAttributethuộ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 cho nút Element này có tên đã cho và không có không gian tên, nếu thuộc tính đó tồn tại.

Tham số

TênLoạiMô tả
attributeNameStringtê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 cho nút Element này bằng tên và không gian tên đã cho, nếu có thuộc tính như vậy.

Tham số

TênLoạiMô tả
attributeNameStringtên thuộc tính
namespaceNamespacekhô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()

Xoá tất cả nút là phần tử 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 các nút đó bị xoá

removeContent(content)

Xoá nút đã cho nếu nút đó là 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 một loại được liệt kê trong ContentType.

Tham số

TênLoạiMô tả
contentContentnút cần xoá

Cầu thủ trả bóng

Boolean – true nếu nút là nút con cấp dưới 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à phầ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ênLoạiMô tả
indexIntegerchỉ mục cho nút trong số tất cả các nút là phần tử con trực tiếp của 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ênLoạiMô tả
attributeAttributethuộ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ó không gian tên.

Tham số

TênLoạiMô tả
nameStringtên của thuộc tính cần đặt
valueStringgiá 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ênLoạiMô tả
nameStringtên của thuộc tính cần đặt
valueStringgiá trị của thuộc tính cần đặt
namespaceNamespacekhô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ộ của 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ênLoạiMô tả
nameStringtên cục bộ cần đặ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ênLoạiMô tả
namespaceNamespacekhô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, thì phương thức này sẽ ghi đè nội dung cũ. Để thêm hoặc chèn nội dung, hãy sử dụng addContent(content) hoặc addContent(index, content).

Tham số

TênLoạiMô tả
textStringvăn bản cần đặt

Cầu thủ trả bóng

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