Tags Methods
Darty provides methods for copying information between Darty Tags and Illustrator object names, as well as methods for selecting, setting, and removing tags.
The Tags Tool currently creates three of these methods: tagsToName, nameToTags, and removeTags. See the Tags Tool guide for the visual editors and workflows.
tagsToName
This method writes an object's Darty tags into its Illustrator object name. Multiple tags become a comma-separated name.
| Property | Description |
|---|---|
tagSearch | Identifies the artwork whose names should be updated. |
selected | When true, restricts the operation to the Illustrator selection at run time. |
applyToContents | When true, allows the operation to continue into contained artwork. |
skip | When true, skips the method for the row. See * and Skip. |
The method does not require an additional conversion-value property. A row without one of these optional property cells can therefore be valid.
nameToTags
This method turns an Illustrator object name into Darty tags. Commas in the object name separate multiple tags.
| Property | Description |
|---|---|
tagSearch | Identifies the named artwork to process. |
selected | When true, restricts the operation to the Illustrator selection at run time. |
replaceTags | When true, replaces the object's existing Darty tags instead of preserving them alongside the converted name. |
applyToContents | When true, allows the operation to continue into contained artwork. |
skip | When true, skips the method for the row. See * and Skip. |
Like tagsToName, this method can be valid without an additional conversion-value property.
removeTags
This method removes Darty tags from artwork without deleting the Illustrator objects. It requires either a tags list or all: true.
| Property | Description |
|---|---|
tagSearch | Identifies the artwork whose tags should be removed. |
tags | A comma-separated list of the specific tags to remove. |
all | Set to true to remove every Darty tag from the matched artwork. |
applyToContents | When true, allows tag removal to continue into contained artwork. |
skip | When true, skips the method for the row. See * and Skip. |
Removing a tag can prevent later methods from finding the same artwork. Run any tag-dependent operations before removeTags, unless the loss of that target is intentional.
Other Tag Methods
The broader method system also includes:
setTagsremoveTagsSelectedselectByTags
These are not separate modes in the current Tools → Methods → Tags editor.