本文出自《React Native学习笔记》系列文章。
React Native是基于React的,在开发React Native过程中少不了的需要用到React方面的知识。虽然官方也有相应的Document,但篇幅比较多,学起来比较枯燥。 通过《React Native之React速学教程》你可以对React有更系统和更深入的认识。为了方便大家学习,我将《React Native之React速学教程》分为上、中、下三篇,大家可以根据需要进行阅读学习。
本篇为《React Native之React速学教程》的第一篇。本篇将从React的特点、如何使用React、JSX语法、组件(Component)以及组件的属性,状态等方面进行讲解。
React是一个用于组建用户界面的JavaScript库,让你以更简单的方式来创建交互式用户界面。
不是模板却比模板更加灵活:
心得:上图是GitHub Popular的首页截图,这个页面是通过不同的组件组装而成的,组件化的开发模式,使得代码在更大程度上的到复用,而且组件之间对的组装很灵活。
使用React之前需要在页面引入如下js库 。
上面一共列举了三个库: react.js 、react-dom.js 和 browser.min.js ,它们必须首先加载。其中,react.js 是 React 的核心库,react-dom.js 是提供与 DOM 相关的功能,browser.min.js 的作用是将 JSX 语法转为 JavaScript 语法,这一步很消耗时间,实际上线的时候,应该将它放到服务器完成。
你可以从React官网下载这些库,也可以将其下载到本地去使用。
心得:在做React Native开发时,这些库作为React Native核心库已经被初始化在node_modules目录下,所以不需要单独下载。
解压从上述地址下载的压缩包,在根目录中创建一个包含以下内容的 “helloworld.html” 。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
<!DOCTYPE html> <<span class="pl-ent">html</span>> <<span class="pl-ent">head</span>> <<span class="pl-ent">meta</span> <span class="pl-e">charset</span>=<span class="pl-s"><span class="pl-pds">"</span>UTF-8<span class="pl-pds">"</span></span> /> <<span class="pl-ent">title</span>>Hello React!</<span class="pl-ent">title</span>> <<span class="pl-ent">script</span> <span class="pl-e">src</span>=<span class="pl-s"><span class="pl-pds">"</span>build/react.js<span class="pl-pds">"</span></span>><span class="pl-s1"><</span>/<span class="pl-ent">script</span>> <<span class="pl-ent">script</span> <span class="pl-e">src</span>=<span class="pl-s"><span class="pl-pds">"</span>build/react-dom.js<span class="pl-pds">"</span></span>><span class="pl-s1"><</span>/<span class="pl-ent">script</span>> <<span class="pl-ent">script</span> <span class="pl-e">src</span>=<span class="pl-s"><span class="pl-pds">"</span>https://npmcdn.com/babel-core@5.8.38/browser.min.js<span class="pl-pds">"</span></span>><span class="pl-s1"><</span>/<span class="pl-ent">script</span>> </<span class="pl-ent">head</span>> <<span class="pl-ent">body</span>> <<span class="pl-ent">div</span> <span class="pl-e">id</span>=<span class="pl-s"><span class="pl-pds">"</span>example<span class="pl-pds">"</span></span>></<span class="pl-ent">div</span>> <<span class="pl-ent">script</span> <span class="pl-e">type</span>=<span class="pl-s"><span class="pl-pds">"</span>text/babel<span class="pl-pds">"</span></span>> <span class="pl-s1"> <span class="pl-smi">ReactDOM</span>.<span class="pl-en">render</span>(</span> <span class="pl-s1"> <span class="pl-k"><</span>h1<span class="pl-k">></span>Hello, world<span class="pl-k">!</span><span class="pl-k"><</span><span class="pl-k">/</span>h1<span class="pl-k">></span>,</span> <span class="pl-s1"> <span class="pl-c1">document</span>.<span class="pl-c1">getElementById</span>(<span class="pl-s"><span class="pl-pds">'</span>example<span class="pl-pds">'</span></span>)</span> <span class="pl-s1"> );</span> <span class="pl-s1"><</span>/<span class="pl-ent">script</span>> </<span class="pl-ent">body</span>> </<span class="pl-ent">html</span>> |
在 JavaScript 代码里写着 XML 格式的代码称为 JSX,下文会介绍。为了把 JSX 转成标准的 JavaScript,我们用<script type="text/babel">
标签,然后通过Babel转换成在浏览器中真正执行的内容。
ReactDOM.render 是 React 的最基本方法,用于将模板转为 HTML 语言,并插入指定的 DOM 节点。
1 2 3 4 |
ReactDOM.render( <<span class="pl-ent">h1</span>>Hello, world!</<span class="pl-ent">h1</span>>, document.getElementById('example') ); |
上述代码的作用是将<h1>Hello, world!</h1>
插入到元素id为example的容器中。
JSX 是一个看起来很像 XML 的 JavaScript 语法扩展。 每一个XML标签都会被JSX转换工具转换成纯JavaScript代码,使用JSX,组件的结构和组件之间的关系看上去更加清晰。
JSX并不是React必须使用的,但React官方建议我们使用 JSX , 因为它能定义简洁且我们熟知的包含属性的树状结构语法。
Usage:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
React.render(//使用JSX <<span class="pl-ent">div</span>> <<span class="pl-ent">div</span>> <<span class="pl-ent">div</span>>content</<span class="pl-ent">div</span>> </<span class="pl-ent">div</span>> </<span class="pl-ent">div</span>>, document.getElementById('example') ); React.render(//不使用JSX React.createElement('div', null, React.createElement('div', null, React.createElement('div', null, 'content') ) ), document.getElementById('example') ); |
React 可以渲染 HTML 标签 (strings) 或 React 组件 (classes)。
要渲染 HTML 标签,只需在 JSX 里使用小写字母开头的标签名。
1 2 |
var myDivElement = <<span class="pl-ent">div</span> <span class="pl-e">className</span>=<span class="pl-s"><span class="pl-pds">"</span>foo<span class="pl-pds">"</span></span> />; React.render(myDivElement, document.body); |
要渲染 React 组件,只需创建一个大写字母开头的本地变量。
1 2 3 |
var MyComponent = React.createClass({/*...*/}); var myElement = <<span class="pl-ent">MyComponent</span> <span class="pl-e">someProperty</span>=<span class="pl-s">{true}</span> />; React.render(myElement, document.body); |
提示:
- React 的 JSX 里约定分别使用首字母大、小写来区分本地组件的类和 HTML 标签。
- 由于 JSX 就是 JavaScript,一些标识符像 class 和 for 不建议作为 XML 属性名。作为替代, React DOM 使用 className 和 htmlFor 来做对应的属性。
要使用 JavaScript 表达式作为属性值,只需把这个表达式用一对大括号 ({}) 包起来,不要用引号 ("")。
1 2 3 4 5 6 7 |
// 输入 (JSX): var person = <<span class="pl-ent">Person</span> <span class="pl-e">name</span>=<span class="pl-s">{window.isLoggedIn</span> ? <span class="pl-e">window</span>.<span class="pl-e">name</span> : <span class="pl-s"><span class="pl-pds">'</span><span class="pl-pds">'</span></span>} />; // 输出 (JS): var person = React.createElement( Person, {name: window.isLoggedIn ? window.name : ''} ); |
同样地,JavaScript 表达式可用于描述子结点:
1 2 3 4 5 6 7 8 |
// 输入 (JSX): var content = <<span class="pl-ent">Container</span>>{window.isLoggedIn ? <<span class="pl-ent">Nav</span> /> : <<span class="pl-ent">Login</span> />}</<span class="pl-ent">Container</span>>; // 输出 (JS): var content = React.createElement( Container, null, window.isLoggedIn ? React.createElement(Nav) : React.createElement(Login) ); |
JSX 里添加注释很容易;它们只是 JS 表达式而已。你只需要在一个标签的子节点内(非最外层)用 {} 包围要注释的部分。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
class ReactDemo extends Component { render() { return ( <<span class="pl-ent">View</span> <span class="pl-e">style</span>=<span class="pl-s">{styles.container}</span>> {/*标签子节点的注释*/} <<span class="pl-ent">Text</span> <span class="pl-e">style</span>=<span class="pl-s">{styles.welcome}</span> //<span class="pl-e">textAlign</span>=<span class="pl-s"><span class="pl-pds">'</span>right<span class="pl-pds">'</span></span> <span class="pl-e">textShadowColor</span>=<span class="pl-s"><span class="pl-pds">'</span>yellow<span class="pl-pds">'</span></span> /*<span class="pl-e">color</span>=<span class="pl-s"><span class="pl-pds">'</span>red<span class="pl-pds">'</span></span> <span class="pl-e">textShadowRadius</span>=<span class="pl-s"><span class="pl-pds">'</span>1<span class="pl-pds">'</span></span>*/ > React Native! </<span class="pl-ent">Text</span>> </<span class="pl-ent">View</span>> ); } } |
心得:在标签节点以外注释,和通常的注释是一样的,多行用“/**/” 单行用“//”;
不推荐做法:
1 2 3 |
var component = <<span class="pl-ent">Component</span> />; component.props.foo = x; // 不推荐 component.props.bar = y; // 不推荐 |
这样修改组件的属性,会导致React不会对组件的属性类型(propTypes)进行的检查。从而引发一些预料之外的问题。
推荐做法:
1 |
var component = <<span class="pl-ent">Component</span> <span class="pl-e">foo</span>=<span class="pl-s">{x}</span> <span class="pl-e">bar</span>=<span class="pl-s">{y}</span> />; |
你可以使用 JSX 的新特性 – 延展属性:
1 2 3 4 |
var props = {}; props.foo = x; props.bar = y; var component = <<span class="pl-ent">Component</span> {...<span class="pl-e">props</span>} />; |
传入对象的属性会被复制到组件内。
它能被多次使用,也可以和其它属性一起用。注意顺序很重要,后面的会覆盖掉前面的。
1 2 3 |
var props = { foo: 'default' }; var component = <<span class="pl-ent">Component</span> {...<span class="pl-e">props</span>} <span class="pl-e">foo</span>=<span class="pl-s">{</span><span class="pl-s"><span class="pl-pds">'</span>override<span class="pl-pds">'</span></span>} />; console.log(component.props.foo); // 'override' |
上文出现的… 标记被叫做延展操作符(spread operator)已经被 ES6 数组 支持。
React 允许将代码封装成组件(component),然后像插入普通 HTML 标签一样,在网页中插入这个组件。
1 2 3 4 5 6 7 8 9 |
var HelloMessage = React.createClass({ render: function() { return <<span class="pl-ent">h1</span>>Hello {this.props.name}</<span class="pl-ent">h1</span>>; } }); ReactDOM.render( <<span class="pl-ent">HelloMessage</span> <span class="pl-e">name</span>=<span class="pl-s"><span class="pl-pds">"</span>John<span class="pl-pds">"</span></span> />, document.getElementById('example') ); |
上面代码中,变量 HelloMessage 就是一个组件类。模板插入 <HelloMessage />
时,会自动生成 HelloMessage 的一个实例。所有组件类都必须有自己的 render 方法,用于输出组件。
注意
我们可以通过this.props.xx
的形式获取组件对象的属性,对象的属性可以任意定义,但要避免与JavaScript关键字冲突。
this.props.children
会返回组件对象的所有属性。
React 提供一个工具方法 React.Children 来处理 this.props.children 。我们可以用 React.Children.map
或React.Children.forEach
来遍历子节点。
React.Children.map
1 |
array React.Children.map(object children, function fn [, object thisArg]) |
该方法会返回一个array。
React.Children.forEach
1 |
React.Children.forEach(object children, function fn [, object thisArg]) |
Usage:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
var NotesList = React.createClass({ render: function() { return ( <<span class="pl-ent">ol</span>> { React.Children.map(this.props.children, function (child) { return <<span class="pl-ent">li</span>>{child}</<span class="pl-ent">li</span>>; }) } </<span class="pl-ent">ol</span>> ); } }); ReactDOM.render( <<span class="pl-ent">NotesList</span>> <<span class="pl-ent">span</span>>hello</<span class="pl-ent">span</span>> <<span class="pl-ent">span</span>>world</<span class="pl-ent">span</span>> </<span class="pl-ent">NotesList</span>>, document.body ); |
组件的属性可以接受任意值,字符串、对象、函数等等都可以。有时,我们需要一种机制,验证别人使用组件时,提供的参数是否符合要求。
组件类的PropTypes属性,就是用来验证组件实例的属性是否符合要求。
1 2 3 4 5 6 7 8 |
var MyTitle = React.createClass({ propTypes: { title: React.PropTypes.string.isRequired, }, render: function() { return <<span class="pl-ent">h1</span>> {this.props.title} </<span class="pl-ent">h1</span>>; } }); |
上面的Mytitle组件有一个title属性。PropTypes 告诉 React,这个 title 属性是必须的,而且它的值必须是字符串。现在,我们设置 title 属性的值是一个数值。
1 2 3 4 5 |
var data = 123; ReactDOM.render( <<span class="pl-ent">MyTitle</span> <span class="pl-e">title</span>=<span class="pl-s">{data}</span> />, document.body ); |
这样一来,title属性就通不过验证了。控制台会显示一行错误信息。
Warning: Failed propType: Invalid prop
title
of type number
supplied to MyTitle
, expected string
.
更多的PropTypes设置,可以查看官方文档。
此外,getDefaultProps 方法可以用来设置组件属性的默认值。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
var MyTitle = React.createClass({ getDefaultProps : function () { return { title : 'Hello World' }; }, render: function() { return <<span class="pl-ent">h1</span>> {this.props.title} </<span class="pl-ent">h1</span>>; } }); ReactDOM.render( <<span class="pl-ent">MyTitle</span> />, document.body ); |
上面代码会输出"Hello World"
。
组件并不是真实的 DOM 节点,而是存在于内存之中的一种数据结构,叫做虚拟 DOM (virtual DOM)。只有当它插入文档以后,才会变成真实的 DOM 。根据 React 的设计,所有的 DOM 变动,都先在虚拟 DOM 上发生,然后再将实际发生变动的部分,反映在真实 DOM上,这种算法叫做 DOM diff ,它可以极大提高网页的性能表现。
但是,有时需要从组件获取真实 DOM 的节点,这时就要用到 ref 属性。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
var MyComponent = React.createClass({ handleClick: function() { this.refs.myTextInput.focus(); }, render: function() { return ( <<span class="pl-ent">div</span>> <<span class="pl-ent">input</span> <span class="pl-e">type</span>=<span class="pl-s"><span class="pl-pds">"</span>text<span class="pl-pds">"</span></span> <span class="pl-e">ref</span>=<span class="pl-s"><span class="pl-pds">"</span>myTextInput<span class="pl-pds">"</span></span> /> <<span class="pl-ent">input</span> <span class="pl-e">type</span>=<span class="pl-s"><span class="pl-pds">"</span>button<span class="pl-pds">"</span></span> <span class="pl-e">value</span>=<span class="pl-s"><span class="pl-pds">"</span>Focus the text input<span class="pl-pds">"</span></span> <span class="pl-e">onClick</span>=<span class="pl-s">{this.handleClick}</span> /> </<span class="pl-ent">div</span>> ); } }); ReactDOM.render( <<span class="pl-ent">MyComponent</span> />, document.getElementById('example') ); |
上面代码中,组件 MyComponent 的子节点有一个文本输入框,用于获取用户的输入。这时就必须获取真实的 DOM 节点,虚拟 DOM 是拿不到用户输入的。为了做到这一点,文本输入框必须有一个 ref 属性,然后 this.refs.[refName] 就会返回这个真实的 DOM 节点。
需要注意的是,由于 this.refs.[refName] 属性获取的是真实 DOM ,所以必须等到虚拟 DOM 插入文档以后,才能使用这个属性,否则会报错。上面代码中,通过为组件指定 Click 事件的回调函数,确保了只有等到真实 DOM 发生 Click 事件之后,才会读取 this.refs.[refName] 属性。
React 组件支持很多事件,除了 Click 事件以外,还有 KeyDown 、Copy、Scroll 等,完整的事件清单请查看官方文档。
ref属性不仅接受string类型的参数,而且它还接受一个function作为callback。这一特性让开发者对ref的使用更加灵活。
1 2 3 4 5 6 7 8 9 10 |
<span class="pl-en">render</span><span class="pl-k">:</span> <span class="pl-k">function</span>() { <span class="pl-k">return</span> ( <span class="pl-k"><</span>TextInput ref<span class="pl-k">=</span>{<span class="pl-k">function</span>(<span class="pl-smi">input</span>) { <span class="pl-k">if</span> (input <span class="pl-k">!=</span> <span class="pl-c1">null</span>) { <span class="pl-smi">input</span>.<span class="pl-c1">focus</span>(); } }} <span class="pl-k">/</span><span class="pl-k">></span> ); }, |
在ES6中我们可以使用箭头函数来为组件的ref设置一个callback。
1 2 3 4 5 6 |
<span class="pl-en">render</span>() { <span class="pl-k">return</span> <span class="pl-k"><</span>TextInput ref<span class="pl-k">=</span>{(<span class="pl-smi">c</span>) <span class="pl-k">=></span> <span class="pl-c1">this</span>.<span class="pl-smi">_input</span> <span class="pl-k">=</span> c} <span class="pl-k">/</span><span class="pl-k">></span>; }, <span class="pl-en">componentDidMount</span>() { <span class="pl-c1">this</span>.<span class="pl-smi">_input</span>.<span class="pl-c1">focus</span>(); }, |
需要提醒大家的是,只有在组件的render方法被调用时,ref才会被调用,组件才会返回ref。如果你在调用this.refs.xx时render方法还没被调用,那么你得到的是undefined。
心得:ref属性在开发中使用频率很高,使用它你可以获取到任何你想要获取的组件的对象,有个这个对象你就可以灵活地做很多事情,比如:读写对象的变量,甚至调用对象的函数。
上文讲到了props,因为每个组件只会根据props 渲染了自己一次,props 是不可变的。为了实现交互,可以使用组件的 state 。this.state 是组件私有的,可以通过getInitialState()
方法初始化,通过调用 this.setState()
来改变它。当 state 更新之后,组件就会重新渲染自己。
render() 方法依赖于 this.props 和 this.state ,框架会确保渲染出来的 UI 界面总是与输入( this.props 和 this.state )保持一致。
通过getInitialState()
方法初始化state,在组件的生命周期中仅执行一次,用于设置组件的初始化 state 。
1 2 3 |
getInitialState:function(){ return {favorite:false}; } |
通过this.setState()
方法来更新state,调用该方法后,React会重新渲染相关的UI。
this.setState({favorite:!this.state.favorite});
Usage:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
var FavoriteButton=React.createClass({ getInitialState:function(){ return {favorite:false}; }, handleClick:function(event){ this.setState({favorite:!this.state.favorite}); }, render:function(){ var text=this.state.favorite? 'favorite':'un favorite'; return ( <<span class="pl-ent">div</span> <span class="pl-e">type</span>=<span class="pl-s"><span class="pl-pds">'</span>button<span class="pl-pds">'</span></span> <span class="pl-e">onClick</span>=<span class="pl-s">{this.handleClick}</span>> You {text} this. Click to toggle. </<span class="pl-ent">div</span>> ); } }); |
上面代码是一个 FavoriteButton 组件,它的 getInitialState 方法用于定义初始状态,也就是一个对象,这个对象可以通过 this.state 属性读取。当用户点击组件,导致状态变化,this.setState 方法就修改状态值,每次修改以后,自动调用 this.render 方法,再次渲染组件。
心得:由于 this.props 和 this.state 都用于描述组件的特性,可能会产生混淆。一个简单的区分方法是,this.props 表示那些一旦定义,就不再改变的特性,而 this.state 是会随着用户互动而产生变化的特性。
React’s official site
React on ES6+