hops-postcss
v15.2.1
Published
Configuration of PostCSS and Webpack for Hops
Downloads
909
Readme
hops-postcss
Please see the main Hops Readme for general information and a Getting Started Guide.
This is a preset for Hops that, when installed, will enable css loaders for PostCSS Preset Env with support for CSS Modules.
Installation
Add this preset to your existing Hops React project:
npm install --save hops-postcss
If you don't already have an existing Hops project read this section on how to set up your first Hops project.
Usage
Since this preset has no configuration, you can start writing CSS in external files and import
/ require
them in your application code after installing this preset.
.headline {
color: red;
}
import styles from './styles.css';
export default render(<h1 className={styles.headline}>hello</h1>);
Check out this integration test as an example for how to use this preset.
CSS Modules opt-out
Sometimes it can be necessary to import an external CSS-file without applying CSS Modules to them, to keep their class names intact.
You can opt-out of CSS Modules by importing the respective file with the global
query parameter.
import 'animate.css/animate.min.css?global';
Depending on your ESLint rules, you might need to ignore the import line as there can be issues with the non-standard query parameter.
/* eslint-disable-next-line import/no-unresolved */
import 'animate.css/animate.min.css?global';
CSS Grid & Autoprefixer
By default CSS Grid properties are not auto-prefixed and there are neither plans to turn on this feature globally in Hops, nor to provide a respective preset option.
Still you can use CSS Grid already by either enabling auto-prefixing on a per-file basis with a comment or for the whole project with an environment variable.
Enabling CSS Grid per file
To enable auto-prefixing of CSS Grid properties for a single file, put the following comment at its beginning:
/* autoprefixer grid: autoplace */
Enabling CSS Grid for the whole project
To enable auto-prefixing of CSS Grid properties for the whole project, pass the environment variable AUTOPREFIXER_GRID=autoplace
to the build-command:
AUTOPREFIXER_GRID=autoplace yarn hops build
For more information on that topic, please have a look at the documentation of Autoprefixer.
Configuration
Preset Options
This preset has no preset configuration options.
Render Options
This preset has no runtime configuration options.