This package is no longer maintained, because there are way better styling solutions out there. For a package with similar benefits (atomic class names, media queries, pseudo classes, etc...), but significantly better ergonomics, see fela and fela-components.
Functional Style Sheets let you easily generate functional CSS — similar to Tachyons or Basscss — based a custom definitions you provide to it.
Additionally, functional utilities are provided, guarding against using undefined classes.
Basically, using funcss, you end up writing something that almost looks like inline styles, but with native support for media queries and pseudo classes & elements, and very performant. (See examples below...)
Styles can be injected and generated on client to reduce payload size or generated on the server and used like any other regular CSS.
Functional Style Sheets can be used with any framework (React, Angular, whatever...) and are independent of build system.
npm install --save funcss
First off, you need to specify your rule definitions:
// Create a module like this, and import it somewhere early
// in the app. Ideally before things like `React.render()`.
import funcss from 'funcss'
const defs = [{
name: "background-color"
rules: [
["blue", "#4996f2"],
["dark-blue", "#428ae0"],
],
media: [
["@narrow", "(min-width:20rem)"],
["@wide", "(min-width:40rem)"],
],
pseudo: [
":hover",
"::placeholder",
],
}]
const stylesheet = funcss(defs)
export default stylesheet
The default export from funcss will inject generated stylesheet into the <head> of the document and return an object with methods matching your defs.
In the above example, the stylesheet object would include one method — backgroundColor — which can be used to retrieve the right class name, which can be subsequently used inside your components.
Note that methods are camelCased so that you can access them in JS using the dot notation.
Usage in a React component looks like this:
import React from "react"
import classnames from "classnames"
import stylesheet from "./stylesheet"
const FancyButton = (props) => (
<button className={classnames(
stylesheet.backgroundColor("blue"),
stylesheet.backgroundColor("dark-blue", ":hover"),
)}>
{props.children}
</button>
)
Stylesheet methods take one or two arguments. The first argument should be one the rules you have defined for this definition (in this case "blue" or "dark-blue"), and the second, optional, argument is either a media query name ("@narrow", "@wide"), or a pseudo selector (:hover).
So stylesheet.backgroundColor("blue") will return the correct CSS class name (simple string) based on your arguments, but will also let you know if you try to get things which you haven't defined previously.
For example, stylesheet.backgroundColor("foo") will print "Couldn't find 'foo' key for 'background-color' definition." to the console.
Note that since we are dealing with totally vanilla CSS here (and those class names are just regular strings), you can use any other styling solution — regular CSS, CSS Modules, inline styles — to handle edge-cases like relatively positioning an element to optically align it, etc...
To use on the server, use the generate secondary export (import {generate} from 'funcss') instead of the default.
The generate functions returns an object with css and stylesheet properties without trying to inject anything anywhere, so you can use it safely on the server and do what you will with the output.
FAQs
Functional Style Sheets
The npm package funcss receives a total of 0 weekly downloads. As such, funcss popularity was classified as not popular.
We found that funcss demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.