npmpackage.info

react-free-style

Make React components easier and more maintainable by using inline style objects

11.1.0

139

MIT

TypeScript

2.45 kB

72,212 2.6

Installations

npm install react-free-style

Pull Requests

Open

0

Total

42

Closed

6

Merged

36

Issues

Open

0

Total

19

Closed

19

Releases

Upgrade dependencies

v11.1.0

Published on 24 Jan 2021

Handle `insertRule` errors

v11.0.1

Published on 07 Jun 2020

Upgrade Free Style

v11.0.0

Published on 02 May 2020

Fix `styled` ref

v10.2.2

Published on 12 Apr 2020

Allow multiple CSS values

v10.2.1

Published on 30 Mar 2020

Recursive Computed CSS

v10.2.0

Published on 27 Mar 2020

View all 56 releases

Developer

blakeembrey

Developer Guide

BETA

Module System

CommonJS

Min. Node Version

Typescript Support

No

Node Version

15.6.0

NPM Version

6.14.9 Statistics

139 Stars

254 Commits

2 Forks

4 Watching

1 Branches

6 Contributors

Updated on 06 Aug 2024

Bundle Size

6.70 kB

Minified

2.45 kB

Minified + Gzipped

Bundlephobia

Languages

TypeScript (88.04%)

JavaScript (11.96%)

Total Downloads

Cumulative downloads

Total Downloads

72,212

Last day

150%

Compared to previous day

Last week

-40%

Compared to previous week

Last month

-30.2%

379

Compared to previous month

Last year

-41.2%

7,279

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Versions

React Free Style

React Free Style combines Free Style with React.js by managing the style of React components dynamically. Works with server-side rendering, where only styles of rendered components will print.

Why?

Check out why you should be doing CSS in JS. This module exposes the API directly to React.js.

Even more improvements with React Free Style

Modular React.js components
Style debugging in development mode
Fast renders with automatic style for rendered React components
Supports universal/isomorphic applications

Installation

npm install react-free-style --save

Usage

Styled

1import { styled } from "react-free-style";
2
3const Button = styled("button", {
4  backgroundColor: "red",
5});
6
7const App = () => {
8  return <Button css={{ color: "blue" }}>Hello world!</Button>;
9};

JSX

1/** @jsx jsx */
2
3import { jsx } from "react-free-style";
4
5const App = () => {
6  return (
7    <button css={{ color: "blue", backgroundColor: "red" }}>
8      Hello world!
9    </button>
10  );
11};

Imperative

1import { css, useCss } from "react-free-style";
2
3// Creates "cached CSS":
4const style = css({ color: "red" });
5// But you can also write `const style = { color: "red" }`.
6
7const Button = () => {
8  const className = useCss(style);
9
10  return <button className={className}>Hello world!</button>;
11};

This is how the styled and jsx work! Knowing how it works can help you when you need to extract the class name for integrating with an existing UI library using className.

Recipes

Valid Styles

Every CSS method accepts:

CSS-in-JS object
String, i.e. a class name
Cached CSS, created using the css(...) method
Computed CSS, a function which accepts Style and returns a valid style
Array of the above

Composition

Components created using styled expose "cached CSS" on the style property.

1const LargeButton = styled("button", [
2  {
3    fontSize: 16,
4  },
5  Button.style,
6  {
7    marginBottom: 8,
8  },
9]);

Animations

A "computed CSS" function can be used to register and use @keyframes.

1import { css } from "react-free-style";
2
3const style = css((Style) => {
4  const animationName = Style.registerStyle({
5    $global: true,
6    "@keyframes &": styles,
7  });
8
9  return { animationName };
10});

Themes

CSS Variables

The most effective CSS themes I've seen use CSS variables to dynamically change styles.

1// Register this CSS wherever you want the theme to apply, e.g. `:root`.
2const theme = {
3  "--color": "red",
4};
5
6const Button = styled("button", {
7  color: "var(--color)",
8});
9
10// Later on you can change the theme.
11const style = css({
12  "--color": "blue",
13});

Context

Use React.Context to define a theme and custom components with css props.

1const ThemeContext = React.createContext({
2  color: "red",
3});
4
5const Button = () => {
6  const theme = React.useContext(ThemeContext);
7
8  return <button css={{ color: theme.color }}>Hello world!</button>;
9};

Rendering

By default, CSS output is discarded (a "no op" useful for testing) because you may have different output requirements depending on the environment.

Client-side Rendering

StyleSheetRenderer is an efficient CSS renderer for browsers.

1import { StyleSheetRenderer, Context } from "react-free-style";
2
3// const renderer = new NoopRenderer();
4const renderer = new StyleSheetRenderer();
5
6React.render(
7  <Context.Provider value={renderer}>
8    <App />
9  </Context.Provider>,
10  document.body
11);

Server-side Rendering

MemoryRenderer collects all styles in-memory for output at a later time.

1import { MemoryRenderer, Context } from "react-free-style";
2
3// const renderer = new NoopRenderer();
4const renderer = new MemoryRenderer();
5
6const content = ReactDOM.renderToString(
7  <Context.Provider value={renderer}>
8    <App />
9  </Context.Provider>,
10  document.body
11);
12
13const html = `
14<!doctype html>
15<html>
16  <head>
17    ${renderer.toString()}
18  </head>
19  <body>
20    <div id="content">
21      ${content}
22    </div>
23  </body>
24</html>
25`;

License

MIT license

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Security-Policy

Determines if the project has published a security policy.

10

License

Determines if the project has defined a license.

0

Maintained

Determines if the project is "actively maintained".

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

69 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw
Warn: Project is vulnerable to: GHSA-whgm-jr23-g3j9
Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
Warn: Project is vulnerable to: GHSA-fwr7-v2mv-hh25
Warn: Project is vulnerable to: GHSA-qwcr-r2fm-qrc7
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-x9w5-v3q2-3rhw
Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-phwq-j96m-2c2q
Warn: Project is vulnerable to: GHSA-ghr5-ch3p-vcr6
Warn: Project is vulnerable to: GHSA-434g-2637-qmqr
Warn: Project is vulnerable to: GHSA-49q7-c7j4-3p7m
Warn: Project is vulnerable to: GHSA-977x-g7h5-7qgw
Warn: Project is vulnerable to: GHSA-f7q4-pwc6-w24p
Warn: Project is vulnerable to: GHSA-fc9h-whq2-v747
Warn: Project is vulnerable to: GHSA-6h5x-7c5m-7cr7
Warn: Project is vulnerable to: GHSA-rv95-896h-c2vc
Warn: Project is vulnerable to: GHSA-qw6h-vgh9-j6wx
Warn: Project is vulnerable to: GHSA-74fj-2j2h-c42q
Warn: Project is vulnerable to: GHSA-pw2r-vq6v-hr8c
Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc
Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp
Warn: Project is vulnerable to: GHSA-ww39-953v-wcq6
Warn: Project is vulnerable to: GHSA-c7qv-q95q-8v27
Warn: Project is vulnerable to: GHSA-78xj-cgh5-2h22
Warn: Project is vulnerable to: GHSA-2p57-rm9w-gvfp
Warn: Project is vulnerable to: GHSA-7r28-3m3f-r2pr
Warn: Project is vulnerable to: GHSA-r8j5-h5cx-65gg
Warn: Project is vulnerable to: GHSA-896r-f27r-55mw
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-6c8f-qphg-qjgp
Warn: Project is vulnerable to: GHSA-76p3-8jx3-jpfq
Warn: Project is vulnerable to: GHSA-3rfm-jhwj-7488
Warn: Project is vulnerable to: GHSA-hhq3-ff78-jv3g
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
Warn: Project is vulnerable to: GHSA-5rrq-pxf6-6jx5
Warn: Project is vulnerable to: GHSA-8fr3-hfg3-gpgp
Warn: Project is vulnerable to: GHSA-gf8q-jrpm-jvxq
Warn: Project is vulnerable to: GHSA-2r2c-g63r-vccr
Warn: Project is vulnerable to: GHSA-cfm4-qjh2-4765
Warn: Project is vulnerable to: GHSA-x4jg-mjrx-434g
Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p
Warn: Project is vulnerable to: GHSA-rp65-9cf3-cjxr
Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j
Warn: Project is vulnerable to: GHSA-7fh5-64p2-3v2j
Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp
Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-44c6-4v22-4mhx
Warn: Project is vulnerable to: GHSA-4x5v-gmq8-25ch
Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg
Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p
Warn: Project is vulnerable to: GHSA-4wf5-vphf-c2xc
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-rqff-837h-mm52
Warn: Project is vulnerable to: GHSA-8v38-pw62-9cw2
Warn: Project is vulnerable to: GHSA-hgjh-723h-mx2j
Warn: Project is vulnerable to: GHSA-jf5r-8hm2-f872
Warn: Project is vulnerable to: GHSA-hc6q-2mpp-qw7j
Warn: Project is vulnerable to: GHSA-4vvj-4cpr-p986
Warn: Project is vulnerable to: GHSA-wr3j-pwj9-hqq6
Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q

Score

2.6

/10

Last Scanned on 2024-11-25

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to react-free-style

@borderlesslabs/ui

0.3.1

UI components based on React Free Style and Atoms

react-onclickoutside

6.13.1

An onClickOutside wrapper for React components

@react-native/normalize-colors

0.76.3

Color normalization for React Native.

react-native-webview

13.12.4

React Native WebView component for iOS, Android, macOS, and Windows

react-free-style

Installations

Pull Requests

0

42

6

36

Issues

0

19

19

Releases

Developer

blakeembrey

Developer Guide

CommonJS

No

15.6.0

6.14.9

Statistics

Bundle Size

6.70 kB

2.45 kB

Languages

Total Downloads

72,212

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

React Free Style

Why?

Installation

Usage

Styled

JSX

Imperative

Recipes

Valid Styles

Composition

Animations

Themes

CSS Variables

Context

Rendering

Client-side Rendering

Server-side Rendering

License

10

10

10

0

0

0

0

0

0

0

2.6

/10

Other packages similar to react-free-style