hy-ria-stater v0.0.2

hy-ria-starter

宏奕单页应用开发快速上手，主要目的在于帮助理解单页+前端路由+AJAX与后台解耦+模板引擎的开发思路

推荐基于此项目来完成个人博客的前端实现，从而就可以更好地理解框架的开发思路。万事开头难，为了更便于大家上手，已经完成了博客的一点基础效果，可供大家参考着摸索思路！

Overview

• hy-ria-starter是基于SeaJS、jQuery、Bootstrap建立起来的单页应用框架
• 内置事件机制，分global、module两个级别，可有效解决非全局事件未销毁带来的问题
• 基于hashchange实现强大而灵活的路由机制，有框架默认的路由规则，亦支持自定义路由规则
• 支持module和action两级构造方法（_init）和析构方法（_destroy），编码更灵活
• 提供了众多常用组件：url、time、cache、view、data等
• URL无权访问到模板模块和_打头的path，如_core、_base等基础modules
• 自动打包样式文件、模板文件为module（详见gulp-seajs-css、gulp-seajs-dot），框架支持原生HTML和doT模板引擎，你也可以按自己的喜好进行扩展

Start

• 首先通过npm install安装依赖
• npm run serve来启动web server（自动生成dist目录），默认为http://localhost:8001
• npm run watch来监视文件改动
• 使用?hyDebug=1参数开启调试模式
• 业务逻辑文件放在src/app文件夹，请根据业务模块分子文件夹。

Config

• 在入口文件，seajs.use加载hy模块后，通过hy.init(rootDom, config, callback)方法传入根容器、配置参数、初始化回调方法
• config如下：

    {
        route: {
            root: { //默认的首页路由
                module: 'archive/home',
                action: 'init'
            }
        }
    }

• seajs相关配置在loader-config.js中完成

Structure

• src 项目源码
  • index.html 入口文件
  • lib 框架底层文件
  • vendor 第三方依赖
    • images 图片放到这里，通过/vendor/images/*来引用
  • app 业务代码
    • base _config _service等，不想被路由到的模块，前面加“”
• dist 构建后的代码（自动生成）

Core Module

核心模块提供了对框架底层的支撑，助力开发更加便捷

Route

• URL地址+#!/module/action&arg1=value1&arg2=value2 如http://localhost:8080/index.html?hyDebug=1#!/play/ssq/run&id=123
• 即xx/xx/xx/.../xx 这组路由规则中最后一个是action，即module暴露的方法，前面的都是module，且与seajs的module概念一致
• 如果不满意现有路由方案，可以配置route模块，或者重写route模块，route模块与hy框架对接使用dist格式：

    {
        rule: '', //规则，hash字符串或正则
        module: '', //加载的模块
        action: '', //请求的方法
        params: {}, //hash参数
        options: {} //配置
    }

• route.reg(rule, dist)实现自定义路由规则，rule支持关键字和正则两种形式，dist直接传对象也可以通过callback返回
• route.go(rule)，路由跳转，支持传hash或者dist
• route.getParams(param)，获取当前路由下的hash参数，如#!/archive/article/list&topicId=2，route.getParams('topicId')
• 默认在_base/view中，添加了dom属性data-go-route和data-go-route-reload（相同module/action时，参数不同会reload）的支持

Event

• module级别的：Event.on/emit/off，适合使用当前模块的一些消息传递，切换module的时候自动销毁，无需担心未销毁导致bug
• global级别的：Event.onG/emitG/offG，适合用于整个APP的消息传递，需自行销毁事件，以防止污染
• 默认在_base/view中，添加了dom属性data-trigger和data-trigger-g的支持

Cache

• 采用localStorage提供了对缓存的支持，setItem/getItem/removeItem 没有兼容不支持localStorage的情况

Time

• 编码时，应避免依赖本地时间，应该以服务器时间为准，提供now方法返回当前服务器的时间戳（ms）
• format方法提供了对格式化时间的支持 ymdhiswx 年月日 时分秒 星期0-6 星期日-六 如格式化成'2015-08-9 23:16 星期日'则传参 'yyyy-mm-d hh:ii 星期x'

Data

• query方法，自动带上入口URL中query参数，统一成功和失败的回调，支持缓存

Dep Docs

• 前端模块化 SeaJS
• UI库 Bootstrap
• 模板引擎 doT
• CSS格式 gulp-seajs-css
• doT模板格式 gulp-seajs-dot

FAQ

Q: 从/module1/action1&id=123到/module1/action1&id=321会不会重新执行action1方法

A: 不会，如果想重复执行，则route.go方法第二个配置参数传{reload:true}或者dist.reload=true，默认在_base/view中，添加了dom属性data-go-route-reload支持

Q: 从/module1/action1到/module2/action2，如何执行构造方法和析构方法

A: module1/action1_destroy -> module1/_destroy -> module2/_init -> module2/action2_init