本文由笔者翻译自官方文档的JSX In Depth,若干案例经过了改写。其实说白了也好像不算太深入,但还是提示了一些可能的盲区。
JSX是为构造React元素方法React.createElement(component, props, ...children)
设计的语法糖。
比方说JSX代码:
<Elem color="red" info="hello">Hello!<Elem/>
用标准的React语法写出来应该是:
React.creatElement({
Elem,
{
color:red,
info:"hello"
},
"Hello!"
});
当没有内容时,根据xml的语法特性,可以加上自闭合标签:
<Elem color="red" info="hello" />
那么React语法是这样:
React.creatElement({
Elem,
{
color:red,
info:"hello"
},
null//啥内容都没有
});
如果你想测试JSX和javascript语法的转换,可以点这里。
特殊的React元素规则
JSX标签的第一部分决定了React元素的类型。
JSX标签首字母必须要大写,这样做实际上声明了:这个标签是一个React元素。
这个React标签被编译成一个直接引用命名的变量,因此,当你使用诸如 < Foo / >
这样的JSX表达式时,Foo
必须在React作用范围内。
必须在React作用范围内
当你用React.createElement
调用JSX, 必须引入React库。
例如,下面的每个import都是必要的——尽管React和CustomButton不是直接从JavaScript引用:
import React from 'react';
import CustomButton from './CustomButton';
function WarningButton() {
// return React.createElement(CustomButton, {color: 'red'}, null);
return <CustomButton color="red" />;
}
如果你不使用javascript打包工具或是不在脚本标签引用,上面这种写法就让你的标签就在React的全局作用范围内了。
JSX支持使用点符号
你也可以在React组件的JSX标签中使用点符号(.
)。 如果你有一个专门用来输出组件的模块,里面塞满了各种React组件,使用点符号调用会很方便。 比方说,如果MyComponents. DatePicker
是一个组件,你可以直接用JSX语法写为:
import React from 'react';
const MyComponents = {
DatePicker: function DatePicker(props) {
return <div>Imagine a {props.color} datepicker here.</div>;
}
}
function BlueDatePicker() {
return <MyComponents.DatePicker color="blue" />;
}
用户自定义的组件首字母必须大写
如果一个React元素以小写字母开头,意味着它是一个内置组件(如< div >或< span >)。结果是把一个字符串诸如“div”或“span”传递给React.createElement
方法。 如果以大写字母开头,比如< Foo / >
编译的结果是:React.createElement(Foo)
,相应地将生成一个自定义的组件,并导入到你的JavaScript文件中。
请以大写字母命名组件。如果你不方便这么做,那就在使用JSX语法前编译一下你的命名,分配一个大写的变量名。
例如,这段代码将不会像预期的那样运行:
import React from 'react';
// 错了,首字母必须大写
function hello(props) {
// 正确!因为div是html自带的标签
return <div>Hello {props.toWhat}</div>;
}
function HelloWorld() {
// 错了,React会把“hello”理解为一个html标签。
return <hello toWhat="World" />;
}
综上,只要把上面代码的hello
改为Hello
就可以了。
在运行时选择标签名
在React元素里面,你不能使用一般的javascript表达式。如果你想使用一个通用表达式来表示元素,先分配一个大写变量名给它。你渲染一个基于props
的组件时,经常会遇到这个问题:
import React from 'react';
import { PhotoStory, VideoStory } from './stories';
const components = {
photo: PhotoStory,
video: VideoStory
};
function Story(props) {
// 错了!JSX不接受表达式
return <components[props.storyType] story={props.story} />;
}
正确的做法是:
...
function Story(props) {
// 对啦。JSX可以接受一个大写开头的变量名
const SpecificStory = components[props.storyType];
return <SpecificStory story={props.story} />;
}
JSX中的props
有几种不同的方式来指定在JSX中的props。
JavaScript表达式
props可以是任何javascript的表达式——但是得用{ }包起来。 例如,在这JSX中:
var a='zzz';
...
<App name={'xxx'+a+'yyy'}/>
App
的props.name
将会计算为xxxzzzyyy
。
if
语句h和for
循环不是javascript的表达式,所以你不可以直接把它们作为props的值。相应地,你可以这样做:
...
var a=null;
if(this.props.b%2===0){
a=<div>偶数</div>
}else{
a=<div>奇数</div>
}
return (
<div>{this.props.b}是{a}</div>
)
...
字符串字面量
只要不是表达式,你就可以直接传递一个字符串作为props,而不没有用花括号包着。 这两个JSX表达式是等价的:
...
<App name="xxx<yyy"/>
//或者这样
<App name={"xxx>yyy"}>
props默认为True
如果你没有给props传值,那它默认值就是true
。如假包换的true。
所以以下两个表达式基本上是等价的
//这样可以
<App name={true}/>
//这样也行
<App name/>
但是第二种用法在ES6语法中容易被混淆为<App name={name}/>
,所以不建议这样用。
传播属性
如果你已经把props作为一个对象,你想用JSX统统添加进组件,你可以使用…
把整个props对象分享出去。 这两个组件是等价的:
//写法1
function App1() {
return <Greeting firstName="Ben" lastName="Hector" />;
}
//写法2:看起来是不是方便了很多呢?
function App2() {
var xxx = {firstName: 'Ben', lastName: 'Hector'};
return <Greeting {...xxx} />;
}
当你构建一个大型的组件盒子,这个方法看起来很好用。但是{...xxx}
方法太暴力了,可能一次性给你的组件传递了许多无关紧要的props——从而导致代码混乱。因此在使用前应该慎重。
JSX的children
JSX表达式中,必然包含一个开始标记和结束标记——开始标签和闭合标签之间的内容是一个特殊的props
——props.children
。有以下几种类型的数据都可以作为children
:
字符串字面量
如果你在开始标记之间放的是一个字符串,那么你的props.children
就是这个字符串——而且还不用打引号。换言之你可以直接塞你需要的html内容:
<App>Hello!</App>
<div>hello!</div>
//看起来和html没区别吧
JSX还可以删除在一行的开始和结束之间的空格。 同时还能删除空白行。 行的相邻标记将被切掉。所以以下写法都一样:
<div>hello world!</div>
<div>hello
world!
</div>
<div>
hello
world!
</div>
JSX组件的子代
在组件嵌套时,基本上你可以尽情地将子组件加进去。这些嵌套的内容都是props.children
。
<MyContainer>
<MyFirstComponent />
<MySecondComponent />
</MyContainer>
//或者这样
<ul>
<li>haha</li>
<li>hehehe</li>
...
</ul>
但为什么说”基本上“呢?只有一个原则需要把握,就是一个React组件只能返回一个顶层对象——要么就用一个div包起来。这是入门时就反复提及的问题。
javascript表达式
javascript表达式用{}
抱起来就可以了。这在遍历方法时非常实用:
var App=React.createClass({
render:function(){
var arr=[];
for(var i=0;i<6;i++){
var content=<li key={i.toString}>我是第{i+1}行</li>
arr.push(content);
}
return (
<ul>{arr}</ul>
);
}
});
函数
通常,JavaScript表达式插入JSX,将被解释为一个字符串,或一个React元素,或一串这些东西。 更有趣的是,props.children
的行为与其它props没什么不同,不仅可以放用来渲染的内容,还可以放函数,方法。 例如,如果你有一个自定义组件,你可以把props.children
作为回调:
var ListTen=React.createClass({
content:function(index){
return (
<div key={index}>这是列表的第{index}项</div>
)
},
render:function(){
return (
<Repeat times={10}>
{this.content}
</Repeat>
);//这里把方法函数content作为一个Repeat组件的props.children
}
});
var Repeat=React.createClass({
render:function(){
var arr=[];
for(var i=0;i<this.props.times;i++){
arr.push(this.props.children(i));
}//每循环一次就调用props.children的方法
return (
<div>{arr}</div>
);
}
});
ReactDOM.render(
<ListTen/>,
document.getElementById('example')
);
可见children可以是任何东西——只要React在渲染之前能够理解它。尽管以上代码思路不太常见,但是只要多尝试,就会发现React的内涵。
布尔值,空对象和未定义将被无视
false
, null
, undefined
还有 true
对children来说都是可以放的。但是这对渲染而言没有意义——React在渲染前简单地把他们忽略掉了。所以你用他们企图改变渲染,什么也得不到:
<div />
<div></div>
<div>{false}</div>
<div>{null}</div>
<div>{true}</div>
看起来好像什么都没有用。但这是条件渲染的基本实现思路:
<div>
{showHeader && <Header />}
<Content />
</div
上面的代码中,如果showHeader
为false,那它将只执行<Header/>
。
此外常见的假值中,0
是可以被渲染的。
<div>
{props.messages.length &&
<MessageList messages={props.messages} />
}
</div>
如上,如果props.messages
不存在,props.messages.length
值就为0,结果0就被渲染进去了。
因此,你最好保证你代码中&&
的前面是一个布尔值——比如props.messages.length>0
就是一个不错的选择。
对于被无视掉的内容,这样写当然是错的:
<div>
true
</div>
对于这个children,你应该这样写——<div>{'true'}</div>
,如果是变量,就用字符串方法把它转一下。