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; } } }}