Group & Ungroup

The group and ungroup methods, group and ungroup tagged objects in the same way that Illustrator's UI groups and ungroups a selection.

Currently the header's property cells cannot be left blank, so if you have set the tagSearch by using the top row of the spreadsheet's header and have not set other properties, set the property to *, skip or tagSearch. This will prevent an error being flagged on the property cell, you can leave the filler property's values blank.

To prevent the method being applied to a row, inside the method, use either the generic * property and set the cell value to false or the generic skip property and set the cell value to true.

To apply tags to the newly grouped item, use the tags property and provide a list of tags.

Example Spreadsheet


cat \| dog \| mouse	*
group	ungroup		comment
*	tagSearch: trees	skip	*

	`trees`		Both group and ungroup will be applied
FALSE	`trees`		group will be skipped, group's `*` property is set to `false`
	`trees`	TRUE	ungroup will be skipped, ungroup's `skip` property is set to `true`
	""		ungroup will be skipped, ungroup's `tagSearch` property is set to `""`
TRUE	`trees`	FALSE	Both group and ungroup will be applied

Group and Ungroup Properties

Mode	Description
tagSearch	The tag search of the items to group or ungroup Example Values: `cat \| dog \| mouse`, `trees`
*	Set to `false` if you want the method to be skipped in a particular row. Valid Values: `true` or `false`
skip	Set to `true` is you want the method to be skipped in a particular row. See * and Skip for details. Valid Values: `true` or `false`
tags for group method only	A list of tags to apply to the newly grouped object. Example Values: `animals, pets`, `creatures`