ReactJS入门(四)—— 组件API

本篇将介绍 React 组件的API,其中主要的几个API我们在第一篇的时候便已介绍过,这里可以做个温故知新。

本篇的代码你也可以在我的Github上获取到。

setState

参数: nextState(object), [callback(function)]

设置 nextState 的某个键(属性)(别忘了我们可以在 shouldComponentUpdate 方法中获取到 nextState 的值来跟当前的 this.state 进行对比),然后下一次 EventLoop 时 this.state 的对应键就会被更新为该设定的值。

通常我们如果希望在某个事件或某个回调中来重新渲染组件(触发UI更新内容),setState 是一个最常用的触发方法,因为我们把UI内容跟state状态直接(或者通过某些条件)绑定在了一起,一旦state发生改变并触动了绑定的逻辑,那么UI内容自然也会跟着变动:

    var Component1 = React.createClass({
        getInitialState: function() {
            return {
                isClick: !1
            }
        },
        componentDidUpdate: function(){
            console.log(‘componentDidUpdate‘)
        },
        clickCb: function() {
            this.setState({
                isClick : !0
            }, function(){
                console.log(this.state.isClick)
            })
        },
        render: function() {
            return (<div onClick={this.clickCb}>
            isClick:{this.state.isClick ? ‘yes‘ : ‘nope‘}
            </div>)
        }
    });
    var div = document.getElementById(‘a‘);
    React.render(
        <Component1 />, div
    );

如上我们通过 state.isClick 来决定div内要显示的内容,而我们点击div时会改变 state.isClick 的状态,从而触发绑定条件更改了div中的内容。

注意这段代码里我们使用了 componentDidUpdate 方法,如第二篇文章中所介绍的,它在组件重新渲染后会立即触发。我们点击 div 之后发现打印顺序是这样的:

即我们在 setState 方法中所定义的回调,它是在组件重新渲染之后才执行的,而不是在我们变更了 nextState 的值之后就立即触发。

replaceState

参数: nextState(object), [callback(function)]

类似于 setState(),但是删除之前所有已存在的 state 键(key),这些键都不在 nextState 中。

这句话怎么理解呢?我们看这个例子:

    var Component1 = React.createClass({
        getInitialState: function() {
            return {
                isClick: !1,
                abc: 1   //注意这里我们初始化了一个 state.abc
            }
        },
        clickCb: function() {
            this.replaceState({
                isClick : !0
            }, function(){
                console.log(this.state)
            })
        },
        render: function() {
            return (<div onClick={this.clickCb}>
            isClick:{this.state.isClick ? ‘yes‘ : ‘nope‘}
            </div>)
        }
    });
    var div = document.getElementById(‘a‘);
    React.render(
        <Component1 />, div
    );

注意我们在 getInitialState 里还额外定义了一个 abc 的 state 属性,但在 replaceState 后再试着打印 this.state,会发现这个 state.abc 已经被删除了(如果换成 setState 则不会被删除)

所以顾名思义,replaceState 就是一个彻底更换掉 state 的方法,寻常使用的时候需要小心使用,避免删掉一些重要的state属性。

forceUpdate

参数: [callback(function)]

顾名思义就是在任何调用的时刻强制渲染组件,例如即使 shouldComponentUpdate 返回了false:

    var Component1 = React.createClass({
        shouldComponentUpdate: function(nextProps, nextState){
            console.log( this.state, nextState );
            this.forceUpdate(function(){
                console.log(‘强制渲染完成‘)
            }); //强制渲染,去掉这行则不会渲染
            return false;
        },
        componentDidUpdate: function(){
            console.log(‘componentDidUpdate‘)
        },
        getInitialState: function() {
            return {
                isClick: !1
            }
        },
        clickCb: function() {
            this.setState({
                isClick : !this.state.isClick
            })
        },
        render: function() {
            return (<div onClick={this.clickCb}>
            isClick:{this.state.isClick ? ‘yes‘ : ‘nope‘}
            </div>)
        }
    });
    var div = document.getElementById(‘a‘);
    var c1 = React.render(
        <Component1 />, div
    );

注意该方法的回调,也是在重新渲染之后才执行的。

另一个使用 forceUpdate 的场景可以是,我们不以 props 或 state 来作为触发渲染的条件,例如使用了一个变量来作为UI内容,在该变量的值改变了且我们希望触发渲染时,可以使用该方法,当然这种形式是不推荐的。

getDOMNode()

返回组件/ReactElement挂载到页面上所对应的DOM元素:

    var Component1 = React.createClass({
        getInitialState: function() {
            return {
                isClick: !1
            }
        },
        clickCb: function() {
            this.setState({
                isClick : !0
            }, function(){
                console.log(this.state.isClick)
            })
        },
        render: function() {
            return (<div onClick={this.clickCb}>
            isClick:{this.state.isClick ? ‘yes‘ : ‘nope‘}
            </div>)
        }
    });
    var div = document.getElementById(‘a‘);
    var c = React.render(
        <Component1 />, div
    );
    console.log(c.getDOMNode())

打印结果:

另外,若 render 返回 null 或者 false 的时候,this.getDOMNode() 将返回 null。

isMounted()

返回一个 Boolean 值,如果组件挂载到了 DOM 中,isMounted() 返回 true。

其适用于异步请求的情景下:

    var Component1 = React.createClass({
        getInitialState: function() {
            return {
                content: ‘hello‘
            }
        },
        componentWillMount: function () {
            doSomething(props).then(function (content) {
                if (this.isMounted()) {
                    this.setState({content: content});
                }
            }.bind(this));
        },
        render: function() {
            if(this.state.isClick){
                return (<div>
                content:{this.state.content}
                </div>)
            } else {
                return false;
            }
        }
    });
    var div = document.getElementById(‘a‘);
    var c = React.render(
        <Component1 />, div
    );

如上代码,我们在 componentWillMount 的时候执行一个异步请求 doSomething,在其获取到服务器数据的时候修改 state 的值,前提是组件已经挂载到页面上。

如果该异步请求完成得很快,我们获取到新content时候组件可能还在处于挂载中(mounting)的过程,那么 state 则保持不变(因为此时 isMounted() 将返回false )。

setProps

参数: nextProps(object), [callback(function)]

跟 setState 类似,不过修改的是 props 罢了:

    var Component1 = React.createClass({
        clickCb: function() {
            this.setProps({
                name : ‘cnBlog‘
            }, function(){
                console.log(this.props)
            })
        },
        render: function() {
            return (<div onClick={this.clickCb}>
                    {this.props.sayhi || ‘www.‘}
                    {this.props.name || ‘nothing‘}
            </div>)
        }
    });
    var div = document.getElementById(‘a‘);
    React.render(
            <Component1 name="VaJoy" sayhi="Hello " />, div
    );

replaceProps

参数: nextProps(object), [callback(function)]

类似于 setProps,会替换掉现有的 props 的键,我们依旧使用上一段代码,不过把 setProps 换成 replaceProps:

    var Component1 = React.createClass({
        clickCb: function() {
            this.replaceProps({
                name : ‘cnBlog‘
            }, function(){
                console.log(this.props)
            })
        },
        render: function() {
            return (<div onClick={this.clickCb}>
                    {this.props.sayhi || ‘www.‘}
                    {this.props.name || ‘nothing‘}
            </div>)
        }
    });
    var div = document.getElementById(‘a‘);
    React.render(
            <Component1 name="VaJoy" sayhi="Hello " />, div
    );

我们这时再点击组件,会发现 props.sayHi 已被删除了:

Refs

事实上这个不属于组件的方法,但也是在组件中常用的一个小技巧,故在这里做介绍。

我们在前面提到,可以使用 ReactClass.getDOMNode() 的方法来获取到组件渲染在页面上的DOM节点,但是如果我们希望获取到的,是组件中的某个DOM元素呢?

这时候我们可以使用定义 refs 的形式,来方便我们获取对应的元素:

    var Component1 = React.createClass({
        clickCb: function(e) {
            if(e.target === this.refs.li2.getDOMNode()){
                alert(‘你点到第二个LI了‘)
            }
        },
        render: function() {
            return (<ul onClick={this.clickCb}>
                <li>1</li>
                <li ref="li2">2</li>
                <li>3</li>
            </ul>)
        }
    });
    var div = document.getElementById(‘a‘);
    React.render(
            <Component1 />, div
    );

如上我们给组件中的第二个<li>绑定了一个 ref 属性,值为“li2”,这意味着我们可以在组件中以 this.refs.li2 的形式来获取到该ReactElement。

然后绑定点击事件,在点击的时候判断被点击的 li 元素是否等于 this.refs.li2.getDOMNode(),是的话则弹出alert。

官方也给出了一个实用的demo:

  var App = React.createClass({
    getInitialState: function() {
      return {userInput: ‘‘};
    },
    handleChange: function(e) {
      this.setState({userInput: e.target.value});
    },
    clearAndFocusInput: function() {
      // Clear the input
      this.setState({userInput: ‘‘}, function() {
        // 组件重绘后会立即执行这句代码:
        this.refs.theInput.getDOMNode().focus();   // input成功聚焦(focus)
      });
    },
    render: function() {
      return (
        <div>
          <div onClick={this.clearAndFocusInput}>
            Click to Focus and Reset
          </div>
          <input
            ref="theInput" //我们可以在组件里以 this.refs.theInput 获取到它
            value={this.state.userInput}
            onChange={this.handleChange}
          />
        </div>
      );
    }
  });

到此位置我们便基本入门了 React 的大部分主要的API,后续我们将以项目实践的形式来进一步学习React。

共勉~!

时间: 2024-10-12 14:32:27

ReactJS入门(四)—— 组件API的相关文章

ReactJS入门3:组件的生命周期

本文主要介绍组件的生命周期. 组建的生命周期主要分为3个:Mounting.Updating.Unmounting. 1. Mounting:组件被加载到DOM     在本阶段,主要有三个方法: 1.1 getInitialState():object 设置初始状态 1.2 componentWillMount() Mounting发生前调用 1.3 componentDidMount() Mounting发生后调用.该方法主要用于请求DOM节点的初始化. 2.Updating:DOM更新,组

reactjs入门到实战(六)---- ReactJS组件API详解

全局的api 1.React.createClass 创建一个组件类,并作出定义.组件实现了 render() 方法,该方法返回一个子级.该子级可能包含很深的子级结构.组件与标准原型类的不同之处在于,你不需要使用 new 来实例化. 组件是一种很方便的封装,可以(通过 new )为你创建后台实例. 2.React.createElement ReactElement createElement( string/ReactClass type, [object props], [children

CK2020微信小程序入门与实战 常用组件API开发技巧项目实战

新年伊始,学习要趁早,点滴记录,学习就是进步! 随笔背景:在很多时候,很多入门不久的朋友都会问我:我是从其他语言转到程序开发的,有没有一些基础性的资料给我们学习学习呢,你的框架感觉一下太大了,希望有个循序渐进的教程或者视频来学习就好了.对于学习有困难不知道如何提升自己可以加扣:1225462853  获取资料. 下载地址:https://pan.baidu.com/s/1hsU5EIS 微信小程序入门与实战 常用组件API开发技巧项目实战 小程序官方正式公告,开放了更多的入口,个人开发者可以申请

ReactJS入门(三)—— 顶层API

本文基本跟着官方文档把API都走一遍,但会有实例来解释应该怎么用,木有比我更详细的API文档咯. React.createClass 参数:CONFIG(object) 创建一个ReactClass(组件类),参数是一个对象且必须带有 render 属性方法,该方法必须返回一个封闭的容器(容器内可以有其它不限结构的容器)或 null/false(表示啥都不渲染): var Component = React.createClass({ render: function() { return th

一看就懂的ReactJs入门教程(精华版)

现在最热门的前端框架有AngularJS.React.Bootstrap等.自从接触了ReactJS,ReactJs的虚拟DOM(Virtual DOM)和组件化的开发深深的吸引了我,下面来跟我一起领略ReactJS的风采吧~~ 章有点长,耐心读完,你会有很大收获哦~ 一.ReactJS简介 React 起源于 Facebook 的内部项目,因为该公司对市场上所有 JavaScript MVC 框架,都不满意,就决定自己写一套,用来架设 Instagram 的网站.做出来以后,发现这套东西很好用

ReactJS入门教程

一.ReactJS简介 React 起源于 Facebook 的内部项目,因为该公司对市场上所有 JavaScript MVC 框架,都不满意,就决定自己写一套,用来架设 Instagram 的网站.做出来以后,发现这套东西很好用,就在2013年5月开源了.由于 React 的设计思想极其独特,属于革命性创新,性能出众,代码逻辑却非常简单.所以,越来越多的人开始关注和使用,认为它可能是将来 Web 开发的主流工具. ReactJS官网地址:http://facebook.github.io/re

一看就懂的ReactJs入门教程-精华版

现在最热门的前端框架有AngularJS.React.Bootstrap等.自从接触了ReactJS,ReactJs的虚拟DOM(Virtual DOM)和组件化的开发深深的吸引了我,下面来跟我一起领略ReactJs的风采吧~~ 文章有点长,耐心读完,你会有很大收获哦~  一.ReactJS简介 React 起源于 Facebook 的内部项目,因为该公司对市场上所有 JavaScript MVC 框架,都不满意,就决定自己写一套,用来架设 Instagram 的网站.做出来以后,发现这套东西很

ReactJs入门教程-精华版

现在最热门的前端框架有AngularJS.React.Bootstrap等.自从接触了ReactJS,ReactJs的虚拟DOM(Virtual DOM)和组件化的开发深深的吸引了我,下面来跟我一起领略ReactJs的风采吧~~ 文章有点长,耐心读完,你会有很大收获哦~ 一.ReactJS简介 React 起源于 Facebook 的内部项目,因为该公司对市场上所有 JavaScript MVC 框架,都不满意,就决定自己写一套,用来架设 Instagram 的网站.做出来以后,发现这套东西很好

一看就懂的ReactJs入门教程-精华版-转载

传送门:http://www.cnblogs.com/yunfeifei/p/4486125.html 现在最热门的前端框架有AngularJS.React.Bootstrap等.自从接触了ReactJS,ReactJs的虚拟DOM(Virtual DOM)和组件化的开发深深的吸引了我,下面来跟我一起领略ReactJs的风采吧~~ 文章有点长,耐心读完,你会有很大收获哦~  一.ReactJS简介 React 起源于 Facebook 的内部项目,因为该公司对市场上所有 JavaScript M

ReactJS入门二

ReactJS入门学习二 ReactJS入门学习二 阅读目录 React的背景和基本原理 理解React.render() 什么是JSX? 为什么要使用JSX? JSX的语法 如何在JSX中如何使用事件 如何在JSX中如何使用样式 回到顶部 React的背景和基本原理 在web开发中,我们总需要将变化的数据实时反应到UI上,这时就需要对DOM进行操作,复杂或频繁的对DOM操作是性能瓶颈产生的原因,React为此引入了虚拟的DOM的机制,在浏览器端使用javascript实现了一套DOM API,