bind-component-handlers v1.0.5

Bind Component Handlers

automatically bind change handlers to react components

Installation

npm install bind-component-handlers

Reasoning

A typical react component has many change handlers i.e. controlled input tags.

There are several ways to bind such handlers, this is a way that enforces convention and ease of use.

Motivation

There are two ways of binding a react handler:

1. Binding in the constructor.
2. Binding in the JSX prop with babel's onClick={ ::this.handleClick } or arrow function onClick={ (e) => this.handleClick(e) }

The second is considered bad practice because it creates a new function on every render and therefore javascript ends up doing more garbage collection than necessary.

Use

The module takes in a class, and a context this and binds any function that starts with the word handle. Therefore, it enforces a small naming convention in your react components and it doesn't bind every method in your class.

import react, { Component } from 'react';
import bindComponentHandlers from 'bind-component-handlers';

class MyComponent extends Component {
  constructor(props) {
    super(props);
    bindComponentHandlers(MyComponent, this);

    this.state = { inputVal: '' };
  }

  render() {
    const { inputVal } = this.state;

    return (
      <input onChange={ this.handleInputChange } value={ inputVal } />
    );
  }

  handleInputChange(event) {
    this.setState({ inputVal: event.currentTarget.value });
  }
}

export default MyComponent;