Inline Styles are the Future

March 1, 2015

Radium is a set of tools to manage inline styles on React elements.

It gives you powerful styling capabilities without CSS, and was built over about 2 months at Formidable Labs in response to our excitement about a talk by Christopher Chedeau (and, more broadly, the mindshifting way that Facebook is building production web applications right now).

In this post, we'll cover the implications of the new technology, and some of the first questions the community asked.

## Modularization ```js var styleGlobals = require("styleGlobals"); var styles = { color: styleGlobals.fooBlue, backgroundColor: styleGlobals.barRed }; ```

What's it mean? No more Cascade and no more Style Sheets: all of the style properties that would have previously been defined globally in CSS are scoped to JS objects. "Globals" such as fonts and colors can be defined explicitly and changed programmatically, and are available only where they are required. If you've used @import to modularize Sass or LESS, or simply included <link> tags in the wrong order, you know that source order matters.

CommonJS modules handle the dependency tree under the hood – just modularize your styles as you would your JS and require them in the JS modules that need them. And, since they're modules, there are no more CSS global variables, overrides or inheritance. It isn't actually all that different from CSS. In CSS, you use class="foo" to reference class .foo in a stylesheet. Here, we're using to reference a modularized (or not, if only one component consumes it) JavaScript object, but we gain the full expressive power of the language between the definition of the style and the reference to it on the element.

## Computation & State:

See the Pen Radium State by David Davidson (@david-davidson) on CodePen. What's it mean? You can now use JS – either inline or required from an external module – to compute a style based on the state of your application (or anything you like!). Since the inline style is subject to diffing in React, this is extremely performant. Without Radium & React, you have to use JS to touch the DOM and/or the stylesheet. Looking at a stylesheet, it's a small research project to figure out when styles might be manipulated somewhere in the JS.

## Explicit Modifiers

See the Pen Radium Modifiers by David Davidson (@david-davidson) on CodePen. What's it mean? .btn-default .btn-primary .btn-warning are no longer necessary, since Radium allows you to define modifiers explicitly as React props for child components.

## Support for pseudo elements and browser states

See the Pen Radium Browser States by David Davidson (@david-davidson) on CodePen.

## Support for media queries

Yes! See: Radium Documentation on Media Queries

## Progressive Enhancement


```js display: Modernizr.flexbox ? flex : block; ```

Even more logic!

```js var someFlexboxStyles = require("../styles/someFlexboxStyles"); var someOtherStyles = require("../styles/someOtherStyles"); var styles = Modernizr.flexbox ? someFlexboxStyles : someOtherStyles; ```

What's it mean? It's now possible to make cross browser & cross device style logic as complex as you need to and keep it clean. As demonstrated in the second example, you can inject different styles at any point, based on any condition, in the same way you could do:

```js var alertStyles = this.state.isValid ? coolBlueAlert : brightRedAlert; ``` ## Dead code elimination & Minification

If your build system includes real dead code elimination (like webpack), unused Radium styles (for unused components, for instance) won't be included, which is a definite benefit over standard CSS, where it's extremely difficult to remove styles after they've been added.

## Large teams / maintainability

This will be expanded on in another blog post on React in general, the benefits of not having thousands of lines of CSS are myriad. For starters, it's more obvious what each view (in this case component) consumes. In BackboneJS, for instance, you would have to check all of the classes in the template, plus scan the document for any classes inserted with JS, then go check the rules in the CSS files. Conversely, another developer may unwittingly change the contents of a class without realizing that your view is downstream of it.

## Questions asked by the community ### How would you style child elements?

Suppose all <li>'s that are children of a given <div> Scenario 1: You do have access to the <li>'s you need to style (note ES6 fat arrow function, helpful for access to this.props inside of callbacks):

```js render: function () { var parentStyles = {...}; var listItemStyles = {...}; var builtListStyles = this.buildStyles(listItemStyles); var listNodes = _.each(this.collection, (item) => { return* {item.title} }) return (


) } ```

Scenario 2: You do not have access to the elements you need to style. In that case, use Radium's <Style/> component. The API is still being finalized but should look something like this once it's released:

```js render: function () { var styleContent = { h1: { fontSize: 20 } }; return ( ); } ``` ### Can I get a converter for my old CSS projects?


### What about a browser prefixing solution?


### How does Radium handle CSS animations?

You can't define CSS keyframe animations in inline styles, so you can't define them in Radium JS objects. You can, however, reference a CSS animation you defined in a stylesheet (and soon a CSS animation you define in a <Style/> tag) in an inline style:

,[object Object],[object Object]

Related Posts

Placing Radium Into Maintenance Mode

June 4, 2019
It has been more than four years since @vjeux proposed a revolutionary new idea for styling React components using javascript APIs. This CSS-in-JS talk sparked a wave of innovation in React open source community as we experimented with new ways to apply styles to our React components. Radium was one of the early tools to provide APIs for interop between JavaScript and DOM style tags, and allowed React developers to avoid specificity conflicts by scoping styles to DOM elements.

Radium Grid: A React Grid System Injected with the Power of Radium

June 20, 2016
After spending my formative frontend years implementing layouts with the CSS grid systems from both Bootstrap and Foundation, I developed a clear understanding of the strengths and weaknesses of both. Later, grid systems like Jeet solved many of the pain points of the old grids: no more fixed-column...

React Inline Styles and the Future of CSS

February 29, 2016
Writing and maintaining CSS for large applications (and large teams) can be challenging. Teams often have trouble with brittle selectors, naming collisions, specificity, and pile-ups of dead code. After seeing these issues first-hand on large projects, we built Radium: a JavaScript library for...