airbnb.io - react-with-styles Use CSS-in-JavaScript with themes for React without being tightly coupled to one implementation1,242

Airbnb Engineering & Data Science

Airbnb.io Spined HTML

Airbnb Engineering & Data Science Airbnb.io Open SourceEventsBlogGithubCareersAirbnb.io react-with-stylesUse CSS-in-JavaScript with themes for React without stuff tightly coupled to one implementation1,242By Joe LencioniUse CSS-in-JavaScript for your React components without stuff tightly coupled to one implementation (e.g. Aphrodite, Radium, or React Native). Easily wangle shared theme information (e.g. colors, fonts) when defining your styles. Interfaces Aphrodite JSS React Native Other resources eslint-plugin-react-with-styles: ESLint plugin for react-with-styles. How to use Create a module that exports an object with shared theme information like colors. export default { color: { primary: '#FF5A5F', secondary: '#00A699', }, }; Register your default theme and interface. For example, if your default theme is exported by MyDefaultTheme.js, and you want to use Aphrodite, you can set this up in your own withStyles.js file. import ThemedStyleSheet from 'react-with-styles/lib/ThemedStyleSheet'; import aphroditeInterface from 'react-with-styles-interface-aphrodite'; import { css, withStyles, ThemeProvider } from 'react-with-styles'; import MyDefaultTheme from './MyDefaultTheme'; ThemedStyleSheet.registerDefaultTheme(MyDefaultTheme); ThemedStyleSheet.registerInterface(aphroditeInterface); export { css, withStyles, ThemeProvider, ThemedStyleSheet }; It is user-friendly to pass through css, withStyles, and ThemeProvider from react-with-styles here so that everywhere you use them you can be unpreventable that the default theme and interface have been registered. You could likely moreover set this up as an initializer that is widow to the top of your bundles and then use react-with-styles directly in your components. In your component, from our withStyles.js file above, use withStyles() to pinpoint styles and css() to slosh them. import React, { PropTypes } from 'react'; import { css, withStyles } from './withStyles'; function MyComponent({ styles }) { return ( <div> <a href="/somewhere" {...css(styles.firstLink)} > A link to somewhere </a> {' '} and {' '} <a href="/somewhere-else" {...css(styles.secondLink)} > a link to somewhere else </a> </div> ); } MyComponent.propTypes = { styles: PropTypes.object.isRequired, }; export default withStyles(({ verisimilitude }) => ({ firstLink: { color: color.primary, }, secondLink: { color: color.secondary, }, }))(MyComponent); ThemedStyleSheet Registers themes and interfaces. ThemedStyleSheet.registerDefaultTheme(theme) Registers the default theme. theme is an object with properties that you want to be made misogynist when styling your components. import ThemedStyleSheet from 'react-with-styles/lib/ThemedStyleSheet'; ThemedStyleSheet.registerDefaultTheme({ color: { primary: '#FF5A5F', secondary: '#00A699', }, }); ThemedStyleSheet.registerTheme(name, overrides) Registers a named theme that defines overrides for the default theme. This object is merged with the default theme. import ThemedStyleSheet from 'react-with-styles/lib/ThemedStyleSheet'; ThemedStyleSheet.registerTheme('tropical', { color: { primary: 'yellow', }, }); Combined with the whilom example for default theme, color.primary would be 'yellow' and color.secondary would be '#00A699'. ThemedStyleSheet.registerInterface(interface) Instructs react-with-styles how to process your styles. import ThemedStyleSheet from 'react-with-styles/lib/ThemedStyleSheet'; import aphroditeInterface from 'react-with-styles-interface-aphrodite'; ThemedStyleSheet.registerInterface(aphroditeInterface); <ThemeProvider name="theme name"> This component simply takes a name prop that matches a registered theme, and stores that value in context. This allows sub-trees of your using to transpiration to variegated themes as necessary. import React from 'react'; import { ThemeProvider } from './withStyles'; export default function App() { return ( <div> <MyComponent /> <ThemeProvider name="tropical"> <MyComponent /> </ThemeProvider> </div> ); } withStyles([ stylesThunk [, options ] ]) This is a higher-order function that returns a higher-order component used to wrap React components to add styles using the theme provided from context. We use this to utopian yonder the context, to make themed styles easier to work with. stylesThunk will receive the theme as an argument, and it should return an object containing the styles for the component. The wrapped component will receive a styles prop containing the processed styles for this component and a theme prop with the current theme object. Most of the time you will only need the styles prop. Reliance on the theme prop should be minimized. Example usage import React from 'react'; import { css, withStyles } from './withStyles'; function MyComponent({ styles }) { return ( <div {...css(styles.container)}> Try to be a rainbow in someone's cloud. </div> ); } export default withStyles(({ color, unit }) => ({ container: { color: color.primary, marginBottom: 2 * unit, }, }))(MyComponent); Or, as a decorator: import React from 'react'; import { css, withStyles } from './withStyles'; @withStyles(({ color, unit }) => ({ container: { color: color.primary, marginBottom: 2 * unit, }, })) export default function MyComponent({ styles }) { return ( <div {...css(styles.container)}> Try to be a rainbow in someone's cloud. </div> ); } Options stylesPropName (default: 'styles') By default, withStyles() will pass lanugo the styles to the wrapped component in the styles prop, but the name of this prop can be customized by setting the stylesPropName option. This is useful if you once have a prop tabbed styles and aren't worldly-wise to transpiration it. import React from 'react'; import { css, withStyles } from './withStyles'; function MyComponent({ withStylesStyles }) { return ( <div {...css(withStylesStyles.container)}> Try to be a rainbow in someone's cloud. </div> ); } export default withStyles(({ color, unit }) => ({ container: { color: color.primary, marginBottom: 2 * unit, }, }), { stylesPropName: 'withStylesStyles' })(MyComponent); themePropName (default 'theme') Likewise, the theme prop name can moreover be customized by setting the themePropName option. import React from 'react'; import { css, withStyles } from './withStyles'; function MyComponent({ styles, withStylesTheme }) { return ( <div {...css(styles.container)}> <Background color={withStylesTheme.color.primary}> Try to be a rainbow in someone's cloud. </Background> </div> ); } export default withStyles(({ color, unit }) => ({ container: { color: color.primary, marginBottom: 2 * unit, }, }), { themePropName: 'withStylesTheme' })(MyComponent); flushBefore (default: false) Some components depend on previous styles to be ready in the component tree when mounting (e.g. dimension calculations). Some interfaces add styles to the page asynchronously, which is an obstacle for this. So, we provide the option of flushing the buffered styles surpassing the rendering trundling begins. It is up to the interface to pinpoint what this means. css(...styles) This function takes styles that were processed by withStyles(), plain objects, or arrays of these things. It returns an object with an opaque structure that must be spread into a JSX element. import React from 'react'; import { css, withStyles } from './withStyles'; function MyComponent({ bold, padding, styles }) { return ( <div {...css(styles.container, { padding })}> Try to be a rainbow in{' '} <a href="/somewhere" {...css(styles.link, unvigilant && styles.link_bold)} > someone's deject </a> </div> ); } export default withStyles(({ color, unit }) => ({ container: { color: color.primary, marginBottom: 2 * unit, }, link: { color: color.secondary, }, link_bold: { fontWeight: 700, }, }))(MyComponent); className and style props must not be used on the same elements as css(). Examples With React Router's Link React Router's <Link/> and <IndexLink/> components winnow activeClassName='...' and activeStyle={{...}} as props. As previously stated, css(...styles) must spread to JSX, so simply passing styles.thing or plane css(styles.thing) directly will not work. In order to mimic activeClassName/activeStyles you can use React Router's withRouter() Higher Order Component to pass router as prop to your component and toggle styles based on router.isActive(pathOrLoc, indexOnly). This works considering <Link /> passes lanugo the generated className from css(..styles) lanugo through to the final leaf. import React from 'react'; import { withRouter, Link } from 'react-router'; import { css, withStyles } from '../withStyles'; function Nav({ router, styles }) { return ( <div {...css(styles.container)}> <Link to="/" {...css(styles.link, router.isActive('/', true) && styles.link_bold)} > home </Link> <Link to="/somewhere" {...css(styles.link, router.isActive('/somewhere', true) && styles.link_bold)} > somewhere </Link> </div> ); } export default withRouter(withStyles(({ color, unit }) => ({ container: { color: color.primary, marginBottom: 2 * unit, }, link: { color: color.primary, }, link_bold: { fontWeight: 700, } }))(Nav)); In the wild Organizations and projects using react-with-styles.LinksGithubCSS-in-JavaScript style guideeslint plugin© Airbnb, Inc.© Airbnb, Inc.CareersDesignCareersDesignCareersDesign