文档章节

SBind前端框架设计说明

BarZu
 BarZu
发布于 2016/09/11 19:56
字数 1928
阅读 93
收藏 0

核心应用

代码预览

index.html

<html>
    <head>
        <title>SBind</title>
        <script src="sbind.js"></script>
    </head>
    <body>
        <script>
        SBind.boot();   //启动SBind程序
        history.hash = "main"; //跳到默认路由
        </script>
    </body>
</html>

main.js

//定义main视图
SBind({
    route: 'main',
    id: 'main',
    events: {
        'click .goBack': 'goBack' //返回到上一视图
    },
    model: {
        title: 'SBind框架演示',
        text: '测试内容'
    },
    template: '<component:header><div>{{= text }}</div>',
    onShow: function() {
        console.log('Hello World!');
    },
    goBack: function() {
        history.back();
    }
});

//定义header组件
SBind({
    id: 'header',
    events: {
        'click #goDetail': 'goDetail' //跳到详细说明页
    },
    model: {
        goback: '返回',
        detail: '详细'
    },
    template: './header.html',
    goDetail: function() {
        SBind.navigate('detail');
    }
});

header.html

<div>
    <div class="goBack">{{- goback }}</div>
    <h1>{{- title }}</h1>
    <div id="goDetail">{{- detail }}</div>
</div>

生成的html

<html>
    <head>
        <title>SBind</title>
        <script src="sbind.js"></script>
    </head>
    <body>
        <script>
        SBind.boot();   //启动SBind程序
        history.hash = "main"; //跳到默认路由
        </script>
        <div id="sbind_views">
            <div sb-route="main" id="mian">
                <div sb-component="header">
                    <div class="goBack">返回</div>
                    <h1>SBind框架演示</h1>
                    <div id="goDetail">详细</div>
                </div>
                <div>测试内容</div>
            </div>
        </div>
    </body>
</html>

说明

开始

  • 入口文件index.html,在head引入sbind.js,在body使用SBind.boot()启动程序,在执行boot之前可使用SBind.config配置一些选项,选项内容待设计。改变history.hash跳转页面,作为默认路由设置。
  • 引入第三方插件,如jQuery,简单页面可使用普通script标签引入,大型应用可使用gulp等自动化构建工具用import导入
  • 脚本编写,给SBind传入一个对象,所有工作都是给SBind传入的对象配置选项。
  • 生成的dom元素上带有sb-route、sb-component等属性,方便调试排错。

选项

| 键名 | 类型 | 备注 | |:--:|:--:|:--| | id | String | 唯一标识符,作为Component必填 | | route | String | 路由,作为View必填 | | events | Object | 定义事件 | | model | Object | 定义数据 | | template | String | 定义模板 | | onCreate | Function | SBind实例创建完成时执行一次 | | onInit | Function | 初次路由到达,对应view添加到html时执行一次 | | onShow | Function | 每次路由到达时执行 | | onHide | Function | 每次从当前路由离开时执行 |

路由

  • hash改变为#main时,SBind自动查找views[main],如果没有对应实例则查找main.js加载并执行。执行过main.js后保存为views[main]。
  • 以script、script[type=text/html]、link[rel=sheetstyle]形式加载脚本、模板、样式,不使用xhr,避开跨域。
  • 禁止路由环路,例:A->B->C->D->B,历史记录删除C、D,在B执行back直接回A而不是D

组件

  • 带有route的SBind对象最终产物称为view实例,只有id的称为component,可以将view视为特殊的component。路由改变时对应的view会被插到body>div#sbind_views并执行onShow。
  • view的内容由对应的template编译而成,如果没有显式指定template,程序自动查找与脚本名称对应的html文件。例:main.js会查找main.html。
  • component依赖view存在,即component的配置要写在view的文件里,否则不能被加载到。除非使用自动化构建,该内容将在大型应用构建详细说明。
  • 只在模板里使用<component:header>即可自动查找相应组件,不需要像vue、angular等需要手动传入组件。
  • 组件继承,使用parent:"parentId"指定父组件,方法数据事件全部继承,原型链指向父组件方式实现。

模板视图

  • 模板不使用v-for,v-on,ng-repeat,ms-attr等指令,全部使用{{}}语法,如{{each items as item}},<div class="{{= active }}">等
  • {{= data }}双向,输出字符串,相当于innerText
  • {{- data }}单向,输出字符串
  • {{# data }}双向,输出html,相当于innerHTML
  • {{+ data }}单向,输出html
  • {{if}}{{/if}}条件
  • {{each items as item i}}循环
  • {{ }}运行任意javascript代码
  • 支持管道过滤器,表达式运算
  • 模板解释引擎需要处理的类型:文本(textContent)、dom节点(Node)、类(className)、属性值(Attribute)、表单输入(input/select/textarea)、数组列表(Array)
<ul>
    <!-- 循环 -->
    {{each items as item i}}
    <li data-id="{{- item.id | filter}}">
        <div>{{= item.title }}</div>
        
        <!-- 嵌套循环 -->
        {{each item as it j}}
        <p>{{= it.text }}</p>
        {{/each}}
    </li>
    {{/each}}
</ul>
<div class="toast {{= showClass}}">
    {{# tips }}
</div>
{{if isButton}}<button>确定</button>{{/if}}

事件

  • 事件events,使用代理的方式绑定到view上,任凭view里的内容怎样变化都能监听到。定义方式参考butterfly,键名为事件加选择器,值为字符串或函数,当为字符串时,自动匹配view对应的方法。
  • 组件内定义的事件仅在该组件内生效,层级包含关系,例如view[main]定义的点击事件,由于component[header]在view[main]里,因此在view[main]和component[header]里匹配的元素都会响应该点击事件,而在compontent[header]里定义的事件,点击compontent[header]外的任何元素都无效。

支持委托的常用事件

| 事件名称 | 说明 | |:--|:--| | click | 需要类似fastclick事件库处理300ms延迟,fastclick原理是在touchend使用stopImmediatePropagation阻止将要执行的click事件,并使用new Event创建点击事件促使立即执行。可根据其原理将300ms延迟提速功能写入SBind核心库,并收集现已不存在300ms问题的userAgent | | focusin<br>focusout | 火狐浏览器不支持该组事件,webapp多数webkit内核,可不考虑火狐。如果需要支持火狐,可在目标dom元素上绑定focus/blur事件,这两个事件不支持冒泡,即无法委托 | | input | 使用input事件,输入中文会遇到中文未进输入框,键码先上屏的问题,可监听compositionstart和compositionend处理中文输入 | | touchstart<br>touchmove<br>touchend | 该组事件一般组合使用,扩展为长按,左划,右划等事件 | | keydown<br>keyup<br>keypress | 一般使用input代替该组事件 | | change | 各大主流浏览器都支持 | | mousedown<br>mousemove<br>mouseup<br>mouseover | IOS手机不支持该组事件,移动端没有鼠标,SBind主要面向手机市场,可忽略该组事件的应用 |

数据模型

  • 数据继承,header组件没有定义title,在渲染时,模板找不到title,会自动向上搜索,这一特性方便复用组件。
  • 双向绑定算法,先解释成抽象树,赋值,对dom作标记,不绑定dom。model数据变化时再查找dom绑定并处理。按需绑定可很大程度减少编译时间。

(PS:以前用PHP做的CMS系统处理静态文件也使用按需处理的方式,很大程度的降低服务器IO操作。传统的CMS系统用户每次保存数据都会自动生成静态html,使用404方式可在访客访问时才生成html,即请求访问时系统拦截404并将静态url转为动态url,并生成html返回给访客,如果动态url也404才给访客返回404)

问题

  • 事件集中写在events上,不知道哪个dom元素绑定了事件,会不会给维护带来困难?

不会,事实上分离事件更利于维护,只要在事件后面加上扼要备注,对应的dom便一目了然。

events: {
    'click #goBack': 'goBack', //返回上一页面
    'click #submit': 'pay', //支付
    'input #telBox': 'filterNum' //电话只允许输入数字
}
  • 没有指令也算是一个完整的框架?

指令的功能无非就是绑定属性、事件和处理判断、循环,早期的前端模板引擎没有指令处理这些问题也毫不费力,SBind的模板语法算是复古写法。

  • 不配置路由表,维护时想查看有多少路由怎么办?

建议路由与对应view文件同名,这样看文件名就了解了。如果是自动化构建的应用,一次性注册所有SBind实例,可以输出SBind.routingTable查看所有路由。

大型应用

© 著作权归作者所有

共有 人打赏支持
BarZu
粉丝 25
博文 19
码字总数 10230
作品 3
广州
高级程序员
私信 提问
前端工程师如何与设计师合作?

原文出处:Chuckie Chang 如果你是前端,你可以给设计师提以下一些要求: 1.如果想要95%以上还原设计稿,你必须提供给设计师设计时的注意事项,当然如果设计师有前端功底,他的设计会考虑到更...

Chuckie Chang
2015/11/01
0
0
来 分 任 务 吧

这周我们需要完成 (1)app原型设计 ①首页【首页】 ②分类【分类页、详情页、书内容页】 ③书架【书架页、电子阅读页面】 ④我的【我的信息页、登录注册页】 (2)设计说明 采取2人一组每组...

sydigua
2017/03/22
6
5
国密算法SM2,SM3,SM4前端js库开发

国密算法SM2,SM3,SM4前端js库开发: 1、 基于国密算法规范,将国密算法标准开发成一个js算法包,使其与bouncy castle(1.58) 版本中的国密保持一致。即:前端后端加解密内容一致,前端js加密...

liusha_0302
2017/10/26
2
0
国密算法SM2,SM3,SM4前端js库开发

国密算法SM2,SM3,SM4前端js库开发: 1、 基于国密算法规范,将国密算法标准开发成一个js算法包,使其与bouncy castle(1.58) 版本中的国密保持一致。即:前端后端加解密内容一致,前端js加密...

liusha_0302
2017/10/26
11
0
基于主流开源技术的Java WEB应用开发框架

项目简介 集结最新主流时尚开源技术的面向互联网Web应用的整合前端门户站点、HTMl5移动站点及后端管理系统一体的的基础开发框架,提供一个J2EE相关主流开源技术架构整合及一些企业应用基础通...

EntDIY
2016/01/26
8
0

没有更多内容

加载失败,请刷新页面

加载更多

乱入Linux界的我是如何学习的

欢迎来到建哥学Linux,咳!咳!咳!开个玩笑哈,我是一个IT男,IT界的入门选手,正在学习Linux。 在之前,一直想进军IT界,学习IT技术,但是苦于没有人指导,也不知道学什么,最开始我自己在...

linuxprobe16
50分钟前
9
0
OSChina 周日乱弹 —— 没时间 没头发 但有钱

Osc乱弹歌单(2019)请戳(这里) 【今日歌曲】 @开源中国总经办主任 :分享齐一的单曲《这个年纪》 《这个年纪》- 齐一 手机党少年们想听歌,请使劲儿戳(这里) @肿肿卷 :我真的可以睡一天...

小小编辑
今天
63
4
Django进阶 1.1 ORM基础—ORM 1.2.1 增删改查之查询 1.2.2 删改增 (1) 1.2.3 删改增 (2)

ORM基础 ORM是Django操作数据库的API,Django的作者将sql语句封装在里面供我们使用。 我们前面还提到过Django提供一个模拟数据库的工具,sqlite,供我们学习测试使用。 如果我们想使用mysql...

隐匿的蚂蚁
今天
3
0
Windows 上安装 Scala

在安装 Scala 之前需要先安装 Java 环境,具体安装的详细方法就不在这里描述了。 您可以自行搜索我们网站中的内容获得其他网站的帮助来获得如何安装 Java 环境的方法。 接下来,我们可以从 ...

honeymose
今天
3
0
数据库篇多表操作

第1章 多表操作 实际开发中,一个项目通常需要很多张表才能完成。例如:一个商城项目就需要分类表(category)、商品表(products)、订单表(orders)等多张表。且这些表的数据之间存在一定的关系...

stars永恒
今天
4
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部