search

PEZ / SketchDistributor

Sketch plugin that distributes selected objects vertically or horizontally with a given spacing
MIT License
354 stars 26 forks source link

readme

SketchDistributor

GitHub release

A Sketch plugin that distributes selected objects vertically or horizontally with a specified spacing between objects edges or centers (as the formerly available "boxed" setting in Sketch Grid).

Like so:

Distributor in action

Installation

Install Distributor with Sketchpacks

Or if you use Runner, it can install this plugin as well.

Or, do it manually:

  1. Download this zip archive
  2. Unzip
  3. Double-click the .sketchplugin package.

How-to

You select the objects you want to distribute, then ask Distributor to do it:

  1. Distribute Horizontally … (CTRL+OPTION+H), brings up the Distributor dialog box with horizontal distribution preselected. You specify spacing (in pixels).
  2. Distribute Vertically … CTRL+OPTION+V, same as above for vertical distribution.
  3. Distribute again (CTRL+OPTION+A) applies the last used distribution settings on the selected objects.
  4. Distribute … (CTRL+OPTION+D), same dialog box as above, remembering the last distribution direction. (Mostly here for legacy reasons.)

The distribution depicted above you get by typing CTRL+OPTION+V, 10, ⮐. Your fingers can stay on the keyboard.

Note that you can use negative spacing to get overlap:

Tabs distributed -14px

(CTRL+OPTION+H, -14, ⮐)

It Works with Runner

If you are using the amazing Runner plugin you can also access the Distributor commands from there:

Runner Screenshot

Runner Badge

Bugs / Comments / Questions / Suggestions

Is the plugin misbehaving? File an issue. Have a suggestion? File an issue. You can pretty much file an issue for whatever reason. Please include the version of the plugin you are using if you think it could be relevant (it most often is). There is also Twitter @PappaPEZ

Known Issues

The plugin can't help with distributing rotated layers correctly. See issue #10. Also some shapes have a strange bounding rectangle according to Sketch. That makes them distribute less perfectly especially in vertical direction. Hoping for the Sketch API to soon make it possible to handle both these cases.

Sketch Community Attention

This little plugin is surprisingly often present in various Top X Sketch Productivity plugins articles. Too many to list here, but here are a few that got me smiling and almost bursting: