Class Element

Phần tử

Biểu thị một 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ức	Kiểu dữ liệu trả về	Mô tả ngắn
addContent(content)	Element	Nối 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à phần tử con trực tiếp của nút Element.
cloneContent()	Content[]	Tạo bản sao không đí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()	Content|null	Tách nút khỏi nút mẹ Element.
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)	Attribute|null	Lấy thuộc tính cho nút Element này bằng tên đã cho và không có không gian tên.
getAttribute(name, namespace)	Attribute|null	Lấ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ả cá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)	Element|null	Lấy nút Element đầu tiên có tên đã cho và không có không gian tên là nút con trực tiếp của nút Element này.
getChild(name, namespace)	Element|null	Lấy nút Element đầu tiên 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.
getChildText(name)	String|null	Lấy giá trị văn bản của nút có tên cho trước 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|null	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.
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à 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|null	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}.
getContentSize()	Integer	Lấ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()	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 vùng chứa tên có tiền tố đã cho cho nút Element.
getParentElement()	Element|null	Lấy nút Element mẹ của nút.
getQualifiedName()	String	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].
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à 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)	Boolean	Xác định xem nút Element này có phải là nút mẹ trực tiếp hay gián tiếp của một nút Element nhất định hay không.
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 cho nút Element này bằng 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)	Boolean	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.
removeContent()	Content[]	Xoá tất cả các nút là phần tử con trực tiếp của nút {@code Element}.
removeContent(content)	Boolean	Xoá nút đã cho, nếu nút đó là nút con trực tiếp của nút {@code Element}.
removeContent(index)	Content|null	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}.
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ộ 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)

Nối 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.

Thông số

Tên	Loại	Mô tả
content	Content	Nút cần thêm.

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à phầ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.

Thông số

Tên	Loại	Mô tả
index	Integer	Chỉ 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.
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 không đí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 đượ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 khỏi nút mẹ Element. 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|null – Nút bị tách rời.

---

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 bằng 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.

Thông số

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

Cầu thủ trả bóng

Attribute|null – 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.

---

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.

Thông số

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

Cầu thủ trả bóng

Attribute|null – 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ả cá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 là nút con trực tiếp 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.

Thông số

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

Cầu thủ trả bóng

Element|null – Nút Element hoặc null nếu không có nút Element con trực tiếp nào 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à phần tử con trực tiếp 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.

Thông số

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

Cầu thủ trả bóng

Element|null — Nút Element hoặc null nếu không có nút Element con trực tiếp nào 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 trước 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.

Thông số

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

Cầu thủ trả bóng

String|null – Giá trị văn bản của nút con hoặc null nếu không có nút con nào 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.

Thông 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|null – Giá trị văn bản của nút con hoặc null nếu không có nút con 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à 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ó 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.

Thông số

Tên	Loại	Mô tả
name	String	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 đã 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à 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.

Thông số

Tên	Loại	Mô tả
name	String	Tên của các nút Element con.
namespace	Namespace	Khô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 đã cho 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 ở chỉ mục đã cho, phương thức này sẽ trả về null.

Thông 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à phần tử con trực tiếp của nút {@code Element}.

Cầu thủ trả bóng

Content|null – Nút hoặc null nếu không có nút nào ở 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à thành phần 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 vùng chứa tên có tiền tố đã cho cho nút Element.

Thông 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ế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|null – 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 có phải là nút mẹ trực tiếp hay gián tiếp của một nút Element nhất định hay không.

Thông số

Tên	Loại	Mô tả
other	Element	Nút Element còn lại.

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.

Thông 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 cho nút Element này bằng tên đã cho và không có không gian tên, nếu thuộc tính đó tồn tại.

Thông số

Tên	Loại	Mô tả
attributeName	String	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.

---

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.

Thông số

Tên	Loại	Mô tả
attributeName	String	Tên của 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()

Xoá 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} trước khi chúng 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à một đố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.

Thông 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à 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à phần tử con trực tiếp của nút {@code Element}. Nếu không có nút nào ở chỉ mục đã cho, phương thức này sẽ trả về null.

Thông 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à phần tử con trực tiếp của nút {@code Element}.

Cầu thủ trả bóng

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

---

setAttribute(attribute)

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

Thông 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ó không gian tên.

Thông 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.

Thông 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ố vùng chứa tên cho nút, hãy sử dụng setNamespace(namespace) cùng với XmlService.getNamespace(prefix, uri).

Thông số

Tên	Loại	Mô tả
name	String	Tên địa phương 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.

Thông 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 một 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 dùng addContent(content) hoặc addContent(index, content).

Thông 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.