# rplain

> React container for only children rendering

Latest version **1.0.1** (published 2017-11-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install rplain
pnpm add rplain
yarn add rplain
bun add rplain
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2017-11-29 |
| First published | 2017-11-05 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | Nikita Mostovoy |
| Maintainers | xnimorz |
| Keywords | react16, react, container, children-rendering, children |

## Links

- npm: https://www.npmjs.com/package/rplain
- Repository: https://github.com/xnimorz/rplain
- Homepage: https://github.com/xnimorz/rplain#readme
- Issues: https://github.com/xnimorz/rplain/issues
- npm.io page: https://npm.io/package/rplain

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.0.1 (latest) — 2017-11-29
- 1.0.0 — 2017-11-05

## README

## This project is out of date!

In React v16.2 you can use `<> </>` construction instead of RPlain component:
```javascript
<>
    <div>First</div>
    <div>Second</div>
    <div>Third</div>    
</>
```

# rplain

React-Component for rendering children.

На русском: https://github.com/xnimorz/rplain/blob/master/README_RU.md

## Install
```
npm install --save rplain
```
Or
```
yarn add rplain
```
## Usage

```javascript
import RPlain from 'rplain';

class MyComponent extends Component {
    render() {
        const {children} = this.props;
        return (
            <RPlain>
                <div>First</div>
                <div>Second</div>
                <div>Third</div>    
                {children}
            </RPlain>
        );
    }
}
```
Or
```javascript
import RPlain from 'rplain';
// some code
<RPlain>
    <div>First</div>
    <div>Second</div>
    <div>Third</div>    
</RPlain>
```
Also you can see example page: https://xnimorz.github.io/rplain/ with source code: https://github.com/xnimorz/rplain/blob/master/examples/example.js

## JavaScript modules support

RPlain can work as CommonJS or AMD module. You can use this component with webpack. There is no babel or any transforms required to use this component. It's compatible with es5.

In case you don't use any modules, RPlain can work with global object. But it's not recommended.

## Why?

In React <=15 you have to use container. So we have to use such constructions in components:

```javascript
class MyComponent extends Component {
    render() {
        const {children, title} = this.props;

        return (
            <div>
                <div class='MyComponent-title'>{title}</div>
                <div class='MyComponent-a1'>First useful content item</div>
                <div class='MyComponent-a2'>Second useful content item</div>
                {children}
            </div>
        );
    }
}
```
With React 16 component's render method can return arrays, plain strings. 
Let's rewrite our example to array:
```javascript
class MyComponent extends Component {
    render() {
        const {children, title} = this.props;

        return [                    
            <div key='title' class='MyComponent-title'>{title}</div>,
            <div key='a1' class='MyComponent_a1'>First useful content item</div>,
            <div key='a2' class='MyComponent_a2'>Second useful content item</div>,
            children,
        ];
    }
}
```
When we would return array, we must use "key" attribute, put comma to the end of each block. But our content isn't an array. So we can wrap our content with RPlain component:
```javascript
class MyComponent extends Component {
    render() {
        const {children, title} = this.props;

        return (
            <RPlain>
                <div class='MyComponent-title'>{title}</div>
                <div class='MyComponent-a1'>First useful content item</div>
                <div class='MyComponent-a2'>Second useful content item</div>
                {children}
            </RPlain>
        );            
    }
}
```
## Why you create separate package?

RPlain-component is useful in severel projects. So I create separate package.

---
_Source: https://npm.io/package/rplain · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
