Halaman ini diterjemahkan oleh Cloud Translation API.

Class Element

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()`

Lepaskan node dari node Element induknya. Jika node tidak memiliki induk, metode ini tidak akan berpengaruh.

Return

Content — node yang terlepas

`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()`

Mendapatkan namespace untuk node Element.

Return

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

Return

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.

Return

Element — node induk Element

`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)`

Menetapkan atribut yang diberikan untuk node Element ini.

Parameter

Nama	Jenis	Deskripsi
`attribute`	`Attribute`	untuk mengatur

Return

Element — node Element, untuk perantaian

`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)`

Menetapkan namespace untuk node Element.

Parameter

Nama	Jenis	Deskripsi
`namespace`	`Namespace`	namespace untuk diatur

Return

Element — node Element, untuk perantaian

`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