Class 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.
var xml = '<roster>'
    + '<person first="John" last="Doe"/>'
    + '<person first="Mary" last="Smith"/>'
    + '</roster>';
var document = XmlService.parse(xml);
var people = document.getRootElement().getChildren('person');
for (var i = 0; i < people.length; i++) {
  var person = people[i];
  var firstName = person.getAttribute('first').getValue();
  var lastName = person.getAttribute('last').getValue();
  person.setAttribute('full', firstName + ' ' + lastName);
}
xml = XmlService.getPrettyFormat().format(document);
Logger.log(xml);

Methods

Method	Return type	Brief description
`getName()`	`String`	Gets the local name of the attribute.
`getNamespace()`	`Namespace`	Gets the namespace for the attribute.
`getValue()`	`String`	Gets the value of the attribute.
`setName(name)`	`Attribute`	Sets the local name of the attribute.
`setNamespace(namespace)`	`Attribute`	Sets the namespace for the attribute.
`setValue(value)`	`Attribute`	Sets 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

Name	Type	Description
`name`	`String`	the 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

Name	Type	Description
`namespace`	`Namespace`	the namespace to set

Return

Attribute — the attribute, for chaining

`setValue(value)`

Sets the value of the attribute.

Parameters

Name	Type	Description
`value`	`String`	the value to set

Return

Attribute — the attribute, for chaining