# 引用

TTML 提供两种文件引用方式 import 和 include。

## import

`import` 可以在该文件中使用目标文件定义的 `template`。示例配置如下：

1. 在 `item.ttml` 中定义了一个叫 item 的模板（`template`）。

```html

<template name="item">
      <text>{{text}}</text>
    </template>
    ```

2. 在 `index.ttml` 中引用了 `item.ttml`，就可以使用 item 模板。

```html

<import src="item.ttml"/>
    <template is="item" data="{{text: 'forbar'}}"/>
    ```

### import 的作用域

`import` 有作用域的概念，即只能使用 `import` 目标文件中定义的 `template`，而不能使用 `import` 目标文件中 `import` 的 `template`。

例如：C import B，B import A，在 C 中可以使用 B 定义的 template，在 B 中可以使用 A 定义的 template，但是 C 不能使用 A 定义的 template。

```html
<template name="A">
  <text> A template </text>
</template>
```

```html
<import src="a.ttml"/>
<template name="B">
  <text> B template </text>
</template>
```

```html
<import src="b.ttml"/>
<template is="A"/>  
<template is="B"/>
```

## include

`include` 可以将目标文件中，除了 `<template/>` 外的整个代码引入，相当于是拷贝到 `include` 位置。示例配置如下：

```html
<include src="header.ttml"/>
<view> body </view>
<include src="footer.ttml"/>
```

```html
<view> header </view>
```

```html
<view> footer </view>
```