Haxe 附带了一个标准的模板系统,使用被一个轻量的 haxe.Template 类解释的简单的语法。
模板是一个字符串或者一个文件,用来产生任何种类的取决于输入内容的字符串输出。这是一个小的模板例子:
~~~
class Main {
static function main() {
var sample = "My name is <strong>::name::</strong>, <em>::age::</em> years old";
var user = {name:"Mark", age:30};
var template = new haxe.Template(sample);
var output = template.execute(user);
trace(output);
}
}
~~~
控制台会输出 :
~~~
The console will trace My name is Mark, 30 years old.
~~~
## 表达式
* **::name::** 变量名
* **::expr.field::** 字段访问
* **::(expr)::** 表达式 expr 被评估
* **::(e1 op e2)::** 对 e1 和 e2 应用操作符 op
* **::(135)::** 整数 135 。Float类型常量是不允许的
## 条件
可以使用 ::if flag1:: 测试条件。可选地,条件可以使用 ::elseif flag2:: 或者 ::else:: 。关闭条件使用 ::end:: 。
~~~
::if isValid:: valid ::else:: invalid ::end::
~~~
运算符可以被使用,但是不处理运算符优先级。因此需要需要把每个操作放入括号 () 。目前,如下的运算符被允许:+,-,*,/,>,<,>=,<=,==,!=,&&,和 || 。
例如,::((1 + 3) == (2 + 2)):: 会显示 true 。
~~~
::if (points == 10):: Great! ::end::
~~~
要比较一个字符串,使用双引号 " 到模板中。
~~~
::if (name == "Mark"):: Hi Mark ::end::
~~~
## 迭代
通过使用 ::foreach:: 迭代一个结构。结束循环使用 ::end:: 。
~~~
<table>
<tr>
<th>Name</th>
<th>Age</th>
</tr>
::foreach users::
<tr>
<td>::name::</td>
<td>::age::</td>
</tr>
::end::
</table>
~~~
## 子模板
要在一个模板中包括另一个模板,传递子模板结果字符串作为一个参数。
~~~
var users = [{name:"Mark", age:30}, {name:"John", age:45}];
var userTemplate = new haxe.Template("::foreach users:: ::name::(::age::) ::end::");
var userOutput = userTemplate.execute({users: users});
var template = new haxe.Template("The users are ::users::");
var output = template.execute({users: userOutput});
trace(output);
~~~
控制台会输出 :
~~~
The users are Mark(30) John(45).
~~~
## 模板宏
当部分模板被渲染时要调用自定义的函数,提供一个 宏对象到 Template.execute 的参数即可。键会作为模板变量名,值引用一个应该返回字符串的回调函数。这个宏函数的第一个参数总是一个 resolve() 方法,后跟指定的参数。 resolve 函数可以被调用来从模板上下文中取回值。如果宏没有这个字段,结果将是未指定的。
下面的例子传递它本身作为宏函数上下文,并从模板执行 display:
~~~
class Main {
static function main() {
new Main();
}
public function new() {
var user = {name:"Mark", distance:3500};
var sample = "The results: $$display(::user::,::time::)";
var template = new haxe.Template(sample);
var output = template.execute({user:user, time: 15}, this);
trace(output);
}
function display(resolve:String->Dynamic, user:User, time:Int) {
return user.name + " ran " + (user.distance/1000) + " kilometers in " + time + " minutes";
}
}
typedef User = {name:String, distance:Int}
~~~
控制台会输出如下结果:
~~~
Mark ran 3.5 kilometers in 15 minutes.
~~~
## 全局
使用 Template.globals 对象来存储可以被贯穿整个 haxe.Template 实例中应用的值。它的优先级低于 Template.execute 的上下文参数。
## 利用资源
要从代码中分离内容,考虑使用资源嵌入系统(第8.4节)。存放模板内容到一个新的文档,叫做 sample.mtt ,添加 -resource sample.mtt@my_sample 到编译器参数,使用 haxe.Resource.getString 来检索内容。
~~~
class Main {
static function main() {
var sample = haxe.Resource.getString("my_sample");
var user = {name:"Mark", age:30};
var template = new haxe.Template(sample);
var output = template.execute(user);
trace(output);
}
}
~~~
当在服务端运行模板系统,你可以简单的使用 neko.Lib.print 或者 php.Lib.print ,而不是使用 trace 来显示 HTML 模板给用户。
查看 Template API 详细了解它的方法。
- 空白目录
- 1.Haxe介绍
- 1.1.Haxe是什么
- 1.2.关于本文档
- 1.2.1.作者及贡献者
- 1.2.2.License
- 1.3Hello World
- 1.4.Haxe的历史
- 2.类型
- 2.1.基本类型
- 2.1.1.数值类型
- 2.1.2.溢出
- 2.1.3.数值运算符
- 2.1.4.Bool类型
- 2.1.5.Void类型
- 2.2.为空性
- 2.2.1.可选参数和为空性
- 2.3.类实例
- 2.3.1.类的构造函数
- 2.3.2.继承
- 2.3.3.接口
- 2.4.枚举实例
- 2.4.1.Enum构造函数
- 2.4.2.使用枚举
- 2.5.匿名结构
- 2.5.1.结构值的JSON形式
- 2.5.2. 结构类型的类记法
- 2.5.3.可选字段
- 2.5.4.性能影响
- 2.6.函数类型
- 2.6.1.可选参数
- 2.6.2.默认值
- 2.7.动态类型
- 2.7.1.Dynamic使用类型参数
- 2.7.2.实现Dynamic
- 2.8.抽象类型
- 2.8.1.隐式类型转换
- 2.8.2.运算符重载
- 2.8.3.数组访问
- 2.8.4.选择函数
- 2.8.5.枚举抽象类型
- 2.8.6.转发抽象类型字段
- 2.8.7.核心类型抽象
- 2.9.单形
- 3.类型系统
- 3.1.Typedef
- 3.1.1.扩展
- 3.2.类型参数
- 3.2.1.约束
- 3.3.泛型
- 3.3.1.泛型类型参数解释
- 3.4.变异
- 3.5.统一
- 3.5.1.类/接口 之间
- 3.5.2.结构子类型化
- 3.5.3.单形
- 3.5.4.函数返回
- 3.5.5.通用基本类型
- 3.6.类型推断
- 3.6.1.由上而下推断
- 3.6.2.局限
- 3.7.模块和路径
- 3.7.1.模块子类型
- 3.7.2.Import
- 3.7.3.解析顺序
- 4.类字段
- 4.1.变量
- 4.2.属性
- 4.2.1.常见访问标识符组合
- 4.2.2.对类型系统的影响
- 4.2.3.getter和setter的规则
- 4.3.方法
- 4.3.1.重写方法
- 4.3.2.变异和访问修饰符的影响
- 4.4.访问修饰符
- 4.4.1.可见性
- 4.4.2.Inline
- 4.4.3.Dynamic
- 4.4.4.Override
- 4.4.5.Static
- 5.表达式
- 5.1.块
- 5.2.常量
- 5.3.二元操作符
- 5.4.一元操作符
- 5.5.数组声明
- 5.6.对象声明
- 5.7.字段访问
- 5.8.数组访问
- 5.9.函数调用
- 5.10.var
- 5.11.局部函数
- 5.12.new
- 5.13.for
- 5.14.while
- 5.15.do-while
- 5.16.if
- 5.17.switch
- 5.18.try/catch
- 5.19.return
- 5.20.break
- 5.21.continue
- 5.22.throw
- 5.23.类型转换
- 5.23.1.不安全转换
- 5.23.2.安全转换
- 5.24.类型检查
- 6.语言特性
- 6.1.条件编译
- 6.2.Externs
- 6.3.静态扩展
- 6.3.1.标准库中的静态扩展
- 6.4.模式匹配
- 6.4.1.介绍
- 6.4.2.枚举匹配
- 6.4.3.变量捕获
- 6.4.4.结构匹配
- 6.4.5.数组匹配
- 6.4.6.Or 模式
- 6.4.7.守护
- 6.4.8.多个值的匹配
- 6.4.9.提取器
- 6.4.10.穷尽性检查
- 6.4.11.无效的模式检查
- 6.5.字符串插值
- 6.6.数组推导
- 6.7.迭代器
- 6.8.函数绑定
- 6.9.元数据
- 6.10.访问控制
- 6.11.内联构造函数
- 7.编译器用法
- 7.1.编译器标记
- 8.编译器功能
- 8.1.内建编译器元数据
- 8.2.无用代码消除
- 8.3.编译器服务
- 8.3.1.概述
- 8.3.2.字段访问完成
- 8.3.3.调用参数完成
- 8.3.4.类型路径完成
- 8.3.5.使用完成
- 8.3.6.位置完成
- 8.3.7.顶级完成
- 8.3.8.完成服务
- 8.4.资源
- 8.4.1.嵌入资源
- 8.4.2.检索文本资源
- 8.4.3.检索二进制资源
- 8.4.4.实现细节
- 8.5.运行时类型信息
- 8.5.1.RTTI 结构
- 8.6.静态分析仪
- 9.宏
- 9.1.宏上下文
- 9.2.参数
- 9.2.1.ExprOf
- 9.2.2.常数表达式
- 9.2.3.其它的参数
- 9.3.具体化
- 9.3.1.表达式具体化
- 9.3.2.类型具体化
- 9.3.3.类具体化
- 9.4.工具
- 9.5.类型构建
- 9.5.1.枚举构建
- 9.5.2.@:autoBuild
- 9.5.3.@:genericBuild
- 9.6.限制
- 9.6.1.Macro-in-Macro
- 9.6.2.静态扩展
- 9.6.3.构建顺序
- 9.6.4.类型参数
- 9.7.初始化宏
- 10.标准库
- 10.1.字符串
- 10.2.数据结构
- 10.2.1.数组
- 10.2.2.向量
- 10.2.3.列表
- 10.2.4.GenericStack
- 10.2.5.Map
- 10.2.6.Option
- 10.3.正则表达式
- 10.3.1.匹配
- 10.3.2.分组
- 10.3.3.替换
- 10.3.4.分割
- 10.3.5.Map
- 10.3.6.实现细节
- 10.4.Math
- 10.4.1.特殊数值
- 10.4.2.数学错误
- 10.4.3.整数数学
- 10.4.4.扩展
- 10.5.Lambda
- 10.6.模板
- 10.7.反射
- 10.8.序列化
- 10.8.1.格式化序列化
- 10.9.Xml
- 10.9.1.开始使用Xml
- 10.9.2.解析Xml
- 10.9.3.编码Xml
- 10.10.Json
- 10.10.1.解析JSON
- 10.10.2.编码JSON
- 10.10.3.实现细节
- 10.11.Input/Output
- 10.12.Sys/sys
- 10.13.远程处理
- 10.13.1.远程连接
- 10.13.2.实现细节
- 10.14.单元测试
- 11.Haxelib
- 11.1.Haxe编译器使用库
- 11.2.haxelib.json
- 11.2.1.版本控制
- 11.2.2.依赖关系
- 11.3.extraParams.hxml
- 11.4.使用Haxelib
- 12.目标平台细节
- 12.1.JavaScript
- 12.1.1.开始使用Haxe/JavaScript
- 12.1.2.使用外部JavaScript库
- 12.1.3.注入原生JavaScript
- 12.1.4.JavaScript untyped函数
- 12.1.5.调试JavaScript
- 12.1.6.JavaScript目标元数据
- 12.1.7.为JavaScript暴露Haxe类
- 12.1.8.使用 require函数加载外部类
- 12.2.Flash
- 12.2.1.开始使用Haxe/Flash
- 12.2.2.嵌入资源
- 12.2.3.使用外部Flash库
- 12.2.4.Flash目标元数据
- 12.3.Neko
- 12.4.PHP
- 12.4.1.开始使用Haxe/PHP
- 12.4.2.PHP untyped函数
- 12.5.C++
- 12.5.1.Using C++定义
- 12.5.2.Using C++ 指针
- 12.6.Java
- 12.7.C#
- 12.8.Python