Representasi node 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);
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
addContent(content) | Element | Menambahkan node yang diberikan sebagai turunan terakhir dari node Element . |
addContent(index, content) | Element | Menyisipkan node yang diberikan pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari node Element . |
cloneContent() | Content[] | Membuat salinan yang tidak terpasang dari semua node yang merupakan turunan langsung dari node {@code Element}. |
detach() | Content | Lepaskan node dari node Element induknya. |
getAllContent() | Content[] | Mendapatkan semua node yang merupakan turunan langsung dari node {@code Element}. |
getAttribute(name) | Attribute | Mendapatkan atribut untuk node Element ini dengan nama yang diberikan dan tanpa namespace. |
getAttribute(name, namespace) | Attribute | Mendapatkan atribut untuk node Element ini dengan nama dan namespace yang diberikan. |
getAttributes() | Attribute[] | Mendapatkan semua atribut untuk node Element ini, sesuai urutan kemunculannya dalam dokumen. |
getChild(name) | Element | Mendapatkan node Element pertama dengan nama yang diberikan dan tanpa namespace yang merupakan turunan langsung dari node Element ini. |
getChild(name, namespace) | Element | Mendapatkan node Element pertama dengan nama dan namespace yang diberikan yang merupakan turunan langsung dari node Element ini. |
getChildText(name) | String | Mendapatkan nilai teks node dengan nama yang diberikan dan tanpa namespace, jika node tersebut adalah
turunan langsung dari node Element . |
getChildText(name, namespace) | String | Mendapatkan nilai teks node dengan nama dan namespace yang diberikan, jika node tersebut adalah turunan langsung dari node Element . |
getChildren() | Element[] | Mendapatkan semua node Element yang merupakan turunan langsung node Element ini, sesuai
urutan kemunculannya dalam dokumen. |
getChildren(name) | Element[] | Mendapatkan semua node Element dengan nama yang diberikan dan tanpa namespace yang merupakan turunan langsung node Element ini, sesuai urutan kemunculannya dalam dokumen. |
getChildren(name, namespace) | Element[] | Mendapatkan semua node Element dengan nama dan namespace tertentu yang merupakan turunan langsung node Element ini, sesuai urutan kemunculannya dalam dokumen. |
getContent(index) | Content | Mendapatkan node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung node {@code Element}. |
getContentSize() | Integer | Mendapatkan jumlah node yang merupakan turunan langsung dari node {@code Element}. |
getDescendants() | Content[] | Mendapatkan semua node yang merupakan turunan langsung atau tidak langsung dari node {@code Element}, sesuai urutan kemunculannya dalam dokumen. |
getDocument() | Document | Mengambil dokumen XML yang berisi simpul {@code Element}. |
getName() | String | Mendapatkan nama lokal node Element . |
getNamespace() | Namespace | Mendapatkan namespace untuk node Element . |
getNamespace(prefix) | Namespace | Mendapatkan namespace dengan awalan yang diberikan untuk node Element . |
getParentElement() | Element | Mendapatkan node Element induk node. |
getQualifiedName() | String | Mendapatkan nama lokal dan awalan namespace dari node Element , dalam bentuk [namespacePrefix]:[localName] . |
getText() | String | Mendapatkan nilai teks node Element . |
getValue() | String | Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, sesuai urutan kemunculannya dalam dokumen. |
isAncestorOf(other) | Boolean | Menentukan apakah node Element ini merupakan induk langsung atau tidak langsung dari node Element tertentu. |
isRootElement() | Boolean | Menentukan apakah node Element adalah node root dokumen. |
removeAttribute(attribute) | Boolean | Menghapus atribut yang diberikan untuk node Element ini, jika atribut seperti itu ada. |
removeAttribute(attributeName) | Boolean | Menghapus atribut untuk node Element ini dengan nama yang diberikan dan tanpa namespace, jika
atribut tersebut ada. |
removeAttribute(attributeName, namespace) | Boolean | Menghapus atribut untuk node Element ini dengan nama dan namespace yang diberikan, jika
atribut tersebut ada. |
removeContent() | Content[] | Menghapus semua node yang merupakan turunan langsung dari node {@code Element}. |
removeContent(content) | Boolean | Menghapus simpul yang diberikan, jika simpul adalah turunan langsung dari simpul {@code Element}. |
removeContent(index) | Content | Menghapus node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung node {@code Element}. |
setAttribute(attribute) | Element | Menetapkan atribut yang diberikan untuk node Element ini. |
setAttribute(name, value) | Element | Menetapkan atribut untuk node Element ini dengan nama, nilai, dan namespace yang diberikan. |
setAttribute(name, value, namespace) | Element | Menetapkan atribut untuk node Element ini dengan nama, nilai, dan namespace yang diberikan. |
setName(name) | Element | Menetapkan nama lokal node Element . |
setNamespace(namespace) | Element | Menetapkan namespace untuk node Element . |
setText(text) | Element | Menetapkan nilai teks node Element . |
Dokumentasi mendetail
addContent(content)
Menambahkan node yang diberikan sebagai turunan terakhir dari node Element
. Argumen content
dapat berupa objek Element
atau objek node apa pun yang sesuai dengan jenis yang tercantum di ContentType
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
content | Content | node yang akan ditambahkan |
Return
Element
— node Element
, untuk perantaian
addContent(index, content)
Menyisipkan node yang diberikan pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari node Element
. Argumen content
dapat berupa objek Element
atau
objek node apa pun yang sesuai dengan jenis yang tercantum dalam ContentType
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
index | Integer | indeks untuk menyisipkan node di antara semua node yang merupakan turunan langsung dari node Element |
content | Content | {i>node<i} untuk menyisipkan |
Return
Element
— node Element
, untuk perantaian
cloneContent()
Membuat salinan yang tidak terpasang dari semua node yang merupakan turunan langsung dari node {@code Element}.
Return
Content[]
— array salinan yang tidak terpasang dari semua node yang merupakan turunan langsung node {@code Element}
detach()
getAllContent()
Mendapatkan semua node yang merupakan turunan langsung dari node {@code Element}.
Return
Content[]
— array dari semua node yang merupakan turunan langsung dari node {@code Element}
getAttribute(name)
Mendapatkan atribut untuk node Element
ini dengan nama yang diberikan dan tanpa namespace. Jika
tidak ada atribut seperti itu, metode ini akan menampilkan null
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama atribut |
Return
Attribute
— atribut, atau null
jika tidak ada atribut dengan nama yang diberikan dan tidak ada
namespace
getAttribute(name, namespace)
Mendapatkan atribut untuk node Element
ini dengan nama dan namespace yang diberikan. Jika tidak ada
node seperti itu, metode ini akan menampilkan null
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama atribut |
namespace | Namespace | namespace atribut |
Return
Attribute
— atribut, atau null
jika tidak ada atribut dengan nama dan namespace yang diberikan
getAttributes()
Mendapatkan semua atribut untuk node Element
ini, sesuai urutan kemunculannya dalam dokumen.
Return
Attribute[]
— array dari semua atribut untuk node Element
ini
getChild(name)
Mendapatkan node Element
pertama dengan nama yang diberikan dan tanpa namespace yang merupakan turunan langsung dari node Element
ini. Jika tidak ada node seperti itu, metode ini akan menampilkan null
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama node Element turunan |
Return
Element
— node Element
, atau null
jika tidak ada node Element
turunan langsung dengan nama yang diberikan dan tidak ada namespace
getChild(name, namespace)
Mendapatkan node Element
pertama dengan nama dan namespace yang diberikan yang merupakan turunan langsung dari node Element
ini. Jika tidak ada node seperti itu, metode ini akan menampilkan null
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama node Element turunan |
namespace | Namespace | namespace node Element turunan |
Return
Element
— node Element
, atau null
jika tidak ada node Element
turunan langsung dengan nama dan namespace yang diberikan
getChildText(name)
Mendapatkan nilai teks node dengan nama yang diberikan dan tanpa namespace, jika node tersebut adalah
turunan langsung dari node Element
. Jika tidak ada node seperti itu, metode ini akan menampilkan
null
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama node turunan |
Return
String
— nilai teks node turunan, atau null
jika tidak ada node turunan langsung dengan nama yang diberikan dan tidak ada namespace
getChildText(name, namespace)
Mendapatkan nilai teks node dengan nama dan namespace yang diberikan, jika node tersebut adalah turunan langsung dari node Element
. Jika tidak ada node seperti itu, metode ini akan menampilkan null
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama node turunan |
namespace | Namespace | namespace node turunan |
Return
String
— nilai teks node turunan, atau null
jika tidak ada node turunan langsung dengan nama dan namespace yang diberikan
getChildren()
Mendapatkan semua node Element
yang merupakan turunan langsung node Element
ini, sesuai
urutan kemunculannya dalam dokumen.
Return
Element[]
— array dari semua node Element
yang merupakan turunan langsung dari node Element
ini
getChildren(name)
Mendapatkan semua node Element
dengan nama yang diberikan dan tanpa namespace yang merupakan turunan langsung node Element
ini, sesuai urutan kemunculannya dalam dokumen.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama node Element turunan |
Return
Element[]
— array dari semua node Element
dengan nama yang diberikan dan tanpa namespace yang merupakan turunan langsung dari node Element
ini
getChildren(name, namespace)
Mendapatkan semua node Element
dengan nama dan namespace tertentu yang merupakan turunan langsung node Element
ini, sesuai urutan kemunculannya dalam dokumen.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama node Element turunan |
namespace | Namespace | namespace node Element turunan |
Return
Element[]
— array dari semua node Element
dengan nama dan namespace tertentu yang merupakan turunan langsung dari node Element
ini
getContent(index)
Mendapatkan node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung node {@code Element}. Jika tidak ada node pada indeks yang diberikan, metode ini akan menampilkan null
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
index | Integer | indeks untuk node di antara semua node yang merupakan turunan langsung node {@code Element} |
Return
Content
— node, atau null
jika tidak ada node pada indeks yang diberikan
getContentSize()
Mendapatkan jumlah node yang merupakan turunan langsung dari node {@code Element}.
Return
Integer
— jumlah node yang merupakan turunan langsung dari node {@code Element}
getDescendants()
Mendapatkan semua node yang merupakan turunan langsung atau tidak langsung dari node {@code Element}, sesuai urutan kemunculannya dalam dokumen.
Return
Content[]
— array dari semua node yang merupakan turunan langsung atau tidak langsung dari node {@code Element}
getDocument()
Mengambil dokumen XML yang berisi simpul {@code Element}.
Return
Document
— dokumen yang berisi node {@code Element}
getName()
Mendapatkan nama lokal node Element
. Jika node memiliki awalan namespace, gunakan getQualifiedName()
atau getNamespace()
.getPrefix()
untuk
mendapatkan awalan.
Return
String
— nama lokal node Element
getNamespace()
getNamespace(prefix)
Mendapatkan namespace dengan awalan yang diberikan untuk node Element
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
prefix | String | awalan untuk namespace |
Return
Namespace
— namespace dengan awalan yang diberikan untuk node Element
getParentElement()
getQualifiedName()
Mendapatkan nama lokal dan awalan namespace dari node Element
, dalam bentuk [namespacePrefix]:[localName]
. Jika node tidak memiliki awalan namespace, gunakan getName()
.
Return
String
— nama lokal dan awalan namespace dari node Element
, dalam bentuk [namespacePrefix]:[localName]
getText()
Mendapatkan nilai teks node Element
.
Return
String
— nilai teks node Element
getValue()
Mendapatkan nilai teks semua node yang merupakan turunan langsung atau tidak langsung dari node, sesuai urutan kemunculannya dalam dokumen.
Return
String
— nilai teks dari semua node yang merupakan turunan langsung atau tidak langsung dari node
isAncestorOf(other)
Menentukan apakah node Element
ini merupakan induk langsung atau tidak langsung dari node Element
tertentu.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
other | Element | node Element lainnya |
Return
Boolean
— true
jika node Element
ini adalah induk langsung atau tidak langsung dari node Element
yang ditentukan; false
jika bukan
isRootElement()
Menentukan apakah node Element
adalah node root dokumen.
Return
Boolean
— true
jika node Element
adalah node root dokumen; false
jika
bukan
removeAttribute(attribute)
Menghapus atribut yang diberikan untuk node Element
ini, jika atribut seperti itu ada.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
attribute | Attribute | atribut |
Return
Boolean
— true
jika atribut ada dan dihapus; false
jika tidak
removeAttribute(attributeName)
Menghapus atribut untuk node Element
ini dengan nama yang diberikan dan tanpa namespace, jika
atribut tersebut ada.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
attributeName | String | nama atribut |
Return
Boolean
— true
jika atribut ada dan dihapus; false
jika tidak
removeAttribute(attributeName, namespace)
Menghapus atribut untuk node Element
ini dengan nama dan namespace yang diberikan, jika
atribut tersebut ada.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
attributeName | String | nama atribut |
namespace | Namespace | namespace atribut |
Return
Boolean
— true
jika atribut ada dan dihapus; false
jika tidak
removeContent()
Menghapus semua node yang merupakan turunan langsung dari node {@code Element}.
Return
Content[]
— array dari semua node yang merupakan turunan langsung dari node {@code Element} sebelum dihapus
removeContent(content)
Menghapus simpul yang diberikan, jika simpul adalah turunan langsung dari simpul {@code Element}. Argumen content
dapat berupa objek Element
atau objek node apa pun yang sesuai dengan
jenis yang tercantum dalam ContentType
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
content | Content | {i>node<i} yang akan dihapus |
Return
Boolean
— true
jika node merupakan turunan langsung dan telah dihapus; false
jika bukan
removeContent(index)
Menghapus node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung node
{@code Element}. Jika tidak ada node pada indeks yang diberikan, metode ini akan menampilkan null
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
index | Integer | indeks untuk node di antara semua node yang merupakan turunan langsung node {@code Element} |
Return
Content
— node yang dihapus, atau null
jika tidak ada node pada indeks yang diberikan
setAttribute(attribute)
setAttribute(name, value)
Menetapkan atribut untuk node Element
ini dengan nama, nilai, dan namespace yang diberikan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama atribut untuk ditetapkan |
value | String | nilai atribut untuk ditetapkan |
Return
Element
— node Element
, untuk perantaian
setAttribute(name, value, namespace)
Menetapkan atribut untuk node Element
ini dengan nama, nilai, dan namespace yang diberikan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama atribut untuk ditetapkan |
value | String | nilai atribut untuk ditetapkan |
namespace | Namespace | ruang nama atribut untuk diatur |
Return
Element
— node Element
, untuk perantaian
setName(name)
Menetapkan nama lokal node Element
. Untuk menetapkan awalan namespace bagi node, gunakan
setNamespace(namespace)
bersama dengan XmlService.getNamespace(prefix, uri)
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
name | String | nama lokal untuk mengatur |
Return
Element
— node Element
, untuk perantaian
setNamespace(namespace)
setText(text)
Menetapkan nilai teks node Element
. Jika node sudah berisi nilai teks atau
node turunan, metode ini akan menimpa konten lama. Untuk menambahkan atau menyisipkan konten,
gunakan addContent(content)
atau addContent(index, content)
.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | teks untuk diatur |
Return
Element
— node Element
, untuk perantaian