├── Fitter.sketchplugin
    └── Contents
    │   └── Sketch
    │       ├── fitter.js
    │       └── manifest.json
├── README.md
└── screenshots
    ├── menu.png
    └── screenshots.sketch


/Fitter.sketchplugin/Contents/Sketch/fitter.js:
--------------------------------------------------------------------------------
  1 | // COMMANDS
  2 | function fitToArtboard(context) {
  3 |   fitterProcessor(context, 0, 1, 1)
  4 | };
  5 | function fitToArtboardWidth(context) {
  6 |   fitterProcessor(context, 0, 1, null)
  7 | };
  8 | function fitToArtboardHeight(context) {
  9 |   fitterProcessor(context, 0, null, 1)
 10 | };
 11 | function fitToArtboardMargin(context) {
 12 |   var doc = context.document
 13 |   var margin = [[doc askForUserInput:"Margin" ofType:1 initialValue:"16"] integerValue];
 14 |   fitterProcessor(context, margin, 1, 1)
 15 | }
 16 | function fitToArtboardWidthMargin(context) {
 17 |   var doc = context.document
 18 |   var margin = [[doc askForUserInput:"Margin" ofType:1 initialValue:"16"] integerValue];
 19 |   fitterProcessor(context, margin, 1, null)
 20 | }
 21 | function fitToArtboardHeightMargin(context) {
 22 |   var doc = context.document
 23 |   var margin = [[doc askForUserInput:"Margin" ofType:1 initialValue:"16"] integerValue];
 24 |   fitterProcessor(context, margin, null, 1)
 25 | }
 26 | function fitToWidest(context) {
 27 |   var doc = context.document
 28 |   var selection = context.selection
 29 |   var selectionCount = selection.count()
 30 | 
 31 |   if (selectionCount == 0) {
 32 |     doc.showMessage("Please select at least two layers/artboards.")
 33 |     return
 34 |   } 
 35 |   
 36 |   var widestLayerWidth = selection[0].frame().width()
 37 | 
 38 |   for (i=0;i<selectionCount;i++){
 39 |       var layer = selection[i]
 40 |       var layerWidth = layer.frame().width()
 41 | 
 42 |       if (layerWidth > widestLayerWidth){
 43 |         widestLayerWidth = layerWidth
 44 |         var widestLayer = layer
 45 |       }
 46 |   }
 47 |   var newWidth = widestLayerWidth
 48 | 
 49 |   for (i=0;i<selectionCount;i++){
 50 |       var layer = selection[i]
 51 |       layer.frame().setWidth(newWidth)
 52 |   }
 53 | }
 54 | function fitToTallest(context) {
 55 |   var doc = context.document
 56 |   var selection = context.selection
 57 |   var selectionCount = selection.count()
 58 | 
 59 |   if (selectionCount == 0) {
 60 |     doc.showMessage("Please select at least two layers/artboards.")
 61 |     return
 62 |   } 
 63 |   
 64 |   var tallestLayerHeight = selection[0].frame().height()
 65 | 
 66 |   for (i=0;i<selectionCount;i++){
 67 |       var layer = selection[i]
 68 |       var layerHeight = layer.frame().height()
 69 | 
 70 |       if (layerHeight > tallestLayerHeight){
 71 |         tallestLayerHeight = layerHeight
 72 |         var tallestLayer = layer
 73 |       }
 74 |   }
 75 |   var newHeight = tallestLayerHeight
 76 | 
 77 |   for (i=0;i<selectionCount;i++){
 78 |       var layer = selection[i]
 79 |       layer.frame().setHeight(newHeight)
 80 |   }
 81 | }
 82 | 
 83 | 
 84 | // PROCESSOR
 85 | function fitterProcessor(context, margin, fitHorizontally, fitVertically, fitWidest, fitTallest) {
 86 |   var doc = context.document
 87 |   var selection = context.selection
 88 |   var selectionCount = selection.count()
 89 | 
 90 |   if (selectionCount == 0) {
 91 |     doc.showMessage("Please select a layer.")
 92 |     return
 93 |   } 
 94 | 
 95 |   for (i=0;i<=selectionCount;i++){
 96 |       var layer = selection[i]
 97 | 
 98 |       if ([layer class] != "MSArtboardGroup") {
 99 | 
100 |         var layerParentGroup = [layer parentGroup];
101 | 
102 |         // Ensures the layer scales to the parent artboard
103 |         while (layerParentGroup){
104 |           if ([layerParentGroup class] == "MSArtboardGroup"){
105 |             artboardToSelect = layerParentGroup;
106 |             break;
107 |           }
108 |           // If layer is nested in any groups we must reset the position of the parent because child position is relative
109 |           if ([layerParentGroup class] == "MSLayerGroup"){
110 |             if (fitVertically){ var layerGroupY = layerParentGroup.frame().setY(0) }
111 |             if (fitHorizontally){ var layerGroupX = layerParentGroup.frame().setX(0) }
112 |           }
113 |           layerParentGroup = [layerParentGroup parentGroup];
114 |         }
115 |         var artboard = layerParentGroup
116 | 
117 |         if (fitHorizontally){
118 |           var newX = margin
119 |           var newWidth = artboard.frame().width() - margin*2
120 |           layer.frame().setX(newX)
121 |           layer.frame().setWidth(newWidth)
122 |         }
123 | 
124 |         if (fitVertically){
125 |           var newY = margin
126 |           var newHeight = artboard.frame().height() - margin*2
127 |           layer.frame().setY(newY)
128 |           layer.frame().setHeight(newHeight)
129 |         }
130 | 
131 |       }
132 | 
133 |     }
134 | 
135 | };
136 | 


--------------------------------------------------------------------------------
/Fitter.sketchplugin/Contents/Sketch/manifest.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "Fitter",
 3 |   "description": "Resizes the selected layer to cover its containing artboard",
 4 |   "author": "Peter Berrecloth",
 5 |   "authorEmail": "peterberrecloth@gmail.com",
 6 |   "homepage": "https://github.com/pberrecloth/fitter-sketch-plugin",
 7 |   "version": 1.0,
 8 |   "bundleVersion": 1.0,
 9 |   "compatibleVersion": 41,
10 |   "identifier": "com.fitter.sketchplugin",
11 |   "commands": [
12 |     {
13 |       "name": "Fit To Artboard Width",
14 |       "script": "fitter.js",
15 |       "handler": "fitToArtboardWidth",
16 |       "identifier": "fitToArtboardWidth"
17 |     },
18 |     {
19 |       "name": "Fit To Artboard Height",
20 |       "script": "fitter.js",
21 |       "handler": "fitToArtboardHeight",
22 |       "identifier": "fitToArtboardHeight"
23 |     },
24 |     {
25 |       "name": "Fit To Artboard",
26 |       "script": "fitter.js",
27 |       "handler": "fitToArtboard",
28 |       "identifier": "fitToArtboard"
29 |     },
30 |     {
31 |       "name": "Fit To Artboard Margin...",
32 |       "script": "fitter.js",
33 |       "handler": "fitToArtboardMargin",
34 |       "identifier": "fitToArtboardMargin"
35 |     },
36 |     {
37 |       "name": "Fit To Artboard Height Margin...",
38 |       "script": "fitter.js",
39 |       "handler": "fitToArtboardHeightMargin",
40 |       "identifier": "fitToArtboardHeightMargin"
41 |     },
42 |     {
43 |       "name": "Fit To Artboard Width Margin...",
44 |       "script": "fitter.js",
45 |       "handler": "fitToArtboardWidthMargin",
46 |       "identifier": "fitToArtboardWidthMargin"
47 |     },  
48 |     {
49 |       "name": "Fit To Widest",
50 |       "script": "fitter.js",
51 |       "handler": "fitToWidest",
52 |       "identifier": "fitToWidest"
53 |     },
54 |     {
55 |       "name": "Fit To Tallest",
56 |       "script": "fitter.js",
57 |       "handler": "fitToTallest",
58 |       "identifier": "fitToTallest"
59 |     }
60 |   ],
61 |   "menu" : {
62 |     "isRoot" : true,
63 |     "items" : [
64 |       {
65 |         "title" : "Fitter",
66 |         "items" : [
67 |           "fitToArtboard",
68 |           "fitToArtboardWidth",
69 |           "fitToArtboardHeight",
70 |           "-",
71 |           "fitToArtboardMargin",
72 |           "fitToArtboardWidthMargin",
73 |           "fitToArtboardHeightMargin",
74 |           "-",
75 |           "fitToWidest",
76 |           "fitToTallest"
77 |          ]
78 |       }
79 |     ]
80 |   }
81 | }
82 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Fitter Sketch Plugin
 2 | 
 3 | Fits layers to parent artboard width, height or both, with the optional ability to add a margin.
 4 | 
 5 | 
 6 | **Commands**
 7 | 
 8 | ![Example](screenshots/menu.png?raw=true "Example")
 9 | 
10 | 
11 | ## Keyboard Shortcuts
12 | 
13 | Especially useful when assigned to a keyboard shortcut. You must do this yourself under _Apple > Preferences > Keyboard > Shortcuts_. [How to set up Keyboard Shortcuts](http://www.sketchtips.info/articles/custom-shortcuts).
14 | 
15 | 
16 | ## Installation
17 | 
18 | [Install from Sketch Toolbox](http://sketchtoolbox.com/)
19 | 


--------------------------------------------------------------------------------
/screenshots/menu.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/pberrecloth/fitter-sketch-plugin/66a45b8c4e2d8750033817aae5fb7410e4f5888d/screenshots/menu.png


--------------------------------------------------------------------------------
/screenshots/screenshots.sketch:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/pberrecloth/fitter-sketch-plugin/66a45b8c4e2d8750033817aae5fb7410e4f5888d/screenshots/screenshots.sketch


--------------------------------------------------------------------------------