Hình minh hoạ 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 | Kiểu 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à phầ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à phần tử con trực tiếp của nút {@code Element}. |
detach() | Content | Tách nút này 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 | 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. |
getAttribute(name, namespace) | Attribute | 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ả 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 đã đặt và không có không gian tên nào là nút con trực tiếp
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. Đây là nút con trực tiếp
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à phần tử con ngay lập tức của nút Element . |
getChildText(name, namespace) | String | Lấy giá trị văn bản của nút với tên và không gian tên đã cho, nếu nút đó là phầ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à 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ả nút Element có tên đã đặt và không có không gian tên nào là phần tử con ngay 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à 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 không gian tên có tiền tố đã cho cho nút Element . |
getParentElement() | Element | Lấy nút mẹ Element 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 , 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à 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 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 của nút Element này, nếu thuộc tính như vậy tồn tại. |
removeAttribute(attributeName) | Boolean | Xoá thuộc tính của nút Element có tên đã cho và không có không gian tên, nếu có một thuộc tính như vậy. |
removeAttribute(attributeName, namespace) | Boolean | Xoá thuộc tính của nút Element này (đã có tên và không gian tên) nếu có một 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à 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ị 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 sẵn. |
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 | Thiết lập 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
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
content | Content | nút để 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à 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
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
index | Integer | chỉ mục để chèn nút này vào giữa 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 để 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à 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()
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
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | 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 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
.
Các tham số
Tên | Loại | Nội dung 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
– 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 cụ thể
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ả 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 đã đặt và không có không gian tên nào 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
.
Các tham số
Tên | Loại | Nội dung 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
nào xuất hiện ngay 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. Đây 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
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | tên của nút con Element |
namespace | Namespace | khô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 con Element
nào xuất hiện ngay 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à phần tử con ngay lập tức 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
.
Các tham số
Tên | Loại | Nội dung 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 nào xuất hiện 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 với tên và không gian tên đã cho, nếu nút đó là 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
.
Các tham số
Tên | Loại | Nội dung 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 nào xuất hiện ngay có 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, 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ả nút Element
có tên đã đặt và không có không gian tên nào là phần tử con ngay của nút Element
này, theo thứ tự xuất hiện trong tài liệu.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | tên của 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 là 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | tên của nút con Element |
namespace | Namespace | không gian tên của 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à 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
.
Các tham số
Tên | Loại | Nội dung 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
– 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à phầ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à 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()
để nhận tiền tố.
Cầu thủ trả bóng
String
— tên cục bộ của nút Element
getNamespace()
getNamespace(prefix)
Lấy không gian tên có tiền tố đã cho cho nút Element
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
prefix | String | tiền tố của 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()
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 đó 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
, có 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à 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à 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.
Các tham số
Tên | Loại | Nội dung 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 mẹ trực tiếp hoặc gián tiếp của nút Element
nhất định; false
nếu không phải
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 phải là nút gốc
removeAttribute(attribute)
Xoá thuộc tính đã cho của nút Element
này, nếu thuộc tính như vậy tồn tại.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
attribute | Attribute | thuộc tính |
Cầu thủ trả bóng
Boolean
– true
nếu thuộc tính này tồn tại và đã bị xoá; false
nếu không có
removeAttribute(attributeName)
Xoá thuộc tính của nút Element
có tên đã cho và không có không gian tên, nếu có một thuộc tính như vậy.
Các tham số
Tên | Loại | Nội dung 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 này tồn tại và đã bị xoá; false
nếu không có
removeAttribute(attributeName, namespace)
Xoá thuộc tính của nút Element
này (đã có tên và không gian tên) nếu có một thuộc tính như vậy.
Các tham số
Tên | Loại | Nội dung 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 này tồn tại và đã bị xoá; false
nếu không có
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ị xóa
removeContent(content)
Xoá nút đã cho nếu nút đó 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 một loại được liệt kê trong ContentType
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
content | Content | nút để 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 phải
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
.
Các tham số
Tên | Loại | Nội dung 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
— nút đã bị xoá hoặc null
nếu không có nút nào tại chỉ mục đã cho
setAttribute(attribute)
setAttribute(name, value)
Đặt thuộc tính cho nút Element
này bằng tên, giá trị và không có không gian tên.
Các tham số
Tên | Loại | Nội dung 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 sẵn.
Các tham số
Tên | Loại | Nội dung 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ộ 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)
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | tên cục bộ cần đặt |
Cầu thủ trả bóng
Element
– nút Element
để tạo chuỗi
setNamespace(namespace)
setText(text)
Thiết lập 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ũ. Để nối hoặc chèn nội dung, hãy sử dụng addContent(content)
hoặc addContent(index, content)
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | văn bản cần thiết lập |
Cầu thủ trả bóng
Element
– nút Element
để tạo chuỗi