Skip to content

Latest commit

 

History

History
156 lines (87 loc) · 7.73 KB

README.md

File metadata and controls

156 lines (87 loc) · 7.73 KB

⚠️ This project is no longer actively maintained.

While some functionality of this plugin may continue to work for the forseeable future, there is no guarantee that it will survive any breaking changes made by the Sketch team. If you're looking for potential alternatives to Fluid plugin, look here.


💧 Fluid for Sketch 1.7.6

A collaborative project brought to you by Matt Curtis & Cat Noone

Fluid is a Sketch plugin that provides a means to create more constraint-based, responsive designs. It is based on Auto Layout constraints.

📦 Download Plugin (.zip) Changelog ⬇️ Download the Demo Sketch Document

Installation

Using Sketchpacks

Install Fluid for Sketch with Sketchpacks

Using Sketch Runner

With Sketch Runner, just go to the install command and search for Fluid. Runner allows you to manage plugins and do much more to speed up your workflow in Sketch. Download Runner here.

Install with Sketch Runner

Using Sketch Plugin Manager

Installation via Sketch Plugin Manager:

  1. In the 'Catalog' tab, click in the 'Search' field and type 'Fluid', to filter the list
  2. You will see the 'Fluid for Sketch' plugin listed. Click the 'Install' button.

Using Sketch Toolbox

⚠️ Sketch Toolbox is no longer officially supported due to a lack of updates and several bugs. If you usually use Sketch Toolbox, please install manually or through another plugin manager.

Manually

  1. Download the .zip above and extract it.
  2. Double-click Fluid.sketchplugin.
  3. ???
  4. Profit!!!

Updating

  1. After updating Fluid (whether manually or via other manager) restart Sketch to receive goodness.

Features

  • Pin, Offset, Center, and Size relative to Parent Group, Parent Artboard, or Previous Sibling Layer
  • Utilize simple mathematic expressions as values, such as 50% - 10
  • Quickly resize artboards and update their layout
  • Preview, export and copy artboards at different sizes in Preview Mode
  • Constraints are stored directly on a layer, so no worries with layer names

Usage

First and foremost, we recommend downloading the example Sketch document included in this repo (linked to it above). There are several examples included there. Examining the constraints used and playing around with the different options (i.e. Changing constraints, re-sizing artboards and pressing Update Layout) makes things clearer.

There are 5 primary actions: Show/Hide Toolbar, Update Layout, Edit Constraints, Preview, and Toggle Size. All of the features the plugin provides are available via Plugins > Fluid.

Show/Hide Toolbar (⌃ + ⇧ + T)

For convenience, the plugin provides a toolbar that floats above the current document, giving you quick access to all of the above actions.

Toolbar

Edit Constraints (⌃ + ⇧ + C)

Constraint Inspector

This option shows the Constraint Inspector. Here you can edit all of the constraints for the currently selected layer.

Next to each section (Align, Fixed Size and Pinning) is a dropdown button. Pressing it opens a menu where you can set relativity:

Constraint Inspector Relativity

Update Layout (⌃ + ⇧ + L)

Adjusts the layers in the currently selected artboards to reflect your constraints.

Pressing L while the Constraint Inspector is focused will also Update Layout.

Preview (⌃ + ⇧ + P)

Preview Mode

Opens a window allowing you to preview the selected artboard at a range of preset device and icon sizes. You can also copy the preview artboard to paste into Sketch (Didn't have a mobile design? Now you do!), or export an image of the preview artboard at different scales (@1x, @2x, @3x, and so on).

Toggle Sizes (⌃ + ⇧ + S)

Toggle Sizes

Opens a popup where you can toggle the size of the current artboard between different presets, or flip its orientation.

Additional Notes

Fade UI

You can have Fluid fade its floating UI (Inspector & Toolbar) when they are not focused. See Plugins > Fluid > Settings.

Width & Height

If you have Fixed Width or Fixed Height checked, and leave the value blank, the plugin will lock the width or height to whatever the current height or width is in Sketch. This is useful in some cases where you want to ensure the height and width do not change, but don't want to enter the existing height/width manually.

Groups

Since the width and height of Groups in Sketch are dependent on their sub-layers, Fluid does not actually resize the height or width of a group, as that causes Sketch to distort the layers within it. Rather, it simulates that sizing when calculating the geometry of sub-layers.

Symbols

It's worth noting that while constraints you set on a Symbol itself will not propagate to other instances of that Symbol, any constraints you set on its sub-layers will.

Text

If you set the width of a text layer but not its height, the plugin will set the height of the text layer to the height of the text after reflow.

This feature was available in former versions of Fluid, but has been removed in 1.7.4. See this issue for more info. Restored in Fluid 1.7.5! 🎉

Mathematic Values

All of the values in Fluid support mathematic expressions, such as 20 * 2 or (50 / 2) + 10 and so on. This becomes even more useful when you add percentages to the mix.

Percentages are relative to the dimension of the axis they're on. Here's how that shakes out:

  • Using 100% as your fixed width equals 100% of the relative layer's width
  • Using 100% as your fixed height equals 100% of the relative layer's height
  • Using 100% in the top or bottom pinnings equals 100% of the relative layer's height
  • Using 100% in the right or left pinnings equals 100% of the relative layer's width

One neat application of this is that it enables padding between sibling layers, e.g:

  • Parent Group or Artboard
    • Layer B (top pinning = 100% + 20, relativity = Previous Sibling (Layer A))
    • Layer A

Text Field Tricks n' Tips

  • Numbers in the Constraint Inspector text fields can be incremented or deincrement by 1 by pressing the up and down keys. Holding down Shift (⇧) and Up or Down will increment by 10.
  • Pressing space while a text field is focused will toggle that constraint's checkbox.

Preset Sizes

You can search through the section names of the preset sizes list (in both Preview Mode and when toggling sizes) by prefixing your searches with s:, i.e.: s:iOS or s:Material. Normally Fluid only searches among the preset names themselves.

Contact

If you have any questions, comments, become attacked by technical bugs, or have ideas to improve the plugin, ping us on twitter: @matt_sven and @imcatnoone.