Class Element

Elemen

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 ditentukan 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 tersebut Node Element.
cloneContent()	Content[]	Membuat salinan yang tidak dilampirkan dari semua node yang merupakan turunan langsung dari node {@code Element}.
detach()	Content	Melepaskan 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 tertentu 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 langsung turunan dari node Element ini.
getChild(name, namespace)	Element	Mendapatkan node Element pertama dengan nama dan namespace tertentu yang langsung turunan dari node Element ini.
getChildText(name)	String	Mendapatkan nilai teks node dengan nama yang diberikan dan tanpa namespace, jika node adalah turunan langsung dari node Element.
getChildText(name, namespace)	String	Mendapatkan nilai teks node dengan nama dan namespace yang diberikan, jika node tersebut adalah node turunan dari node Element.
getChildren()	Element[]	Mendapatkan semua node Element yang merupakan turunan langsung dari node Element ini, di sesuai urutan kemunculannya dalam dokumen.
getChildren(name)	Element[]	Mendapatkan semua node Element dengan nama tertentu dan tanpa namespace yang merupakan turunan langsung dari 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 dari 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 dari 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}, dalam urutannya muncul dalam dokumen.
getDocument()	Document	Mendapatkan dokumen XML yang berisi node {@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 dari node Element.
getValue()	String	Mendapatkan nilai teks dari semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan yang muncul dalam dokumen.
isAncestorOf(other)	Boolean	Menentukan apakah node Element ini adalah 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 tersebut ada.
removeAttribute(attributeName)	Boolean	Menghapus atribut untuk node Element ini yang memiliki nama tertentu dan tanpa namespace, jika atribut semacam itu ada.
removeAttribute(attributeName, namespace)	Boolean	Menghapus atribut untuk node Element ini yang berisi nama dan namespace yang diberikan, jika demikian terdapat sebuah atribut.
removeContent()	Content[]	Menghapus semua node yang merupakan turunan langsung dari node {@code Element}.
removeContent(content)	Boolean	Menghapus node yang diberikan, jika node adalah turunan langsung dari node {@code Element}.
removeContent(index)	Content	Menghapus node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari 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 tanpa 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 ditentukan sebagai turunan terakhir dari node Element. content dapat berupa objek Element atau objek node apa pun yang sesuai dengan jenis yang tercantum di ContentType.

Parameter

Nama	Jenis	Deskripsi
content	Content	untuk menambahkan

Pulang pergi

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 tersebut Node Element. Argumen content dapat berupa objek Element atau yang sesuai dengan jenis yang tercantum di ContentType.

Parameter

Nama	Jenis	Deskripsi
index	Integer	indeks tempat untuk menyisipkan node di antara semua node yang merupakan turunan langsung dari node Element
content	Content	node untuk menyisipkan

Pulang pergi

Element — node Element, untuk perantaian

---

cloneContent()

Membuat salinan yang tidak dilampirkan dari semua node yang merupakan turunan langsung dari node {@code Element}.

Pulang pergi

Content[] — array salinan tidak terlampir dari semua node yang merupakan turunan langsung dari Simpul {@code Element}

---

detach()

Melepaskan node dari node Element induknya. Jika {i>node<i} tidak memiliki induk, metode ini tidak berpengaruh.

Pulang pergi

Content — node yang dilepas

---

getAllContent()

Mendapatkan semua node yang merupakan turunan langsung dari node {@code Element}.

Pulang pergi

Content[] — array semua node yang merupakan turunan langsung dari node {@code Element}

---

getAttribute(name)

Mendapatkan atribut untuk node Element ini dengan nama tertentu dan tanpa namespace. Jika ada tidak ada atribut seperti itu, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
name	String	nama atribut

Pulang pergi

Attribute — atribut, atau null jika tidak ada atribut dengan nama yang diberikan dan tidak ada ruang nama

---

getAttribute(name, namespace)

Mendapatkan atribut untuk node Element ini dengan nama dan namespace yang diberikan. Jika ada tidak ada node tersebut, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
name	String	nama atribut
namespace	Namespace	namespace atribut

Pulang pergi

Attribute — atribut, atau null jika tidak ada atribut dengan nama yang diberikan dan ruang nama

---

getAttributes()

Mendapatkan semua atribut untuk node Element ini, sesuai urutan kemunculannya dalam dokumen.

Pulang pergi

Attribute[] — array semua atribut untuk node Element ini

---

getChild(name)

Mendapatkan node Element pertama dengan nama yang diberikan dan tanpa namespace yang langsung turunan dari node Element ini. Jika tidak ada node tersebut, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
name	String	nama node Element turunan

Pulang pergi

Element — node Element, atau null jika tidak ada node Element turunan langsung dengan nama tertentu dan tanpa namespace

---

getChild(name, namespace)

Mendapatkan node Element pertama dengan nama dan namespace tertentu yang langsung turunan dari node Element ini. Jika tidak ada node tersebut, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
name	String	nama node Element turunan
namespace	Namespace	namespace node Element turunan

Pulang pergi

Element — node Element, atau null jika tidak ada node Element turunan langsung dengan nama dan namespace tertentu

---

getChildText(name)

Mendapatkan nilai teks node dengan nama yang diberikan dan tanpa namespace, jika node adalah turunan langsung dari node Element. Jika tidak ada node tersebut, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
name	String	nama node turunan

Pulang pergi

String — nilai teks node turunan, atau null jika tidak ada node turunan langsung dengan nama tertentu dan tanpa namespace

---

getChildText(name, namespace)

Mendapatkan nilai teks node dengan nama dan namespace yang diberikan, jika node tersebut adalah node turunan dari node Element. Jika tidak ada node tersebut, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
name	String	nama node turunan
namespace	Namespace	namespace node turunan

Pulang pergi

String — nilai teks node turunan, atau null jika tidak ada node turunan langsung dengan nama depan dan namespace

---

getChildren()

Mendapatkan semua node Element yang merupakan turunan langsung dari node Element ini, di sesuai urutan kemunculannya dalam dokumen.

Pulang pergi

Element[] — array dari semua node Element yang merupakan turunan langsung dari node Element ini

---

getChildren(name)

Mendapatkan semua node Element dengan nama tertentu dan tanpa namespace yang merupakan turunan langsung dari node Element ini, sesuai urutan kemunculannya dalam dokumen.

Parameter

Nama	Jenis	Deskripsi
name	String	nama node Element turunan

Pulang pergi

Element[] — array dari semua node Element dengan nama tertentu dan tanpa namespace yang turunan langsung dari node Element ini

---

getChildren(name, namespace)

Mendapatkan semua node Element dengan nama dan namespace tertentu yang merupakan turunan langsung dari node Element ini, sesuai urutan kemunculannya dalam dokumen.

Parameter

Nama	Jenis	Deskripsi
name	String	nama node Element turunan
namespace	Namespace	namespace node Element turunan

Pulang pergi

Element[] — array semua node Element dengan nama tertentu dan namespace yang turunan langsung dari node Element ini

---

getContent(index)

Mendapatkan node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari node {@code Element}. Jika tidak ada node pada indeks yang diberikan, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
index	Integer	indeks untuk simpul di antara semua {i>node<i} yang merupakan turunan langsung dari Simpul {@code Element}

Pulang pergi

Content — node, atau null jika tidak ada node pada indeks yang diberikan

---

getContentSize()

Mendapatkan jumlah node yang merupakan turunan langsung dari node {@code Element}.

Pulang pergi

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}, dalam urutannya muncul dalam dokumen.

Pulang pergi

Content[] — array semua node yang merupakan turunan langsung atau tidak langsung dari node {@code Element}

---

getDocument()

Mendapatkan dokumen XML yang berisi node {@code Element}.

Pulang pergi

Document — dokumen yang berisi node {@code Element}

---

getName()

Mendapatkan nama lokal node Element. Jika node memiliki awalan namespace, gunakan getQualifiedName() atau getNamespace().getPrefix() hingga dapatkan awalannya.

Pulang pergi

String — nama lokal node Element

---

getNamespace()

Mendapatkan namespace untuk node Element.

Pulang pergi

Namespace — namespace untuk node Element

---

getNamespace(prefix)

Mendapatkan namespace dengan awalan yang diberikan untuk node Element.

Parameter

Nama	Jenis	Deskripsi
prefix	String	awalan untuk namespace

Pulang pergi

Namespace — namespace dengan awalan yang diberikan untuk node Element

---

getParentElement()

Mendapatkan node Element induk node. Jika node tidak memiliki induk, metode ini akan menampilkan null.

Pulang pergi

Element — node Element induk

---

getQualifiedName()

Mendapatkan nama lokal dan awalan namespace dari node Element, dalam bentuk [namespacePrefix]:[localName]. Jika node tidak memiliki awalan namespace, gunakan getName().

Pulang pergi

String — nama lokal dan awalan namespace dari node Element, dalam bentuk [namespacePrefix]:[localName]

---

getText()

Mendapatkan nilai teks dari node Element.

Pulang pergi

String — nilai teks dari node Element

---

getValue()

Mendapatkan nilai teks dari semua node yang merupakan turunan langsung atau tidak langsung dari node, dalam urutan yang muncul dalam dokumen.

Pulang pergi

String — nilai teks dari semua node yang merupakan turunan langsung atau tidak langsung dari node

---

isAncestorOf(other)

Menentukan apakah node Element ini adalah induk langsung atau tidak langsung dari node Element tertentu.

Parameter

Nama	Jenis	Deskripsi
other	Element	node Element lainnya

Pulang pergi

Boolean — true jika node Element ini merupakan induk langsung atau tidak langsung dari node yang ditentukan node Element; false jika tidak

---

isRootElement()

Menentukan apakah node Element adalah node root dokumen.

Pulang pergi

Boolean — true jika node Element adalah node root dokumen; false jika bukan

---

removeAttribute(attribute)

Menghapus atribut yang diberikan untuk node Element ini, jika atribut tersebut ada.

Parameter

Nama	Jenis	Deskripsi
attribute	Attribute	atribut

Pulang pergi

Boolean — true jika atribut ada dan telah dihapus; false jika tidak

---

removeAttribute(attributeName)

Menghapus atribut untuk node Element ini yang memiliki nama tertentu dan tanpa namespace, jika atribut semacam itu ada.

Parameter

Nama	Jenis	Deskripsi
attributeName	String	nama atribut

Pulang pergi

Boolean — true jika atribut ada dan telah dihapus; false jika tidak

---

removeAttribute(attributeName, namespace)

Menghapus atribut untuk node Element ini yang berisi nama dan namespace yang diberikan, jika demikian terdapat sebuah atribut.

Parameter

Nama	Jenis	Deskripsi
attributeName	String	nama atribut
namespace	Namespace	namespace atribut

Pulang pergi

Boolean — true jika atribut ada dan telah dihapus; false jika tidak

---

removeContent()

Menghapus semua node yang merupakan turunan langsung dari node {@code Element}.

Pulang pergi

Content[] — array semua node yang merupakan turunan langsung dari node {@code Element} sebelum node tersebut telah dihapus

---

removeContent(content)

Menghapus node yang diberikan, jika node adalah turunan langsung dari node {@code 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	{i>node<i} untuk menghapus

Pulang pergi

Boolean — true jika node adalah turunan langsung dan telah dihapus; false jika tidak

---

removeContent(index)

Menghapus node pada indeks yang diberikan di antara semua node yang merupakan turunan langsung dari node {@code Element}. Jika tidak ada node pada indeks yang diberikan, metode ini akan menampilkan null.

Parameter

Nama	Jenis	Deskripsi
index	Integer	indeks untuk simpul di antara semua {i>node<i} yang merupakan turunan langsung dari Simpul {@code Element}

Pulang pergi

Content — node yang dihapus, atau null jika tidak ada node pada indeks yang diberikan

---

setAttribute(attribute)

Menetapkan atribut yang diberikan untuk node Element ini.

Parameter

Nama	Jenis	Deskripsi
attribute	Attribute	atribut yang akan diatur

Pulang pergi

Element — node Element, untuk perantaian

---

setAttribute(name, value)

Menetapkan atribut untuk node Element ini dengan nama, nilai, dan tanpa namespace yang diberikan.

Parameter

Nama	Jenis	Deskripsi
name	String	nama atribut yang akan ditetapkan
value	String	nilai atribut yang akan ditetapkan

Pulang pergi

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 yang akan ditetapkan
value	String	nilai atribut yang akan ditetapkan
namespace	Namespace	namespace atribut yang akan ditentukan

Pulang pergi

Element — node Element, untuk perantaian

---

setName(name)

Menetapkan nama lokal node Element. Untuk menetapkan awalan namespace untuk node, gunakan setNamespace(namespace) bersama dengan XmlService.getNamespace(prefix, uri).

Parameter

Nama	Jenis	Deskripsi
name	String	nama lokal untuk mengatur

Pulang pergi

Element — node Element, untuk perantaian

---

setNamespace(namespace)

Menetapkan namespace untuk node Element.

Parameter

Nama	Jenis	Deskripsi
namespace	Namespace	namespace untuk mengatur

Pulang pergi

Element — node Element, untuk perantaian

---

setText(text)

Menetapkan nilai teks node Element. Jika {i>node<i} 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	untuk mengatur teks

Pulang pergi

Element — node Element, untuk perantaian