Class Attribute

Attribute

A representation of an XML attribute.

// Reads the first and last name of each person and adds a new attribute with
// the full name.
let xml = '<roster>' +
    '<person first="John" last="Doe"/>' +
    '<person first="Mary" last="Smith"/>' +
    '</roster>';
const document = XmlService.parse(xml);
const people = document.getRootElement().getChildren('person');
for (let i = 0; i < people.length; i++) {
  const person = people[i];
  const firstName = person.getAttribute('first').getValue();
  const lastName = person.getAttribute('last').getValue();
  person.setAttribute('full', `${firstName} ${lastName}`);
}
xml = XmlService.getPrettyFormat().format(document);
Logger.log(xml);

Methods

MethodReturn typeBrief description
getName()StringGets the local name of the attribute.
getNamespace()NamespaceGets the namespace for the attribute.
getValue()StringGets the value of the attribute.
setName(name)AttributeSets the local name of the attribute.
setNamespace(namespace)AttributeSets the namespace for the attribute.
setValue(value)AttributeSets the value of the attribute.

Detailed documentation

getName()

Gets the local name of the attribute. If the attribute has a namespace prefix, use getNamespace().getPrefix() to get the prefix.

Return

String — the local name of the attribute


getNamespace()

Gets the namespace for the attribute.

Return

Namespace — the namespace for the attribute


getValue()

Gets the value of the attribute.

Return

String — the value of the attribute


setName(name)

Sets the local name of the attribute. To set a namespace prefix for the attribute, use setNamespace(namespace) in conjunction with XmlService.getNamespace(prefix, uri).

Parameters

NameTypeDescription
nameStringthe local name to set

Return

Attribute — the attribute, for chaining


setNamespace(namespace)

Sets the namespace for the attribute. The namespace must have a prefix.

Parameters

NameTypeDescription
namespaceNamespacethe namespace to set

Return

Attribute — the attribute, for chaining


setValue(value)

Sets the value of the attribute.

Parameters

NameTypeDescription
valueStringthe value to set

Return

Attribute — the attribute, for chaining