Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/tkh44/restyles

👩‍🚀 declarative glamor for react and preact
https://github.com/tkh44/restyles

css css-in-js glamor preact react

Last synced: about 1 month ago
JSON representation

👩‍🚀 declarative glamor for react and preact

Lists

README

        

# restyles

**Declarative [glamor](https://github.com/threepointone/glamor)**

Write styles scoped to your component and use standard css selectors to target children.
Due to its tiny size, restyles makes the perfect companion for [glamorous](https://github.com/paypal/glamorous).

[![npm version](https://badge.fury.io/js/restyles.svg)](https://badge.fury.io/js/restyles)
[![Build Status](https://travis-ci.org/tkh44/restyles.svg?branch=master)](https://travis-ci.org/tkh44/restyles)
[![codecov](https://codecov.io/gh/tkh44/restyles/branch/master/graph/badge.svg)](https://codecov.io/gh/tkh44/restyles)

- [Install](#install)
- [Basic Usage](#basic-usage)
- [Props](#props)

## Install

```bash
npm install -S restyles
```

## Basic Usage
```jsx
const Profile = props => (
(
<div className={cls}>
This will be blue until hovered.
<div className="profile">
This font size will be 20px
</div>
</div>
)}
/>
)
```

## Props

#### children `fn`

Function to render your children. Its only argument is a class name that you can apply to an element of your choice.
Usually this is the outermost element(s) of your children.

**`render` takes precedence over `children`**

*use `render` for better performance*

#### css `object|array<object>`

Your css as an object. This is passed straight through to cxs.

*[glamor docs](https://github.com/threepointone/glamor/blob/master/README.md)*

```jsx
const Profile = props => (
<Style
css={{
color: 'blue',
'& .profile': {
color: 'red',
'& .username': {
color: 'green',
'& .three': {
color: 'gray',
'& .inner': {
color: 'rebeccapurple',
fontSize: 20
}
}
}
},
':hover': {
'& .three': {
color: 'black'
}
},
':active': {
'& .inner': {
color: 'purple',
fontSize: 20
}
},
':before': {
content: '" "',
position: 'absolute',
top: 0,
left: 0,
width: '100%',
height: '100%',
backgroundColor: 'blue'
},
'@media (min-width: 500px) and (orientation: landscape)': {
'& .inner': {
color: 'purple',
fontSize: 48
}
}
}}
render={cls => (
<div className={cls}>
blue
<div className={'profile'}>
red
<div className={'username'}>
green
<div className={'three'}>
<span className={'inner'}>test</span>
</div>
</div>
</div>
</div>
)}
/>
)
```

#### render `fn`

**takes precedence over `children`**

Function to render your children. Its only argument is a class name that you can apply to an element of your choice.
Usually this is the outermost element(s) of your children.

```jsx
const Greeting = ({ name }) => (
<Style
css={{
color: '#63e6be',
fontSize: 48,
letterSpacing: '1ch',
':hover': {
color: '#0ca678'
}
}}
render={cls => <h1 className={cls}>Hello {name}</h1>}
/>
)

```