Passing Functions to Components

如何将事件处理程序(比如onClick)传递给组件?

可以将事件处理程序和其他函数作为props传递给子组件:

<button onClick={this.handleClick}>

如果需要在事件处理程序中访问父组件,同样需要把该函数绑定到组件实例(参见下文)。

如何将函数绑定到组件实例?

有以下几种方式可以确保函数可以访问this.propsthis.state这样的属性,取决于使用的语法和构建步骤。

在Constructor中绑定(ES2015)

class Foo extends Component {
  constructor(props) {
    super(props);
    this.handleClick = this.handleClick.bind(this);
  }
  handleClick() {
    console.log('Click happened');
  }
  render() {
    return <button onClick={this.handleClick}>Click Me</button>;
  }
}

类属性(第三阶段提案)

class Foo extends Component {
  // Note: this syntax is experimental and not standardized yet.
  handleClick = () => {
    console.log('Click happened');
  }
  render() {
    return <button onClick={this.handleClick}>Click Me</button>;
  }
}

在Render中使用bind绑定

class Foo extends Component {
  handleClick() {
    console.log('Click happened');
  }
  render() {
    return <button onClick={this.handleClick.bind(this)}>Click Me</button>;
  }
}

注意:

在render方法中使用Function.prototype.bind会在每次组件渲染时创建一个新的函数,可能会影响性能(参见下文)

在Render中使用箭头函数

class Foo extends Component {
  handleClick() {
    console.log('Click happened');
  }
  render() {
    return <button onClick={() => this.handleClick()}>Click Me</button>;
  }
}

注意:

在render方法中使用箭头函数也会在每次组件渲染时创建一个新的函数,可能会影响性能(参见下文)

可以在render方法中使用箭头函数吗?

一般来说是可以的,并且直接箭头函数是向回调函数传递参数的最简单的办法。

但是如果遇到了性能问题,一定要进行优化!

为什么绑定是必要的?

在JavaScript中,以下两种写法是不一样的:

obj.method();
var method = obj.method;
method();

bind方法确保了第二种写法与第一种写法相同。

在React中,通常需要绑定传递给其他组件的方法。例如,要将this.handleClick传递给<button onClick={this.handleClick}>,所以需要bind函数。但是,没有必要绑定render方法或生命周期函数:因为并没有将它们传递给其他的组件。

This post by Yehuda Katz详细解释了什么是绑定,和函数在JavaScript中怎么起作用。

为什么每次组件渲染时函数都会被调用?

确保每次将函数传递给组件时没有调用它:

render() {
  // Wrong: handleClick is called instead of passed as a reference!
  return <button onClick={this.handleClick()}>Click Me</button>
}

而是仅仅传递了函数本身(不加括号):

render() {
  // Correct: handleClick is passed as a reference!
  return <button onClick={this.handleClick}>Click Me</button>
}

怎样为事件处理程序或回调函数传递参数?

可以使用箭头函数包裹事件处理程序,并传递参数:

<button onClick={() => this.handleClick(id)} />

以上代码和调用.bind是相同的:

<button onClick={this.handleClick.bind(this, id)} />

示例:通过箭头函数传递参数

const A = 65 // ASCII character code

class Alphabet extends React.Component {
  constructor(props) {
    super(props);
    this.handleClick = this.handleClick.bind(this);
    this.state = {
      justClicked: null,
      letters: Array.from({length: 26}, (_, i) => String.fromCharCode(A + i)).
    };
  }
  handleClick(letter) {
    this.setState({ justClicked: letter });
  }
  render() {
    return (
      <div>
        Just clicked: {this.state.justClicked}
        <ul>
          {this.state.letters.map(letter =>
            <li key={letter} onClick={() => this.handleClick(letter)}>
              {letter}
            </li>
          )}
        </ul>
      </div>
    )
  }
}

示例:通过data-属性传递参数

同样的,也可以使用DOM API来存储事件处理程序需要的数据。如果需要优化大量元素或使用依赖于React.PureComponent相等性检查的渲染树,请考虑使用此方法。

const A = 65 // ASCII character code

class Alphabet extends React.Component {
  constructor(props) {
    super(props);
    this.handleClick = this.handleClick.bind(this);
    this.state = {
      justClicked: null,
      letters: Array.from({length: 26}, (_, i) => String.fromCharCode(A + i))
    };
  }

  handleClick(e) {
    this.setState({
      justClicked: e.target.dataset.letter
    });
  }

  render() {
    return (
      <div>
        Just clicked: {this.state.justClicked}
        <ul>
          {this.state.letters.map(letter =>
            <li key={letter} data-letter={letter} onClick={this.handleClick}>
              {letter}
            </li>
          )}
        </ul>
      </div>
    )
  }
}

怎样避免函数被调用太快或者太多次?

例如想要防止onClick或者onScroll这样的事件处理程序的回调被触发的太快,那么可以限制执行回调的速度,可以通过以下几种方式做到这点:

可以看这个比较throttledebounce可视化页面

注意:

_.debounce , _.throttleraf-schd 都提供了一个 cancel方法来取消延迟回调。 所以需要调用componentWillUnmount,或者对代码进行检查来保证在延迟函数有效期间内组件始终挂载。

Throttle(节流)

节流是阻止函数在给定时间内被多次调用。下面这个例子会阻止“click”事件每秒钟的多次调用。

import throttle from 'lodash.throttle';

class LoadMoreButton extends React.Component {
  constructor(props) {
    super(props);
    this.handleClick = this.handleClick.bind(this);
    this.handleClickThrottled = throttle(this.handleClick, 1000);
  }

  componentWillUnmount() {
    this.handleClickThrottled.cancel();
  }

  render() {
    return <button onClick={this.handleClickThrottled}>Load More</button>;
  }

  handleClick() {
    this.props.loadMore();
  }
}

Debounce(防抖)

防抖确保函数上次执行后的一段时间内,不会再次执行。当必须进行一些昂贵的计算来响应快速派发的事件时(比如鼠标滚动或键盘事件时),防抖是非常有用的。下面这个例子以250ms的延迟来改变文本输入。

import debounce from 'lodash.debounce';

class Searchbox extends React.Component {
  constructor(props) {
    super(props);
    this.handleChange = this.handleChange.bind(this);
    this.emitChangeDebounced = debounce(this.emitChange, 250);
  }

  componentWillUnmount() {
    this.emitChangeDebounced.cancel();
  }

  render() {
    return (
      <input
        type="text"
        onChange={this.handleChange}
        placeholder="Search..."
        defaultValue={this.props.value}
      />
    );
  }

  handleChange(e) {
    // React pools events, so we read the value before debounce.
    // Alternately we could call `event.persist()` and pass the entire event.
    // For more info see reactjs.org/docs/events.html#event-pooling
    this.emitChangeDebounced(e.target.value);
  }

  emitChange(value) {
    this.props.onChange(value);
  }
}

requestAnimationFrame节流

requestAnimationFrame是在浏览器中排队等待执行的一种方法,它可以在呈现性能的最佳时间执行。一个函数被requestAnimationFrame放入队列后将会在下一帧触发。浏览器会努力确保每秒60帧(60fps)。然而,如果浏览器无法确保,那么自然会限制每秒的帧数。例如,某个设备可能只能处理每秒30帧,所以每秒只能得到30帧。使用requestAnimationFrame来节流是一种有用的技术,它可以防止在一秒中进行60帧以上的更新。如果要求一秒钟内完成100次更新,则会为浏览器创建额外的负担,而用户无法看到这些工作(不能区别每秒100帧和60帧的区别)。

注意:

使用这个方法时只能获取帧中最后发布的值。也可以在MDN中看优化的示例。

import rafSchedule from 'raf-schd';

class ScrollListener extends React.Component {
  constructor(props) {
    super(props);

    this.handleScroll = this.handleScroll.bind(this);

    // Create a new function to schedule updates.
    this.scheduleUpdate = rafSchedule(
      point => this.props.onScroll(point)
    );
  }

  handleScroll(e) {
    // When we receive a scroll event, schedule an update.
    // If we receive many updates within a frame, we'll only publish the latest value.
    this.scheduleUpdate({ x: e.clientX, y: e.clientY });
  }

  componentWillUnmount() {
    // Cancel any pending updates since we're unmounting.
    this.scheduleUpdate.cancel();
  }

  render() {
    return (
      <div
        style={{ overflow: 'scroll' }}
        onScroll={this.handleScroll}
      >
        <img src="/my-huge-image.jpg" />
      </div>
    );
  }
}

测试速率限制

在测试速率限制的代码是否正确工作的时候,如果可以(对动画或操作)进行快进将会很有帮助。如果正在使用jest,那么可以使用mock timers来快进。如果正在使用requestAnimationFrame节流,那么就会发现raf-stub是一个控制动画帧的十分有用的工具。