写在前面
Omi 框架可以通过在组件上声明 data-* 把属性传递给子节点。
Omi 从设计之初，就是往标准的 DOM 标签的标准传递方式靠齐。比如：
- 下划线自动转驼峰， data-page-index 传到子组件就变成 this.data.pageIndex
- data-xx 传递到子节点全都变成字符串，如 data-page-index="1"到子节点中 this.data.pageIndex 就是字符串"1"
这样会有什么局限性和问题？如： -
无法传递 JSON
- 无法传递 number 类型
- 无法传递 bool 类型
那么支持传递 javascript 表达式就能解决这些痛点。
废话不多说，来看神器的冒号。
冒号标记
看下面例子：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
import Hello from 'hello.js' Omi.makeHTML('Hello', Hello); class App extends Omi.Component { render() { return ` <div> <Hello :data-user="{ name : 'Dntzhang', favorite : 'Omi' }" /> </div> ` } } Omi.render(new App(),"#container") |
在 data-user 前面加上冒号即:data-user，就代表传递的是 js 表达式，够方便吧。
然后在 Hello 组件内就可以直接使用。
|
1 2 3 4 5 6 7 8 9 10 11 |
class Hello extends Omi.Component { render() { return ` <div> <h1>{{user.name}} love {{user.favorite}}.</h1> </div> ` } } |
你也可以在 hello 组件内打印出 this.data.user 试试。
传递其他类型
上面的例子展示了传递 JSON，其他类型也支持。比如：
|
1 2 |
<Hello :data-age="18" /> |
|
1 2 |
<Hello :data-xxx="1+1*2/3" /> |
|
1 2 |
<Hello :data-is-girl="false" /> |
|
1 2 |
<Hello :data-array-test="[1,2,3]" /> |
当然也支持传递多个值：
|
1 2 |
<Hello :data-array-test="[1,2,3]" :data-is-girl="false" :data-age="18"/> |
当然你也可以使用:data 合并到一起：
|
1 2 3 4 5 6 7 |
<Hello :data="{ arrayTest : [1,2,3], isGirl : false, age : 19 }" /> |
复杂类型
最后给大家看个稍微一丁点复杂的案例:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 |
class Hello extends Omi.Component { handleClick(evt){ alert( this.data.arrayTest[0].name) } render() { return ` <ul> {{#arrayTest}} <li onclick="handleClick">{{name}}</li> {{/arrayTest}} </ul> `; } } Omi.makeHTML('Hello', Hello); class App extends Omi.Component { render() { return ` <div> <Hello :data-array-test="[{name:'dntzhang'},{name:'omi'},{name:'AlloyTeam'}]" /> </div> `; } } Omi.render(new App(),"#container"); |
当然，在子组件中，你也可以不使用 mustache.js 模板引擎的语法去遍历，使用 ES6+的姿势去遍历。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
class Hello extends Omi.Component { render() { return ` <ul> ${this.data.arrayTest.map(item => `<li>${item.name}</li>` ).join('')} </ul> `; } } |
这也是为什么 omi 提供了两个版本，omi.js 和 omi.lite.js 的原因。omi.lite.js 不包含 mustache.js 模板引擎。
在线演示
- http://alloyteam.github.io/omi/website/redirect.html?type=exp
- http://alloyteam.github.io/omi/website/redirect.html?type=exp_arr
相关
- Omi 的 Github 地址 https://github.com/AlloyTeam/omi
- 如果想体验一下 Omi 框架，可以访问 Omi Playground
- 如果想使用 Omi 框架或者开发完善 Omi 框架，可以访问 Omi 使用文档
- 如果你想获得更佳的阅读体验，可以访问 Docs Website
- 如果你懒得搭建项目脚手架，可以试试 omi-cli
- 如果你有 Omi 相关的问题可以 New issue
- 如果想更加方便的交流关于 Omi 的一切可以加入 QQ 的 Omi 交流群 (256426170)
