Tags

app.activeDocument.selection[index].tags

Description

A collection of Tag objects.


Properties

Tags.length

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

Description

The number of elements in the collection.

Type

Number; read-only.


Tags.parent

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

Description

The object’s container.

Type

Object; read-only.


Tags.typename

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

Description

The class name of the referenced object.

Type

String; read-only.


Methods

Tags.add()

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

Description

Creates a new Tag object.

Returns

Tag


Tags.getByName()

app.activeDocument.selection[index].tags.getByName(name)

Description

Get the first element in the collection with the provided name.

Parameters

Parameter

Type

Description

name

String

Name of element to get

Returns

Tag


Tags.index()

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

Description

Gets an element from the collection.

Parameters

Parameter

Type

Description

itemKey

String, Number

String or number key

Returns

Tag


Tags.removeAll()

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

Description

Deletes all elements in this collection.

Returns

Nothing.


Example

Setting tag values

// Adds tags to all RasterItems and PlacedItems in the current document
if ( app.documents.length > 0 ) {
  var doc = app.activeDocument;

  if ( doc.placedItems.length + doc.rasterItems.length > 0 ) {
    for ( i = 0; i < doc.pageItems.length; i++ ) {
      var imageArt = doc.pageItems[i];

      if ( imageArt.typename == "PlacedItem" || imageArt.typename == "RasterItem") {
        // Create a new Tag with the name AdobeURL and the
        // value of the www link

        var urlTAG = imageArt.tags.add();
        urlTAG.name = "AdobeWebSite";
        urlTAG.value = "http://www.adobe.com/";
      }
    }
  } else {
    alert( "No placed or raster items in the document" );
  }
}