在 Taro 中,我们使用 JSX 作为一种 DSL 进而编译成各端通用的语法。 JSX 是一种看起来很像 XML 的 JavaScript 语法扩展,比起模板语言,它具有以下优点:
- 各大编辑器和 IDE 都能提供非常良好的支持;
- 可以做到类型安全,在编译期就能发现错误;
- 提供语义化并且可以移动的标签;
- 背后的社区支持非常强力;如果你是一名新手的话,可能一开始学习一种新语法会产生一些抵触。但当你熟悉了之后,就能发现 JSX 更符合程序语言的书写逻辑,在处理一些精细复杂需求的时候也会比模板语言更为得心应手。
使用 JSX
请观察以下代码:
import Taro, { Component } from '@tarojs/taro'
import { View } from '@tarojs/components'
class Home extends Component {
render () {
return (
<View>Hello World!</View>
)
}
}
必须声明 Taro 和组件
在这段代码中,大写开头的 JSX 标签 View
表示它是一个 Taro 组件,尽管在整段代码中,变量 View
看起来并没有被调用,但也必须从 @tarojs/components
中引入声明。变量 Taro
也是一个必须引入声明的变量,因为我们在编译期和运行时会依赖这个变量做一些特殊处理。当你引入了组件时,一定要使用,不要出现没有使用的变量。
当你只用支持微信小程序时,可以不用引入组件例如
View
这样的声明。但我们仍然强烈推荐你在顶部引入你将要使用的组件,这样编辑器/IDE 能更好地提前发现可能出现的问题,也为将来可能需要的多端转换留有余地。
首字母大写与驼峰式命名
在 Taro 中,所有组件都应当首字母大写并且使用大驼峰式命名法(Camel-Case)。
例如,下面的代码将无法按预期运行:
import Taro, { Component } from '@tarojs/taro'
// 引入一个自定义组件组件
import home_page from './page'
// 错误!组件名应该首字母大写:
class App extends Component {
render () {
return (
<home_page message="Hello World!" />
)
}
}
为了解决这个问题,我们将 home_page
重命名为 HomePage
,然后使用 <HomePage />
引用:
import Taro, { Component } from '@tarojs/taro'
// 引入一个自定义组件组件
import HomePage from './page'
class App extends Component {
render () {
return (
<HomePage message="Hello World!" />
)
}
}
和 React/Nerv 不一样的地方在于,Taro 不支持使用
点表示法
和运行时指定类型来引用组件,例如<MyComponents.DatePicker />
这样的写法在 Taro 中是无法正确编译的。
属性
在 JSX 中有几种不同的方式来指定属性。
使用 JavaScript 表达式
你可以任意地在 JSX 当中使用 JavaScript 表达式,在 JSX 当中的表达式要包含在大括号里。例如,在这个 JSX 中:
<MyComponent foo={1 + 2 + 3 + 4} />
对于 MyComponent 来说, props.foo 的值为 10,这是 1 + 2 + 3 + 4 表达式计算得出的。
if 语句和 for 循环在 JavaScript 中不是表达式,因此它们不能直接在 JSX 中使用,所以你可以将它们放在周围的代码中。
import Taro, { Component } from '@tarojs/taro'
class App extends Components {
render () {
let description
if (this.props.number % 2 == 0) {
description = <Text>even</Text>
} else {
description = <Text>odd</Text>
}
return <View>{this.props.number} is an {description} number</View>
}
}
字符串常量
你可以将字符串常量作为属性值传递。下面这两个 JSX 表达式是等价的:
<MyComponent message="hello world" />
<MyComponent message={'hello world'} />
默认为 True
如果你没有给属性传值,它默认为 true。因此下面两个 JSX 是等价的:
<MyTextBox autocomplete />
<MyTextBox autocomplete={true} />
和 React/Nerv 的不同:React 可以使用
…
拓展操作符来传递属性,但在 Taro 中你不能这么做。例如:
const props = {firstName: 'Plus', lastName: 'Second'}return <Greeting {…props} />
这样的操作会报错。你只能手动地把所有需要引用的 props 写上去:
<Greeting firstName="Plus" lastName="Second" />
嵌套
如果 JSX 标签是闭合式的,那么你需要在结尾处用 />
, 就好像 XML/HTML 一样:
const element = <Image src={user.avatarUrl} />;
JSX 标签同样可以相互嵌套:
const element = (
<View>
<Text>Hello!</Text>
<Text>Good to see you here.</Text>
</View>
)
JavaScript 表达式也可以嵌套:
render () {
const todos = ['finish doc', 'submit pr', 'nag dan to review'];
return (
<ul>
{todos.map((todo) => <Text>{todo}</Text>)}
</ul>
)
}
布尔值、Null 和 Undefined 被忽略
false
、null
、undefined
和 true
都是有效的 children,但它们不会直接被渲染。下面的表达式是等价的:
<View />
<View></View>
<View>{false}</View>
<View>{null}</View>
<View>{undefined}</View>
<View>{true}</View>
这在根据条件来确定是否渲染 元素时非常有用。以下的 JSX 只会在 showHeader 为 true 时渲染 <Header />
组件。
<View>
{showHeader && <Header />}
<Content />
</View>