```
{@ expression } 返回的 undefined 和 null 意外的任何值，都会 toString() 后输出。 遇到 undefined，null 不会输出任何内容，当中空字符串处理。
## 注释
由于 {@ expression } 不会将 undefined 强转成字符串 "undefind" 输出，所以可以用以下格式作为模板上的注释：
{@ /* same words here */ }
## 比较大小
在标签属性中使用“<”或“>” 这两个符号，会干扰 htmlparser 的解析，被误判为标签的边界符号。
可以使用模板预定义变量 $helper 提供的几个比较函数，例如
```html
... ...
```
## $model
你可以在模板中使用预定义变量 $model 来访问 model 中的变量，例如：
```html
{@ $model.message || "hello world !!! (from template)"}
```
当你在模板中使用一个不存在的变量时，模板引擎会抛出异常，并停止执行；但是访问不存在的属性是安全的，当你不确定变量是否存在时，可以使用 $model 。
## $helper
最好不要在模板中调用函数，因为蜂巢的模板是可以在浏览器中渲染的，但是无法保证你的函数在前端可用。
## 内置的标签
# 标签
* ___<if>___
* condition， 条件表达式。如果 condiition 属性不是以@开始，会当做字符串而不是表达式。
* ___<elseif>___
* condition，条件表达式
* ___<else>___
* ___<loop>___
* start(可选)，循环开始值，默认:1
* end，循环结束值
* step(可选)，循环步长，默认:1
* var(可选)，循环变量的变量名
只有参数 end 是必须的。
```javascript
第 {@i} 次循环。
```
* ___<foreach>___
* for, 对象或数组，需要用@开头，表示该属性是一个表达式
* key(可选), 元素键名
* var(可选), 元素指针变量的名称
```javascript
{@key} = {@item}
```
* ___<continue>___
* ___<break>___
* ___<include>___
* file 可以是表示模板文件路径的普通字符串，也可以使用@开头，使用一个表达式，表达式的结果当做模板文件的路径
* model(可选)，引用的模板文件，和当前模板文件的 model 是分离的，当前模板文件中的变量在 include 模板中无法访问，需用用 model 属性传给被引用的模板。
```javascript
```
* ___<view>___
模板文件中的 <view> 标签用于指定子视图的显示位置。
* name(可选), 子视图的名称，默认为"*"，表示所有未指定位置的子视图，通常用于 layout 视图。
* mode(可选), 可用值为： "unuse", "week", "soft"(默认), "hard", 优先级由低到高。 同一个视图，被多个 指定，mode值的优先级高的生效。 <view> 的属性 name="*" 时，mode 的默认值为 "unuse"，name为其他值时，mode的默认值为 "soft"。所以，<view>（或 <view name="*">）时，只有未被指定位置的视图，会被安置在<view>所在位置。
* ___<msg>___
* 显示 nut.message() 创建的消息，如果模板中没有 <msg> 标签，这些消息会被自动放到视图的前部。
---
# 视图
模板通常做为控制器的视图使用，每个控制器拥有一个视图。
控制器加载模板的机制是：
1. 检查是否存在 view 属性，将 view 作为模板文件的路径
2. 如果没有 view 属性，则检查控制器所在目录内有无同名的 html 文件，例如控制器 hello.js 会自动加载 hello.html 做为视图模板。
3. 也没有同名的 html ，则控制器使用一个空模板
## 视图事件 "viewIn" 和 "viewOut"
可以在控制器里，为视图定义事件函数：`viewIn`, `viewOut` 。当网页打开时触发所有视图的 `viewIn` 事件；`pjax`更新网页上的视图时，触发新视图的`viewIn`，和被替换的视图的`viewOut`。
```javascript
module.exports = {
view: "example/templates/hello.html"
, process: function()
{
return true ;
}
, viewIn: function()
{
// 可以使用 require 载入服务器上的js文件，但该文件必须注册为 ship down
var foo = require("./bar.js") ;
$("div.sameclass").html("hi, this message come from viewIn function") ;
}
, viewOut: function()
{
// 在浏览器的控制器打印
console.log("im leaving") ;
}
}
```
在控制器中定义 `viewIn` 和 `viewOut` 事件函数，需要注意的是：
1. 闭包变量是无效的。蜂巢只是将 `viewIn` 和 `viewOut` 这两个函数复制到客户端，重新解释执行，因此无法在这两个函数中访问闭包变量。例如：
```javascript
var foo = "bar" ;
module.exports = {
process: function()
{
// foo 变量有效
console.log( foo ) ;
return true ;
}
// viewIn 函数会复制到浏览器里重新解释执行
, viewIn: function()
{
// foo 变量未定义
console.log( foo ) ;
}
}
```
2. 可以使用 jQuery ，但是 $ 被做了限制，selector 只能在视图内部查找元素。这是因为蜂巢的控制器是可以组合的，同一个控制器的视图能在网页上出现多次。这种情况下，如果 jQuery 在整个网页范围内查找元素，那么操作的元素，总是第一个视图里的。
于是，蜂巢对 `viewIn` 和 `viewOut` 这两个闭包环境上的 $ 做了限制：只在视图范围内查找元素，不会误影响到视图以外的元素。如果需要对视图外的元素操作，可以使用 jQuery 变量，不过，视图之间的访问，我建议使用jQuery的自定义事件，以避免耦合。
3. 可以在视图事件函数里使用 require 加载其它文件，这些文件会随着事件函数一起 ship down 到浏览器执行，因此这些文件需要事先声明为 shippable 。
通常在 extension.js 文件的 onload 函数里声明 shippable ：
文件：example/extension.js
```javascript
module.exports.onload = function(){
// 声明一个路径下的所有文件，均可以 shipdown 到浏览器
$opencomb.shipper.registerAllowFolder(path_prefix) ;
// 注册一个正则表达式，匹配该表达式的文件路径，均可以shipdown 到浏览器
$opencomb.shipper.registerAllowFilter(regexp) ;
}
```
[返回文档首页](../../README.md)