深入 JSX

实际上,JSX 仅仅只是 React.createElement(component, props, ...children) 函数的语法糖。如下 JSX 代码:

  1. <MyButton color="blue" shadowSize={2}>
  2. Click Me
  3. </MyButton>

会编译为:

  1. React.createElement(
  2. MyButton,
  3. {color: 'blue', shadowSize: 2},
  4. 'Click Me'
  5. )

如果没有子节点,你还可以使用自闭合的标签形式,如:

  1. <div className="sidebar" />

会编译为:

  1. React.createElement(
  2. 'div',
  3. {className: 'sidebar'}
  4. )

如果你想测试一些特定的 JSX 会转换成什么样的 JavaScript,你可以尝试使用 在线的 Babel 编译器

指定 React 元素类型

JSX 标签的第一部分指定了 React 元素的类型。

大写字母开头的 JSX 标签意味着它们是 React 组件。这些标签会被编译为对命名变量的直接引用,所以,当你使用 JSX <Foo /> 表达式时,Foo 必须包含在作用域内。

React 必须在作用域内

由于 JSX 会编译为 React.createElement 调用形式,所以 React 库也必须包含在 JSX 代码作用域内。

例如,在如下代码中,虽然 ReactCustomButton 并没有被直接使用,但还是需要导入:

  1. import React from 'react';import CustomButton from './CustomButton';
  2. function WarningButton() {
  3. // return React.createElement(CustomButton, {color: 'red'}, null); return <CustomButton color="red" />;
  4. }

如果你不使用 JavaScript 打包工具而是直接通过 <script> 标签加载 React,则必须将 React 挂载到全局变量中。

在 JSX 类型中使用点语法

在 JSX 中,你也可以使用点语法来引用一个 React 组件。当你在一个模块中导出许多 React 组件时,这会非常方便。例如,如果 MyComponents.DatePicker 是一个组件,你可以在 JSX 中直接使用:

  1. import React from 'react';
  2. const MyComponents = {
  3. DatePicker: function DatePicker(props) {
  4. return <div>Imagine a {props.color} datepicker here.</div>;
  5. }
  6. }
  7. function BlueDatePicker() {
  8. return <MyComponents.DatePicker color="blue" />;}

用户定义的组件必须以大写字母开头

以小写字母开头的元素代表一个 HTML 内置组件,比如 <div> 或者 <span> 会生成相应的字符串 'div' 或者 'span' 传递给 React.createElement(作为参数)。大写字母开头的元素则对应着在 JavaScript 引入或自定义的组件,如 <Foo /> 会编译为 React.createElement(Foo)

我们建议使用大写字母开头命名自定义组件。如果你确实需要一个以小写字母开头的组件,则在 JSX 中使用它之前,必须将它赋值给一个大写字母开头的变量。

例如,以下的代码将无法按照预期运行:

  1. import React from 'react';
  2. // 错误!组件应该以大写字母开头:function hello(props) { // 正确!这种 <div> 的使用是合法的,因为 div 是一个有效的 HTML 标签
  3. return <div>Hello {props.toWhat}</div>;
  4. }
  5. function HelloWorld() {
  6. // 错误!React 会认为 <hello /> 是一个 HTML 标签,因为它没有以大写字母开头: return <hello toWhat="World" />;}

要解决这个问题,我们需要重命名 helloHello,同时在 JSX 中使用 <Hello />

  1. import React from 'react';
  2. // 正确!组件需要以大写字母开头:function Hello(props) { // 正确! 这种 <div> 的使用是合法的,因为 div 是一个有效的 HTML 标签:
  3. return <div>Hello {props.toWhat}</div>;
  4. }
  5. function HelloWorld() {
  6. // 正确!React 知道 <Hello /> 是一个组件,因为它是大写字母开头的: return <Hello toWhat="World" />;}

在运行时选择类型

你不能将通用表达式作为 React 元素类型。如果你想通过通用表达式来(动态)决定元素类型,你需要首先将它赋值给大写字母开头的变量。这通常用于根据 prop 来渲染不同组件的情况下:

  1. import React from 'react';
  2. import { PhotoStory, VideoStory } from './stories';
  3. const components = {
  4. photo: PhotoStory,
  5. video: VideoStory
  6. };
  7. function Story(props) {
  8. // 错误!JSX 类型不能是一个表达式。 return <components[props.storyType] story={props.story} />;}

要解决这个问题, 需要首先将类型赋值给一个大写字母开头的变量:

  1. import React from 'react';
  2. import { PhotoStory, VideoStory } from './stories';
  3. const components = {
  4. photo: PhotoStory,
  5. video: VideoStory
  6. };
  7. function Story(props) {
  8. // 正确!JSX 类型可以是大写字母开头的变量。 const SpecificStory = components[props.storyType]; return <SpecificStory story={props.story} />;}

JSX 中的 Props

有多种方式可以在 JSX 中指定 props。

JavaScript 表达式作为 Props

你可以把包裹在 {} 中的 JavaScript 表达式作为一个 prop 传递给 JSX 元素。例如,如下的 JSX:

  1. <MyComponent foo={1 + 2 + 3 + 4} />

MyComponent 中,props.foo 的值等于 1 + 2 + 3 + 4 的执行结果 10

if 语句以及 for 循环不是 JavaScript 表达式,所以不能在 JSX 中直接使用。但是,你可以用在 JSX 以外的代码中。比如:

  1. function NumberDescriber(props) {
  2. let description;
  3. if (props.number % 2 == 0) { description = <strong>even</strong>; } else { description = <i>odd</i>; } return <div>{props.number} is an {description} number</div>;
  4. }

你可以在对应的章节中学习更多关于条件渲染循环的内容。

字符串字面量

你可以将字符串字面量赋值给 prop. 如下两个 JSX 表达式是等价的:

  1. <MyComponent message="hello world" />
  2. <MyComponent message={'hello world'} />

当你将字符串字面量赋值给 prop 时,它的值是未转义的。所以,以下两个 JSX 表达式是等价的:

  1. <MyComponent message="&lt;3" />
  2. <MyComponent message={'<3'} />

这种行为通常是不重要的,这里只是提醒有这个用法。

Props 默认值为 “True”

如果你没给 prop 赋值,它的默认值是 true。以下两个 JSX 表达式是等价的:

  1. <MyTextBox autocomplete />
  2. <MyTextBox autocomplete={true} />

通常,我们不建议不传递 value 给 prop,因为这可能与 ES6 对象简写混淆,{foo}{foo: foo} 的简写,而不是 {foo: true}。这样实现只是为了保持和 HTML 中标签属性的行为一致。

属性展开

如果你已经有了一个 props 对象,你可以使用展开运算符 ... 来在 JSX 中传递整个 props 对象。以下两个组件是等价的:

  1. function App1() {
  2. return <Greeting firstName="Ben" lastName="Hector" />;
  3. }
  4. function App2() {
  5. const props = {firstName: 'Ben', lastName: 'Hector'};
  6. return <Greeting {...props} />;}

你还可以选择只保留当前组件需要接收的 props,并使用展开运算符将其他 props 传递下去。

  1. const Button = props => {
  2. const { kind, ...other } = props; const className = kind === "primary" ? "PrimaryButton" : "SecondaryButton";
  3. return <button className={className} {...other} />;
  4. };
  5. const App = () => {
  6. return (
  7. <div>
  8. <Button kind="primary" onClick={() => console.log("clicked!")}>
  9. Hello World!
  10. </Button>
  11. </div>
  12. );
  13. };

在上述例子中,kind 的 prop 会被安全的保留,它将不会被传递给 DOM 中的 <button> 元素。 所有其他的 props 会通过 ...other 对象传递,使得这个组件的应用可以非常灵活。你可以看到它传递了一个 onClickchildren 属性。

属性展开在某些情况下很有用,但是也很容易将不必要的 props 传递给不相关的组件,或者将无效的 HTML 属性传递给 DOM。我们建议谨慎的使用该语法。

JSX 中的子元素

包含在开始和结束标签之间的 JSX 表达式内容将作为特定属性 props.children 传递给外层组件。有几种不同的方法来传递子元素:

字符串字面量

你可以将字符串放在开始和结束标签之间,此时 props.children 就只是该字符串。这对于很多内置的 HTML 元素很有用。例如:

  1. <MyComponent>Hello world!</MyComponent>

这是一个合法的 JSX,MyComponent 中的 props.children 是一个简单的未转义字符串 "Hello world!"。因此你可以采用编写 HTML 的方式来编写 JSX。如下所示:

  1. <div>This is valid HTML &amp; JSX at the same time.</div>

JSX 会移除行首尾的空格以及空行。与标签相邻的空行均会被删除,文本字符串之间的新行会被压缩为一个空格。因此以下的几种方式都是等价的:

  1. <div>Hello World</div>
  2. <div>
  3. Hello World
  4. </div>
  5. <div>
  6. Hello
  7. World
  8. </div>
  9. <div>
  10. Hello World
  11. </div>

JSX 子元素

子元素允许由多个 JSX 元素组成。这对于嵌套组件非常有用:

  1. <MyContainer>
  2. <MyFirstComponent />
  3. <MySecondComponent />
  4. </MyContainer>

你可以将不同类型的子元素混合在一起,因此你可以将字符串字面量与 JSX 子元素一起使用。这也是 JSX 类似 HTML 的一种表现,所以如下代码是合法的 JSX 并且也是合法的 HTML:

  1. <div>
  2. Here is a list:
  3. <ul>
  4. <li>Item 1</li>
  5. <li>Item 2</li>
  6. </ul>
  7. </div>

React 组件也能够返回存储在数组中的一组元素:

  1. render() {
  2. // 不需要用额外的元素包裹列表元素!
  3. return [
  4. // 不要忘记设置 key :)
  5. <li key="A">First item</li>,
  6. <li key="B">Second item</li>,
  7. <li key="C">Third item</li>,
  8. ];
  9. }

JavaScript 表达式作为子元素

JavaScript 表达式可以被包裹在 {} 中作为子元素。例如,以下表达式是等价的:

  1. <MyComponent>foo</MyComponent>
  2. <MyComponent>{'foo'}</MyComponent>

这对于展示任意长度的列表非常有用。例如,渲染 HTML 列表:

  1. function Item(props) {
  2. return <li>{props.message}</li>;}
  3. function TodoList() {
  4. const todos = ['finish doc', 'submit pr', 'nag dan to review'];
  5. return (
  6. <ul>
  7. {todos.map((message) => <Item key={message} message={message} />)} </ul>
  8. );
  9. }

JavaScript 表达式也可以和其他类型的子元素组合。这种做法可以方便地替代模板字符串:

  1. function Hello(props) {
  2. return <div>Hello {props.addressee}!</div>;}

函数作为子元素

通常,JSX 中的 JavaScript 表达式将会被计算为字符串、React 元素或者是列表。不过,props.children 和其他 prop 一样,它可以传递任意类型的数据,而不仅仅是 React 已知的可渲染类型。例如,如果你有一个自定义组件,你可以把回调函数作为 props.children 进行传递:

  1. // 调用子元素回调 numTimes 次,来重复生成组件
  2. function Repeat(props) {
  3. let items = [];
  4. for (let i = 0; i < props.numTimes; i++) { items.push(props.children(i));
  5. }
  6. return <div>{items}</div>;
  7. }
  8. function ListOfTenThings() {
  9. return (
  10. <Repeat numTimes={10}>
  11. {(index) => <div key={index}>This is item {index} in the list</div>} </Repeat>
  12. );
  13. }

你可以将任何东西作为子元素传递给自定义组件,只要确保在该组件渲染之前能够被转换成 React 理解的对象。这种用法并不常见,但可以用于扩展 JSX。

布尔类型、Null 以及 Undefined 将会忽略

false, null, undefined, and true 是合法的子元素。但它们并不会被渲染。以下的 JSX 表达式渲染结果相同:

  1. <div />
  2. <div></div>
  3. <div>{false}</div>
  4. <div>{null}</div>
  5. <div>{undefined}</div>
  6. <div>{true}</div>

这有助于依据特定条件来渲染其他的 React 元素。例如,在以下 JSX 中,仅当 showHeadertrue 时,才会渲染 <Header /> 组件:

  1. <div>
  2. {showHeader && <Header />} <Content />
  3. </div>

值得注意的是有一些 “falsy” 值,如数字 0,仍然会被 React 渲染。例如,以下代码并不会像你预期那样工作,因为当 props.messages 是空数组时,0 仍然会被渲染:

  1. <div>
  2. {props.messages.length && <MessageList messages={props.messages} />
  3. }
  4. </div>

要解决这个问题,确保 && 之前的表达式总是布尔值:

  1. <div>
  2. {props.messages.length > 0 && <MessageList messages={props.messages} />
  3. }
  4. </div>

反之,如果你想渲染 falsetruenullundefined 等值,你需要先将它们转换为字符串

  1. <div>
  2. My JavaScript variable is {String(myVariable)}.</div>