Fit To Bounds
The fitToBounds method is used for fitting the bounds of artboards to artwork items and optionally applying a padding from the artworkItems.
By default artwork items currently on the artboards are used to define the artboard bounds.
To include artwork which is currently not in the artboards bounds, set the artboardItems property to false.
Set a tagSearch to limit the artwork to be considered.
Set a layerName or layerNumber to limit the artwork to be considered to a given layer.
Set a list of artboardNames or artboardNumbers to specify the artboards whose bounds should be adjusted.
If no artboards are specified, the bounds of all of the artboards will be adjusted.
To set equal padding for all sides of the artboards use the padding property.
If no padding is set, the artboard will adjust to the visual bounds of the artwork.
Use the left, right, top and bottom properties if you want to set different padding for the different sides of the artboards.
Sample Spreadsheet and Screenshots
| * | ||||||||
| fitToBounds | ||||||||
| artboardNumbers | fromArtboardItems | tagSearch | padding: 5 | layerNumber | paddingLeft | paddingRight | paddingTop | paddingBottom |
5 | ||||||||
| 1, 2 | 5 | |||||||
| 1, 2 | FALSE | 5 | ||||||
| circle | 5 | |||||||
| circle | : | 2 | 10 | 20 | 30 | 40 |
Compare each row in the spreadsheet below with its associated screenshot below.
Original Artboards
Row - 1
Only the padding property has been set, ALL the artboards will resize to pad 5pt from all artwork currently on them.
Row - 2padding: 5 artboardNumbers: 1, 2 Only the bounds of artboards 1 and 2 will be adjusted
Row - 3fromArtboardItems: false artboardNumbers: 1, 2 padding: 5 The bounds of artboards 1 and 2 will be adjusted to pad all the artwork in the document by 5pt.
Row - 4padding: 5 tagSearch: circle The bounds of all the artboards will be adjusted to artwork tagged circle which is in their bounds.
Row - 5tagSearch: circle layerNumber: 2 paddingLeft: 10 paddingRight: 20 paddingTop: 30 paddingBottom: 40 The bounds of all the artboards will be adjusted to artwork tagged circle in layer 2 which is in their bounds.
Method Properties and Screenshot
See Basic Stroke and Fill Properties
| Mode | Description |
|---|---|
* | Set to false if you want the method to be skipped in a particular row. Valid Values: true or false |
artboardItems /fromArtboardItems | Whether artboards bounds should be adjusted only to items currently in their bounds Valid Values: true [Default] or false |
artboardNames | A list of artboard names of the artboards to be adjusted. Either use artboardNames or artboardNumbers and not both. If no artboard names or numbers are provided, the bounds of all artboards will be adjusted Sample Values: Artboard 1, Artboard 2, Artboard 3 |
artboardNumbers | A list of artboard numbers of the artboards to be adjusted. Either use artboardNames or artboardNumbers and not both. If no artboard names or numbers are provided, the bounds of all artboards will be adjusted Sample Values: 1, 2, 3 |
layerName | Specify a layer name if you want to limit the artwork that the artboard bounds should be adjusted to to a specific layer Sample Values: Layer 1, Layer 2, Layer 3 |
layerNumber | Specify a layer number if you want to limit the artwork that the artboard bounds should be adjusted to to a specific layer Sample Values: 1, 2, 3 |
padding | The padding from artwork, (can be used when padding on all sides is equal) Sample Values: 36, 36pt, .5", 12.6mm |
paddingBottom /bottom | Bottom padding from artwork Sample Values: 36, 36pt, .5", 12.6mm |
paddingLeft /left | Left padding from artwork Sample Values: 36, 36pt, .5", 12.6mm |
paddingRight /right | Right padding from artwork Sample Values: 36, 36pt, .5", 12.6mm |
paddingTop /top | Top padding from artwork Sample Values: 36, 36pt, .5", 12.6mm |
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 |
tagSearch | Specify a tagSearch if you want to limit the artwork that the artboard bounds should be adjusted to specific artwork items Sample Values: cats, cats | dogs, animals & !dogs |