react-look

Docs • Getting Started • Example

Also available for React Native

Features

- ES2015 Classes & React.createClass
- stateless Components
- server-side rendering
- plugin-based
- developer tools
- Sass-like nesting
- pseudo classes
- media queries
- platform queries
- conditioned styles
- stateful values & selectors
- fallback values
- extending
- vendor prefixing
- CSS, font-face & keyframes API

Documentation

The documentation contains information on every part of Look including usage guides and API reference.

New to Look?

Make sure to check out the the Getting Started guide which provides a full guide on how to use Look. From installation, over configuration and up to even developer tooling.

Table of contents

1. Getting Started
* 1.1. Installation
* 1.2. First Component
* 1.3. Stateless Components
* 1.4. Pseudo classes
* 1.5. Media queries
* 1.6. Mixins & Plugins
* 1.7. Fallback values
* 1.8. Vendor prefixes
* 1.9. Server-side rendering
* 1.10. DevTools
2. API Reference
* 2.1. look
* 2.2. StyleSheet
* create
* combineStyles
* toCSS
* addCSS
* renderToString
* keyframes
* font
* 2.3. LookRoot
* 2.4. StyleContainer
3. Registry
* 3.1. Plugins
* Fallback Value
* Mixin
* Stateful Value
* Stateful Selector
* 3.1.1 DevTools
* Friendly ClassName
* Linter
* Style Logger
* 3.2 Mixins
* Contains
* Extend
* Extract CSS
* Platform Queries
* Stateful Conditions
* Substr
* 3.3. Prefixer
* Static Prefixer
* Dynamic Prefixer
4. Guides
* 4.1. Upgrading Look
* 4.2. Configuring Look
* 4.3. Build your own: Mixin
* 4.4. Build your own: Plugin
* 4.5. Build your own: Prefixer
5. FAQ

Example

The syntax is quite similar to Sass and other React styling libraries.

``sh
npm install react-look --save
`
Look ships pseudo class and media query support by default. They're resolved within the StyleSheet.create method.
`javascript
import React, { Component, PropTypes } from 'react'
import look, { StyleSheet } from 'react-look'

class Header extends Component {
static defaultProps = { size: 24 };
static propTypes = { size: PropTypes.number.isRequired };
state = { status: 'active' };

render() {
return (
// Styles are basically applied using the className property


{this.props.title}

)
}
}

// generates classNames for each selector
const styles = StyleSheet.create({
header: {
transition: '200ms all linear',
// Use media queries or pseudo classes
// using nested style objects. Those get transformed
// on the fly and can be nested endlessly.
'@media (min-height: 800px)': {
fontSize: 13,
':hover': {
fontSize: 15
}
},
// You can also use mixins with the same selector.
// They'll get split intelligently and evaluated on render
'status=active': {
backgroundColor: 'green',
'size>=20': {
backgroundColor: 'pink'
}
}
},
title: {
fontWeight: 800,
// use functions to inject props, state or context values
fontSize: (props, state, context) => props.size * state.zoom
}
})

export default look(Header)
`
Finally you only need to wrap your application with LookRoot.
`javascript
import { LookRoot, Presets } from 'react-look'
import { render } from 'react-dom'
import React, { Component } from 'react'
import Header from './Header'

const App = () =>

render(


,
document.getElementById('app')
)
`


Demo

Check out the provided examples for some special use cases. See them in action using the demo. You can easily run the examples on your own within the provided demo by just.

`sh
git clone --bare https://github.com/rofrischmann/react-look.git
cd react-look
npm install


run this to actually prepare the modules

npm run build

run this as a client-side only demo

npm run demo

run this as a universal demo

npm run demo:universal
``

License

Look is licensed under the MIT License.

Documentation is licensed under Creative Common License.

Created with ♥ by @rofrischmann.