视图

模版引擎

thinkjs里模式使用的模版引擎是ejs，关于ejs的使用文档你可以看这里。

你可以将模版因为修改为jade，也可以是其他的。模版引擎相关的配置如下：

  1. //模版引擎相关的配置
  2. tpl_content_type: "text/html", //模版输出时发送的Content-Type头信息
  3. tpl_file_suffix: ".html", //模版文件名后缀
  4. tpl_file_depr: "_", //controller和action之间的分隔符
  5. tpl_engine_type: "ejs", //模版引擎名称
  6. tpl_engine_config: {}, //这里定义模版引擎需要的一些额外配置，如：修改左右定界符

如果模版引擎使用jade，那么将配置tpl_engine_type改为jade，同时手动安装 jade模块。

如果使用其他的模版引擎，那么需要扩展Template对应的Driver，具体方式请见这里。

模版文件

默认的模版文件路径使用的规则为：

视图目录/分组名/控制器名+控制器与操作之间的分隔符(默认为_)+操作名+模版文件后缀(默认为.html)

如：访问/group/detail?id=10，识别到的分组名为home，控制器名为group，操作名为detail，那么对应的模版文件为：App/View/Home/group_detail.html

变量赋值

如果要在模版中使用变量，必须在控制器中吧变量传递到模版，系统提供了assign方法对模版变量进行赋值。

  1. //单个变量赋值
  2. this.assign("name", "welefen");
  3. //assign除了可以变量赋值，可以进行读取之前赋值过的变量值
  4. var name = this.assign("name");
  5. //多个变量通过一个对象一起赋值
  6. this.assign({
  7.     name: "welefen",
  8.     email: "welefen@gmail.com",
  9.     extra: {
  10.         score: 100
  11.     }
  12. })

注： ejs模版中使用到的变量必须要在控制器里进行赋值，否则会报错。

除了手工进行赋值外，系统默认将所有配置和http对象也赋值到了模版中。模版中可以通过下面的方式获取配置值和http对象值：

  1. config.server_domain //获取配置中server_domain的值
  2. http.get.name //从http对象中获取get参数name的值

模版渲染

模版定义后就可以渲染模版输出，系统也支持直接渲染内容输出，模版赋值必须在模版渲染之前进行。

模版渲染使用display方法，如：

  1. this.display(); //自动识别模版路径
  2. this.display("home:group:list"); //渲染Home/group_list.html模版文件
  3. this.display("/home/welefen/xxx/a.html"); //

模版渲染是一个异步的过程，this.display返回的是一个promise，为了方便错误捕获，需要将这个promise返回。如：

  1. //分组详细页代码示例
  2. detailAction: function(){
  3.     var id = this.get("id");
  4.     var self = this;
  5.     //需要将这个promise返回，系统会自动捕获异常
  6.     //如果进行不return，那么需要额外添加catch来获取异常
  7.     return D('Group').where({id: id}).find().then(function(data){
  8.         self.assign("data", data);
  9.         //将模版渲染返回
  10.         return self.display();
  11.     })
  12. }

获取内容

系统提供了fetch方法来获取渲染后的模版内容，如：

  1. //获取模版内容
  2. this.fetch().then(function(content){
  3.     //content为渲染后的模版内容
  4.     //对content进行额外的过滤和替换操作，然后可以通过this.end(content)进行输出
  5. })