<commit_before>## 写在前面

[Omi框架](https://github.com/AlloyTeam/omi)可以通过在组件上声明 data-* 把属性传递给子节点。
Omi从设计之初，就是往标准的DOM标签的标准传递方式靠齐。比如：

* 下划线自动转驼峰， data-page-index传到子组件就变成this.data.pageIndex
* data-xx 传递到子节点全都变成字符串，如data-page-index="1"到子节点中this.data.pageIndex就是字符串"1"

这样会有什么局限性和问题？如：

* 无法传递JSON
* 无法传递number类型
* 无法传递bool类型

那么支持传递javascript表达式就能解决这些痛点。

废话不多说，来看神器的冒号。

## 冒号标记

看下面例子：

```js
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组件内就可以直接使用。

```js
class Hello extends Omi.Component {

    render() {
      return  `
      <div>
      	<h1>{{user.name}} love {{user.favorite}}.</h1>
      </div>
  		`
    }
}
```

你也可以在hello组件内打印出 this.data.user 试试。

## 传递其他类型

上面的例子展示了传递JSON，其他类型也支持。比如：

```js
 <Hello :data-age="18" />
```
```js
 <Hello :data-xxx="1+1*2/3" />
```
```js
 <Hello :data-is-girl="false" />
```
```js
 <Hello :data-array-test="[1,2,3]" />
```

## 复杂类型

最后给大家看个稍微一丁点复杂的案例:

```js
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  `<commit_msg>update tutorial<commit_after>## 写在前面

[Omi框架](https://github.com/AlloyTeam/omi)可以通过在组件上声明 data-* 把属性传递给子节点。
Omi从设计之初，就是往标准的DOM标签的标准传递方式靠齐。比如：

* 下划线自动转驼峰， data-page-index传到子组件就变成this.data.pageIndex
* data-xx 传递到子节点全都变成字符串，如data-page-index="1"到子节点中this.data.pageIndex就是字符串"1"

这样会有什么局限性和问题？如：

* 无法传递JSON
* 无法传递number类型
* 无法传递bool类型

那么支持传递javascript表达式就能解决这些痛点。

废话不多说，来看神器的冒号。

## 冒号标记

看下面例子：

```js
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组件内就可以直接使用。

```js
class Hello extends Omi.Component {

    render() {
      return  `
      <div>
      	<h1>{{user.name}} love {{user.favorite}}.</h1>
      </div>
  		`
    }
}
```

你也可以在hello组件内打印出 this.data.user 试试。

## 传递其他类型

上面的例子展示了传递JSON，其他类型也支持。比如：

```js
 <Hello :data-age="18" />
```
```js
 <Hello :data-xxx="1+1*2/3" />
```
```js
 <Hello :data-is-girl="false" />
```
```js
 <Hello :data-array-test="[1,2,3]" />
```

当然也支持传递多个值：

```js
 <Hello :data-array-test="[1,2,3]" :data-is-girl="false" :data-age="18"/>
```

当然你也可以使用:data合并到一起：

```js
 <Hello :data="{
                  arrayTest : [1,2,3], 
                  isGirl : false, 
                  age : 19
                }"
/>
```

## 复杂类型

最后给大家看个稍微一丁点复杂的案例:

```js
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  `
{'fraction_non_alphanumeric': 0.18389805965826816, 'fraction_numerical': 0.011004923255140457, 'mean_word_length': 2.7462039045553146, 'pattern_counts': {'":': 0, '<': 35, '<?xml version=': 0, '>': 35, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '485392', 'n_tokens_mistral': 1792, 'n_tokens_neox': 1862, 'n_words': 215}