You wanna see something cool?
Did you catch that? If not, take a good look at the red and green columns. Notice something different about them? How about something a bit more practical.
See it there? Are you excited yet, because I know I am!
Yesterday morning I had a bit of a brainstorm. Working on a new project, I was asked by a designer who didn’t have any responsive web design experience if he could have a fixed width sidebar and a fluid, flexible column to fill the rest of the space. I told him he’d need to wait until flexbox in order to have it; he didn’t understand what that meant. I though in the back of my mind “well, maybe with calc you could pull something off”, but I let that though go quickly because, well, it was stupid. Oh but how the unconscious works! I was awoken yesterday morning at 5am to my brain yelling at me “SAM! YOU’VE ALREADY DONE ALL OF THE MATH! JUST PRINT IT OUT AS A STRING!” To which, I replied “Brain, shut up. It’s too early to mess with calc for the first time.” My brain didn’t listen. After taking a quick trip to Can I Use, I was amazed by the fact that, for the most part (and certainly for this project’s support level), not only could I reliably use
calc, but I could use it unprefixed! After reading that, my brain wouldn’t let me go back to sleep.
In order to get the calculations right, I had to do a bit of math. I like math, but this was annoying math because the only way I’m able to check the results is by rendering everything in browser; no way to check my work as I went. With a bit of work, I came up with the following (somewhat) simple formula for determining the width of a single fluid item in a mixed fixed/fluid column pattern:
It’s fairly straight forward; take the whole width, subtract the fixed parts, divide into equal sized columns, multiply by column width. Sure, fair enough. But then, what happens if you want to span multiple fluid columns? Well you get a formula that looks something like this:
Fair enough, math, it’s complex. Did I mention yet that that’s the string that needs to get printed out? What about a mixture of fixed and fluid columns?
Okay, that’s getting unwieldy. But it’s not over! We want to be able to use isolation output’s source order independent ordering, so we need to calculate margins too! Simple enough, the width of each column preceding the one we’re on plus a gutter a piece, but remember the formula for fluid width items! To give you an idea of what that’d look like (and it’s calculated width), here’s the margin property for the blue item in the first video (the initial
0.5em is because we’re using split gutters).
Yah, long story short, this is stupid and you shouldn’t ever use this method; at least not without a CSS Preprocessor
I love Singularity and I’m really proud of 1.2.0’s output plugin system. Scott and I have always envisioned Singularity as a base API for working with grids, something that can be extended in ways unimaginable. So, I decided to write an Output Plugin for Singularity called
calc. Because we’re not ready to support it fully yet, it’s living in Singularity Extras now as of version 1.0.0.alpha.1. Using it is easy, just download (either add that version to your Gemfile, or download the files directly to your project) and import
singularity-extras/outputs. Then, you’re ready to use!
calc grids are some restrictions placed on them that
isolation grids don’t. First, they must be asymmetric grids, meaning you must define the width of each column. You can mix any units you want as long as they are compatible with
calc (as of this writing, for instance,
rem units aren’t for some reason). If you want to define parts of the remaining fluid area, you do so with unit less numbers just like you would when normally using Singularity. The other change is that
calc grids only work with fixed width gutters (gutters with defined units, including
% if you so choose) as the alternative would be having the gutter widths being defined by the remaining fluid area, which is quite hard to grok and doesn’t make much sense to me. Mix units all you want,
calc will take care of it (at least in all of my tests). Otherwise,
calc behaves more or less identical to
isolation. To give you an idea of what this looks like, here’s the grid definition for the first video:
Here’s the HTML and the Sass for the second video:
I hope you enjoy doing some awesome and crazy things with this. Enjoy!