迷你MVVM框架 avalonjs 学习教程13、模板引用

稍为复杂一点的网站都是多个前端工程师合作而成，因此分工是必需的。简单一点的分工就是一个人负责一个频道，某个页面是由一个人全部做的；但如果涉及到一个页面非常复杂，需要多个人同时动工呢？于是到模板的出场时间了。

模板有两种，一种是嵌入到页面内的模板，一种是独立成子页面的模板。这两种avalon都支持。前者通常是使用type为浏览器无法识别的MIME类型的script标签，display:none的textarea标签或noscript标签（0.94后支持，建议使用它）作为模板容器，最近HTML5出了一个新的template标签，大家也不妨用一用。一般情况下，它是用于放置弹出层的内容。另一个模板，则需要通过AJAX请求来加载它们，它们适用范围更广，并且重用性更好。

对于页面内的模板，我们可以使用ms-include=”expr”绑定，对于独立于页面的模板，我们可以使用ms-include-src=”expr”绑定。ms-include要求对应一个ID（换言之，作为模板容器的script等标签必须指定ID），ms-include-src要求对应一个路径。需要注意的是ms-include或ms-include-src的属性值默认都是对应VM的一个属性，当作是一个变量，如果想直接使用字符串，那么需要使用双重引号。

<!DOCTYPE html>
<html>
    <head>
        <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
        <script src="avalon.js"></script>
        <script>
            var model = avalon.define({
                $id: "test",
                content: "引入内部模板",
                name: "司徒正美",
                eee: "lala",
                change: function() {
                    model.eee = model.eee === "lala" ? "hehe" : "lala"
                }
            })
        </script>
    </head>
    <body ms-controller="test">
        <script type="avalon" id="tpl">
            here, {
   { 3 + 6 * 5  }}
        </script>
        <script type="avalon" id="lala">
            <strong>{
   {name}}</strong>!!!
        </script>
        <script type="avalon" id="hehe">
           <em>{
   {content}}</em>!!!
        </script>
        <p>{
   {content}}<button ms-click="change" type="button">切换子模板</button></p>
        <div ms-include="'tpl'"></div><!--注意这里-->
        <div ms-include="eee"></div>
    </body>
</html>

enter image description here ms-include与ms-include-src的属性值可以添加插值表达式，见下面例子，不过注意需要打开服务器，因为用到AJAX请求。

有四个页面，一个主页面与三个独立的子模板，它们都放在一起，内容分别如下。

include.html

<!DOCTYPE html>
<html>
    <head>
        <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
        <title>ms-include</title>
        <script src="../avalon.js"></script>
        <script>
           var model = avalon.define({
                $id: "test",
                url: "Template1",
                name: "司徒正美",
                password: '12345678',
                array: [1, 2, 3, 4, 5, 6, 7],
                add: function(e) {
                    if (this.value && e.which == 13) {//this为input元素
                        var a = this.value
                        model.array.push(a)
                        this.value = "";
                    }
                }
            })
        </script>
    </head>
    <body>
        <h3 style='text-align: center'>ms-include</h3>
        <div ms-controller="test">
            <select ms-duplex="url">
                <option>Template1</option>
                <option>Template2</option>
                <option>Template3</option>
            </select>
            <div ms-include-src="include{
   {url}}.html"></div>
        </div>
    </body>
</html>

includeTemplate1.html

<h1>这是模板1</h1>
<p>生成于{
   { new Date | date("yyyy MM dd:HH:mm:ss")}}</p>
<p>生成于{
   { "2011/07/08" | date("yyyy MM dd:HH:mm:ss")}}</p>
<p>生成于{
   { "2011-07-08" | date("yyyy MM dd:HH:mm:ss")}}</p>
<p>生成于{
   { "01-10-2000" | date("yyyy MM dd:HH:mm:ss")}}</p>
<p>生成于{
   { "07 04,2000" | date("yyyy MM dd:HH:mm:ss")}}</p>
<p>生成于{
   { "3 14,2000" | date("yyyy MM dd:HH:mm:ss")}}</p>
<p>生成于{
   { 1373021259229 | date("yyyy MM dd:HH:mm:ss")}}</p>
<p>生成于{
   { "1373021259229" | date("yyyy MM dd:HH:mm:ss")}}</p>
<p>值得注意的是，new Date可传的格式类型非常多，但不是所有浏览器都支持这么多，详看<a href="http://dygraphs.com/date-formats.html">这里</a>。</p>

includeTemplate2.html

<script type="avalon" id='form'>
    <p>姓名：<input ms-duplex="name">{
   {name}}</p>
    <p>密码：<input type="password" ms-duplex="password"/>{
   {password}}</p>
</script>
<form ms-include="'form'" style='border:1px solid #666;background:sandybrown;padding:20px'>

</form>

includeTemplate3.html

<ul ms-each-el="array">
    <li >第 {
   {$index+1}} 个元素: {
   {el}} <span ms-click="$remove">点我删除</span></li>
</ul>
<p>添加新元素 ，然后回车<input ms-keypress="add"></p>

如果大家想在模板加载后，加工一下模板，可以使用data-include-loaded来指定回调的名字。

如果大家想在模板扫描后，隐藏loading什么的，可以使用data-include-rendered来指定回调的名字。

<!DOCTYPE html>
<html>
    <head>
        <title>ms-include相关实验</title>
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge" /> 
        <script src="avalon.js">
        </script>
        <script>
            avalon.define("test", function(vm) {
                vm.render = function(){
                    console.log("render")
                }
            })

        </script>
    </head>
    <body ms-controller="test" >
        <div ms-include-src="'temp.html'" data-include-rendered='render'></div>
    </body>
</html>

temp.html

<!DOCTYPE html>
<html>
    <head>
        <title>TODO supply a title</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width">
        <script>
            console.log("----------")
        </script>
    </head>

    <body>
        <div>include content</div>
    </body>
</html>

最后我们看avalon.templateCache，所有ms-include-src加载的模板都会缓存在这里，从而有效地减少请求数。并且这个东西还有一个额外的好处，我们的JS与CSS最终会压缩合并，对于这些模板我们也想把它们合并到JS文件里面，它就有用武之地了。这也是我们在第一节看到的那样，把requirejs加载回来的模板都放在avalon.templateCache里，与ms-include-src一起使用了。

<!DOCTYPE html>
<html>
    <head>
        <title>avalon.templateCache的应用</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width">
        <script src="avalon.js"></script>
        <script>
            avalon.templateCache["aaa.html"] = "<strong>dddddddddddd</strong>"
            avalon.templateCache["bbb.html"] = "<em>555555555555</em>"

            var model = avalon.define({
                $id: "test",
                adjust: function(tmpl) {
                    return tmpl +"  "+ (new Date - 0)
                },
                aaa: "aaa.html",
                change: function() {
                    model.aaa = model.aaa === "aaa.html" ? "bbb.html" : "aaa.html"
                }
            })
        </script>
    </head>
    <body ms-controller="test">
        <div ms-include-src="aaa" data-include-loaded="adjust"></div>
        <button type="button" ms-click="change">点我切换模板</button>
    </body>
</html>