Skip to content

Latest commit

 

History

History
219 lines (168 loc) · 5.29 KB

README.md

File metadata and controls

219 lines (168 loc) · 5.29 KB

postcss-fluid

NPM version lint status test status formatted with prettier

PostCSS plugin that makes it easier to work with fluid, responsive values.

Want to make your font-size 1rem on screens smaller than 40rem and scale it up to 1.25rem on desktops (120rem)?
It's trivial with this plugin:

/* Input */
.fluid-typography {
  font-size: fluid(1rem, 1.25rem, 40rem, 120rem);
}
/* Output */
.fluid-typography {
  font-size: clamp(1rem, 0.875rem + 0.3125vw, 1.25rem);
}

This is called fluid typography, you can read more about the topic in this excellent blog post: smashingmagazine.com/2016/05/fluid-typography.

Coming up with the right clamp value is hard, that's why we have sites like responsive font calculator, fluid typography calculator or frontend tools that take your min and max value, min and max viewport size and output the right expression. You just have to copy it into your css.

The purpose of this plugin is to bring this functionality into your stylesheets without the need of any external website.

Demo

Demo is available at https://lehoczky.github.io/postcss-fluid/

Setup

Step 1: Install plugin:

npm install --save-dev postcss @lehoczky/postcss-fluid

Step 2: Check you project for existing PostCSS config: postcss.config.js in the project root, "postcss" section in package.json or postcss in bundle config.

If you do not use PostCSS, add it according to official docs and set this plugin in settings.

Step 3: Add the plugin to plugins list:

module.exports = {
  plugins: [
+   require('@lehoczky/postcss-fluid'),
    require('autoprefixer')
  ]
}

Usage

The function takes 4 parameters: min value, max value, min viewport width, max viewport width.

.foo {
  margin: fluid(1rem, 2rem, 40rem, 120rem);
}
.foo {
  margin: clamp(1rem, 0.5rem + 1.25vw, 2rem);
}

The values can be pixels too, in this case the output will use pixels as well:

.foo {
  margin: fluid(16px, 32px, 640px, 1920px);
}
.foo {
  margin: clamp(16px, 8px + 1.25vw, 32px);
}

you can even mix the two examples above and use pixels for the values and rem for the viewport width or vice versa:

.foo {
  margin: fluid(1rem, 2rem, 640px, 1920px);
  letter-spacing: fluid(1px, 2px, 40rem, 120rem);
}
.foo {
  /* Notice that the output uses the same unit that's given to the value parameters */
  margin: clamp(1rem, 0.5rem + 1.25vw, 2rem);
  letter-spacing: clamp(1px, 0.5px + 0.0781vw, 2px);
}

however don't try to mix units for the values or the viewports. The following won't work:

.foo {
  margin: fluid(1rem, 10px, 640px, 1920px);
}

The function can only be called with px and rem units. %, vh, dpi, etc. are not supported.

Options

It's possible to set a default min and max viewport width in the plugin options.

plugins: [
  require("@lehoczky/postcss-fluid")({ min: "40rem", max: "120rem" }),
  ...
],

Now you can call the fluid function with only 2 parameters:

.foo {
  /* same as fluid(1rem, 2rem, 40rem, 120rem) */
  margin: fluid(1rem, 2rem);

  /* Calling with all 4 parameters overrides the globally set options */
  padding: fluid(1rem, 2rem, 60rem, 80rem);
}

The values can be given as numbers (number of pixels), or as strings with either rem or px units. The following options are all valid:

require("@lehoczky/postcss-fluid")({
  min: "640px",
  max: "1920px",
})

require("@lehoczky/postcss-fluid")({
  min: "40rem",
  max: "120rem",
})

require("@lehoczky/postcss-fluid")({
  // same as "640px" and "1920px"
  min: 640,
  max: 1920,
})

Stylelint

If you use stylelint in your project and it warns about the function, add this to your .stylelintrc:

{
  "rules": {
    "function-no-unknown": [
      true,
      {
        "ignoreFunctions": ["fluid"]
      }
    ]
  }
}

Tailwindcss

This plugin works with tailwindcss too.

Minimal postcss.config.js:

module.exports = {
  plugins: [
    require("@lehoczky/postcss-fluid"),
    require("tailwindcss"),
    require("autoprefixer"),
  ],
}

You can use the fluid function in tailwind.config.js files:

/** @type {import('tailwindcss').Config} */
module.exports = {
  content: ["./src/**/*.{html,js}"],
  theme: {
    extend: {
      spacing: {
        fluid: "fluid(1.25rem, 3.25rem, 640px, 1536px)",
      },
    },
  },
  plugins: [],
}

Or with value interpolation:

<main class="mt-[fluid(1.25rem,3rem,640px,1536px)]">
  This content has fluid top margin
</main>