/postcss-positioning

Make CSS positioning ridiculously simple

Primary LanguageJavaScriptMIT LicenseMIT

npm Build Status

Rethinking CSS positioning with PostCSS.

Why?

Positioning in CSS is painful.

Forget about display, position, margin, padding, absolute space, and all the complicated flexbox properties.

Now think about it as spacing. You have an element. It has a size. And you've got some space before, and some space after it. With postcss-positioning, all you need is two properties, horizontal and vertical.

Examples

Center an element

centered element

.child {
  horizontal: 1s 200px 1s;
  vertical: 1s 200px 1s;
}

Take up two thirds of the space on the right

element taking up two thirds of its container to the right

.element {
  horizontal: 1s 2s 0;
  vertical: 0 1s 0;
}

How it works

.element {
  horizontal: right width left;
  vertical: top height bottom;
}

The values specify space before, size, and space after on both axes. Remaining space is distributed between stretch lengths (ending with s). Read the documentation to learn about elements with non-absolute positioning.

A CSS reset is performed by default, so user agents won't interfere with the positioning. See options if you want to disable it.

Because postcss-positioning is a PostCSS plugin, it only processes horizontal and vertical, and leaves the rest of your CSS in place. If you come around a situation where you prefer to use common CSS positioning, nothing stops you from doing so.

Setup

If you are not familiar with PostCSS, head to the wiki for detailed instructions.

npm install --save-dev postcss-positioning postcss-calc
module.exports = {
    plugins: [
        require('postcss-positioning')({ /* options */ }),
        require('postcss-calc')()
    ]
}

Part of this project is inspired by Kevin Lynagh's talk at Deconstruct 2017.