Tag

Tag

app.activeDocument.selection[index].tags[index]

Description

A label associated with a specific piece of artwork.

Tags allows you to assign an unlimited number of key-value pairs to any page item in a document.

---

Properties

Tag.name

app.activeDocument.selection[index].tags[index].name

Description

The tag’s name.

Type

String; read-only.

---

Tag.parent

app.activeDocument.selection[index].tags[index].parent

Description

The object that contains this tag.

Type

Object; read-only.

Tag.typename

app.activeDocument.selection[index].tags[index].typename

Description

The class name of the object.

Type

String; read-only.

---

Tag.value

app.activeDocument.selection[index].tags[index].value

Description

The data stored in this tag.

Type

String; read-only.

---

Methods

Tag.remove()

app.activeDocument.selection[index].tags[index].remove()

Description

Deletes this object.

Returns

Nothing.

Example

Using tags

// Finds the tags associated with the selected art item,
// show names and values in a separate document

if ( app.documents.length > 0 ) {
 doc = app.activeDocument;

 if ( doc.selection.length > 0 ) {
 for ( i = 0; i < selection.length; i++ ) {
 selectedArt = selection[0];
 tagList = selectedArt.tags;

 if (tagList.length == 0) {
 var tempTag = tagList.add();
 tempTag.name = "OneWord";
 tempTag.value = "anything you want";
 }

 // Create a document and add a line of text per tag
 reportDocument = app.documents.add();
 top_offset = 400;

 for ( i = 0; i < tagList.length; i++ ) {
 tagText = tagList[i].value;
 newItem = reportDocument.textFrames.add();
 newItem.contents = "Tag: (" + tagList[i].name + " , " + tagText + ")";
 newItem.position = Array(100, top_offset);
 newItem.textRange.size = 24;
 top_offset = top_offset - 20;
 }
 }
 }
}