react-ctxt v0.1.1

react-ctxt

An alternative to using React's experimental context feature that doesn't rely on React context but provides a similar mechanism for passing a prop all the way down the tree. It uses react-side-effect to share state across the app, and forces updates on any components that rely on context when the context changes.

Purpose

Provide a replacement API for React context that meets all the use cases using only the props API and familiar JSX.

Differences

Providers in react context can live anywhere and provide variables for their parent components. Context is just not just provided for the children of a Provider component. This is due to the technical difficulty of trying to figure out component hierarchies without slipping into React internals.

Example

A provider adds some variables to the application context, and Inject passes globals to

import React, { PureComponent } from 'react';
import { Inject, Provider } from 'react-ctxt';

class ThemedComponent extends PureComponent {
  static propTypes = {
    theme: PropTypes.shape(
      {
        primaryColor: PropTypes.string.isRequired,
        secondaryColor: PropTypes.string.isRequired
      }
    ).isRequired
  };

  render() {
    const { context } = this.props;
    
    return (
      <div style={{ color: context.theme.primaryColor, backgroundColor: context.theme.secondaryColor }}>
        Hello World!
      </div>
    );
  }
}

const SomeComponent = props => (
  <div {...props}>
    <Inject requires="theme">
      <ThemedComponent/>
    </Inject>
  </div>
);

class App extends PureComponent {
  render() {

    return (
      <div>
        <SomeComponent/>

        <Provider provides={{ theme: { primaryColor: 'red', secondaryColor: 'blue' } }}/>
      </div>
    );
  }
}