package
A simple CSS-in-JS solution that extracts to CSS files
npm install @geekie/cssGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.
Tagged topics.
Latest published Jun 21, 2019
@geekie/cssA simple CSS-in-JS solution that extracts CSS files.
This library was created at Geekie when we started porting parts of our RN app to a web version. We evaluated most existing libraries and none would accomplish all our requirements:
A simple example of the API:
import { StyleSheet, css } from "@geekie/css";
const styles = StyleSheet.create({
header: {
fontSize: 18,
fontWeight: "bold"
},
bordered: {
border: "1px solid #000"
}
});
function Header({ children }) {
return (
<span className={css(styles.header, styles.bordered)}>{children}</span>
);
}When used with our Webpack plugin, the StyleSheet.create() call will be replaced by a simple object, where the keys are kept and each value is a string of [atomic classnames] separated by an space. Each classname correspond to a single style defined in the object passed to StyleSheet.create. See the following output for an illustration:
import { css } from "@geekie/css";
// these classnames are just an example
const styles = {
header: "gkcss0_a4bcdef gkcss1_b9cdk4l",
bordered: "gkcss2_a84ifj"
};
function Header({ children }) {
return (
<span className={css(styles.header, styles.bordered)}>{children}</span>
);
}And the css() function will select one classname from each "type", to prevent non-deterministic behavior caused by the order of CSS rules order.
In the cases where the styles can't be computed statically, the StyleSheet.create() will simply return the first argument, and when the css() function receives an object as argument, it will fallback to add class dynamically, very similar to the [glamor] (and others) behavior. An example:
css(
// assume these are the output of a `StyleSheet.create()` call
"gkcss0_a4bcdef gkcss1_b9cdk4l",
"gkcss0_g83nvn",
// these are dynamic styles
{ color: "red" },
{ fontFamily: "Verdana", color: "black" }
);The call above will return:
"gkcss0_g83nvn gkcss1_b9cdk4l css-839fn39"And a corresponding CSS rule will be created:
.css-839fn39 {
font-family: Verdana;
color: black;
}In order to benefit from the build time CSS compilation, you need to use the companion loader and plugin. Example:
// webpack.config.js
const GkCssPlugin = require("@geekie/css/webpack");
module.exports = {
module: {
rules: [
{
test: /\.js$/,
use: [
// we recommend adding the loader as the last loader
{
loader: GkCssPlugin.loader,
options: {
globals: {
// include any globals that may affect the CSS styles
// so they can be evaluated statically
__DEV__: process.env.NODE_ENV !== "production"
}
}
}
]
}
]
},
plugins: [
border vs border-left)mattbarros
mateus.rodrigues@geekie.com.br
Estimated unpacked size across 23 packages.
3.8 MB
Includes dependencies.
7 direct · 6 outdated
^2.0.0
2.0.0
^7.0.0
8.1.2
^1.1.0
3.3.1
^7.0.0
8.1.2
^1.3.0
3.7.0
^7.0.0
8.1.2
8.1.2