Convert functional/reactive object description using RxJS into React component
Please note that this library hasn't been updated for more than two years. It's very rarely used and I consider it deprecated.
Convert functional/reactive object description into React component.
You don't need another UI framework if you want to use RxJS.
npm install --save recycle
const Timer = recycle({
initialState: {
secondsElapsed: 0,
counter: 0
},
update (sources) {
return [
sources.select('button')
.addListener('onClick')
.reducer(state => {
...state,
counter: state.counter + 1
}),
Rx.Observable.interval(1000)
.reducer(state => {
...state,
secondsElapsed: state.secondsElapsed + 1
})
]
},
view (props, state) {
return (
<div>
<div>Seconds Elapsed: {state.secondsElapsed}</div>
<div>Times Clicked: {state.counter}</div>
<button>Click Me</button>
</div>
)
}
})
You can also listen on child component events and define custom event handlers. Just make sure you specify what should be returned:
import CustomButton from './CustomButton'
const Timer = recycle({
initialState: {
counter: 0
},
update (sources) {
return [
sources.select(CustomButton)
.addListener('customOnClick')
.reducer((state, returnedValue) => {
counter: state.counter + returnedValue
})
]
},
view (props, state) {
return (
<div>
<div>Times Clicked: {state.counter}</div>
<CustomButton customOnClick={e => e.something}>Click Me</CustomButton>
</div>
)
}
})
If you are using Redux,
Recycle component can also be used as a container (an alternative to Redux connect
).
The advantage of this approach is that you have full control over component rerendering (components will not be "forceUpdated" magically).
Also, you can listen to a specific part of the state and update your component only if that property is changed.
export default recycle({
dispatch (sources) {
return [
sources.select('div')
.addListener('onClick')
.mapTo({ type: 'REDUX_ACTION_TYPE', text: 'hello from recycle' })
]
},
update (sources) {
return [
sources.store
.reducer(function (state, store) {
return store
})
/**
* Example of a subscription on a specific store property
* with distinctUntilChanged() component will be updated only when that property is changed
*
* sources.store
* .map(s => s.specificProperty)
* .distinctUntilChanged()
* .reducer(function (state, specificProperty) {
* state.something = specificProperty
* return state
* })
*/
]
},
view (props, state) {
return <div>Number of todos: {store.todos.length}</div>
}
})
If you don't need to update a component local state or dispatch Redux action,
but you still need to react to some kind of async operation, you can use effects
.
Recycle will subscribe to this stream but it will not use it. It is intended for making side effects (like calling callback functions passed from a parent component)
const Timer = recycle({
effects (sources) {
return [
sources.select('input')
.addListener('onKeyPress')
.withLatestFrom(sources.props)
.map(([e, props]) => {
props.callParentFunction(e.target.value)
})
]
},
view (props) {
return (
<input placeholder={props.defaultValue}></input>
)
}
})
Component description object accepts following properties:
{
propTypes: { name: PropTypes.string },
displayName: 'ComponentName',
initialState: {},
dispatch: function(sources) { return Observable },
update: function(sources) { return Observable },
effects: function(sources) { return Observable },
view: function(props, state) { return JSX }
}
In update
, dispatch
and effects
functions, you can use the following sources:
/**
* sources.select
*
* select node by tag name or child component
*/
sources.select('tag')
.addListener('event')
sources.select(ChildComponent)
.addListener('event')
/**
* sources.selectClass
*
* select node by class name
*/
sources.selectClass('classname')
.addListener('event')
/**
* sources.selectId
*
* select node by its id
*/
sources.selectId('node-id')
.addListener('event')
/**
* sources.store
*
* If you are using redux (component is inside Provider)
* sources.store will emit its state changes
*/
sources.store
.reducer(...)
/**
* sources.state
*
* Stream of current local component state
*/
sources.select('input')
.addListener('onKeyPress')
.filter(e => e.key === 'Enter')
.withLatestFrom(sources.state)
.map(([e, state]) => state.someStateValue)
.map(someStateValue => using(someStateValue))
/**
* sources.props
*
* Stream of current local component props
*/
sources.select('input')
.addListener('onKeyPress')
.filter(e => e.key === 'Enter')
.withLatestFrom(sources.props)
.map(([e, props]) => props.somePropsValue)
.map(somePropsValue => using(somePropsValue))
/**
* sources.lifecycle
*
* Stream of component lifecycle events
*/
sources.lifecycle
.filter(e => e === 'componentDidMount')
.do(something)
handleClick
events or this.setState
statements that you need to worry about.state = reducer(state, action)
.shouldComponentUpdate
)No.
Although it resembles query selectors, Recycle uses React’s inline event handlers and doesn’t rely on the DOM. Since selection is isolated per component, no child nodes can ever be accessed.
No.
Since Recycle doesn't query over your nodes, selectors like div .class
will not work.
It works by monkeypatching React.createElement
.
Before a component is rendered, for each element,
if a select query is matched, recycle sets inline event listener.
Each time event handler dispatches an event,
it calls selectedNode.rxSubject.next(e)
Yes.
Recycle creates classical React component which can be safely used in React Native.