js模版引擎handlebars.js实用教程

阅读本文需要了解基本的Handlebars.js概念,本文并不是Handlebars.js基础教程,而是注重于实际应用,为读者阐述使用过程中可能会遇到的一些问题。

实际上,小菜写这篇文章,很大程度是因为关于这个插件的中文资料比较少,像小菜这样的新手难以快速使用。

小菜再次申明,本文不会讲解Handlebars.js的基本语法,网上资料很多,请读者自补。

目录:

为什么选择Handlebars.js?

如何引入Handlebars.js?

each-基本循环使用方法。

each-循环中使用this。

with-进入到某个属性(进入到某个上下文环境)。

with-终极this应用。

if-判断的基本用法。

由于if功力不足引出的Helper。

另一种Helper用法。

关于HTML编码。

结束语。

Demo打包下载:

  下载地址

jQuery.imgLazyLoad图片懒加载组件

一、前言

当一个页面中请求的图片过多,而且图片太大,页面访问的速度是非常慢的,对用户的体验非常不友好;使用图片懒加载,可以减轻服务器的压力,增加页面的访问量,这里主要是总结一下我自己写的图片懒加载组件jQuery.imgLazyLoad;使用该组件应在img标签中设置一个imglazyload-src属性,存放图片地址。

二、应用实例demo

js模版引擎handlebars.js实用教程-LMLPHP
/**
* component: imgLazyLoad 2013/12/12 华子yjh
* invoking: jQuery.imgLazyLoad(options)
*
// 配置对象
options = {
container: 'body', // 外围容器,默认body
tabItemSelector: '', // Tab切换面板选择器
carouselItemSelector: '', // 图片轮播面板选择器
attrName: 'imglazyload-src' // 图片地址属性
diff: 300 // 预加载像素
}
*
*/
js模版引擎handlebars.js实用教程-LMLPHP

图片轮播懒加载:http://miiee.taobao.com
Tab切换图片懒加载:http://miiee.taobao.com/main.htm
浏览器滚动图片懒加载:http://miiee.taobao.com/themes/theme_151.htm

三、设计思路

1、处理浏览器下拉滚动

比较 $(window).scrollTop + $(window).height() 与 img.offset().top 的值,当图片在浏览器窗口中,开始加载图片

2、处理Tab切换 与 图片轮播

在处理Tab切换 与 图片轮播,组件提供了一个用于事件处理的函数 handleImgLoad,参数idx:

该参数对于图片轮播,是作为下一轮轮播面板的索引,将下一轮轮播面板中的所有图片预加载
对于Tab切换,则是作为tab项的索引,加载当前显示tab项中的所有图片

3、选择器处理

3.1、滚动下拉选择器的处理

在 配置对象中有一个attrName,是保持图片地址的一个属性 选择器为:img[config.attrName];

其次图片是显示的,如果隐藏,则不加载图片, 选择器为:img[config.attrName]:visible;

再次如果图片已加载,为其加上一个img-loaded的className,为了过滤已加载过的图片,选择器为:img[config.attrName]:visible:not(.img-loaded);

最后如果一个页面使用多次组件,第一次使用时,当配置对象container为body子元素,第二次应该过滤前一次container匹配元素中的图片,
依次类推,选择器为:img[config.attrName]:visible:not(.img-loaded):not(jQuery.imgLazyLoad.selectorCache)

3.2、Tab切换、图片轮播选择器的处理

在 配置对象中有tabItemSelector 或 carouselItemSelector ,结合事件处理函数的参数idx,获取当前Tab项或下一轮轮播面板中的图片
选择器为:tabItemSelector:eq(idx) img 或 carouselItemSelector:eq(idx) img

如果idx === undefined,选择器为:tabItemSelector:visible img 或 carouselItemSelector:eq(0) img
我是根据我自己写的jQuery组件自行判断的

四、组件源码

js模版引擎handlebars.js实用教程-LMLPHP
$.extend({
imgLazyLoad: function(options) {
var config = {
container: 'body',
tabItemSelector: '',
carouselItemSelector: '',
attrName: 'imglazyload-src',
diff: 0
};
$.extend( config, options || {} ); var $container = $(config.container),
offsetObj = $container.offset(),
compareH = $(window).height() + $(window).scrollTop(), // 判断容器是否为body子元素
bl = $.contains( document.body, $container.get(0) ), // 过滤缓存容器中的图片
notImgSelector = jQuery.imgLazyLoad.selectorCache ? ':not(' + jQuery.imgLazyLoad.selectorCache + ')' : '',
imgSelector = 'img[' + config.attrName + ']:visible' + notImgSelector,
$filterImgs = $container.find(imgSelector), // 用于阻止事件处理
isStopEventHandle = false, // 是否自动懒加载,为true时,绑定滚动事件
isAutoLazyload = false; // 缓存容器为body子元素的图片选择器
jQuery.imgLazyLoad.selectorCache = bl ? (jQuery.imgLazyLoad.selectorCache ? (jQuery.imgLazyLoad.selectorCache + ',' + config.container + ' img') : config.container + ' img') : jQuery.imgLazyLoad.selectorCache; function handleImgLoad(idx) {
if (isStopEventHandle) {
return;
}
/**
处理Tab切换,图片轮播,在处理$filterImgs时,没有过滤img:not(.img-loaded),因为只是在一个面板中,
还有其他面板,如果再次触发,可能$filterImgs.length为0,因此只能在外围容器中判断过滤图片length
*/
if ($container.find('img:not(.img-loaded)').length === 0) {
isStopEventHandle = true;
} var itemSelector = config.tabItemSelector || config.carouselItemSelector || '';
if (itemSelector) {
if (typeof idx !== undefined && idx >= 0) {
$filterImgs = $container.find(itemSelector).eq(idx).find('img');
}
else {
if (itemSelector === config.carouselItemSelector) {
$filterImgs = $container.find(itemSelector).eq(0).find('img');
}
else {
$filterImgs = $container.find(itemSelector + ':visible').find('img');
}
}
}
else {
$filterImgs = $filterImgs.not('.img-loaded'); // 自动懒加载,过滤已加载的图片
isAutoLazyload = true;
} // 当外围容器位置发生变化,需更新
offsetObj = $container.offset(); if ($filterImgs.length > 0) {
$filterImgs.each(function(idx, elem) {
var $target = $(elem),
targetTop = $target.offset().top,
viewH = $(window).height() + $(window).scrollTop() + config.diff; if (bl) {
$target.attr('src', $target.attr(config.attrName)).removeAttr(config.attrName).addClass('img-loaded');
}
// 内容在视窗中
if (viewH > targetTop) {
$target.attr('src', $target.attr(config.attrName)).removeAttr(config.attrName).addClass('img-loaded');
}
});
}
else {
// 处理滚动事件
isStopEventHandle = true;
$(window).unbind('resize scroll', handleImgLoad);
}
} handleImgLoad();
if (isAutoLazyload) {
$(window).bind('resize scroll', handleImgLoad);
} // 提供事件处理函数
return {
handleImgLoad: handleImgLoad
}
}
}); // 保存非body子元素容器下的图片选择器
jQuery.imgLazyLoad.selectorCache = '';
js模版引擎handlebars.js实用教程-LMLPHP

五、实例应用代码

js模版引擎handlebars.js实用教程-LMLPHP
// 轮播图片 懒加载
(function(){
var imgLazyLoadObj = $.imgLazyLoad({
container: '#first-block-switch',
carouselItemSelector: '.switch-content li'
});
$.switchable({
wrapSelector: '#first-block-switch',
contentSelector: '.switch-content',
prevBtnSelector: '.prev',
nextBtnSelector: '.next',
triggerSelector: '.switch-nav',
autoPlay: true,
duration: 300,
interval: 3000,
handleImgLoad: imgLazyLoadObj.handleImgLoad
});
}()); // 浏览器滚动 懒加载
$.imgLazyLoad({ diff: 300 });
js模版引擎handlebars.js实用教程-LMLPHP

转载请注明出处:博客园华子yjh

简单单点登录(SSO)解决方案

先上渣图一张:

js模版引擎handlebars.js实用教程-LMLPHP

再上伪代码。这个方案跨域只用到了jquery的jsonp跨域,利用一次性密钥简单有限的解决了安全问题,如果特别严谨需要扩展。

这里代码用的是mvc3框架。

授权站登陆页面代码:

js模版引擎handlebars.js实用教程-LMLPHP
[HttpGet]
public ActionResult Login(string ReturnUrl)
{
if (base.CurrentUser != null && !string.IsNullOrEmpty(ReturnUrl))//已经登录
{
return Redirect(SSOUrl(ReturnUrl));//生成密钥并返回
}
//...返回登录页面,正常流程。
} //登录提交逻辑
[HttpPost]
public ActionResult Login(string name, string pwd, string ReturnUrl)
{
if(//登录成功 && 分站的请求)
{
ReturnUrl = SSOUrl(ReturnUrl);
}
ReturnUrl = string.IsNullOrWhiteSpace(ReturnUrl) ? FormsAuthentication.DefaultUrl : ReturnUrl;
return Redirect(ReturnUrl);
}
js模版引擎handlebars.js实用教程-LMLPHP
js模版引擎handlebars.js实用教程-LMLPHP
这里的代码很重要:
1:定义一个SSO类
2:检测到登录状态或者登录成功即生成一次性密钥以参数形式返回给分站。
3:如何生成密钥。我这里用的缓存来存储(可以用其它方式代替),只要有请求,每次都生成密钥(这里new了一个GUID),把密钥和当前用户的令牌ID存储起来(可以看做是键值对形式),放入缓存。
4:关于token,我这里比较简单的在User表中放了一个单一的tokenId列(仅仅在user对象发生变化的时候,比如修改密码,更新token,这样就会使这个user的所有登录客户端全部失效),考虑到更加严谨可以把用户ID和token做成一对多的关系,动态生成token分发给不同的登录对象,这里就不深究了。 class SSO
{
public Guid Cert { get; set; }//一次性密钥
public Guid Token { get; set; }//分站令牌
public DateTime Time { get; set; }//过期时间
} private string SSOUrl(string url)
{
var sso = HttpContext.Cache["SSO"] == null ? new List<SSO>() : (List<SSO>)HttpContext.Cache["SSO"];
Guid cert = Guid.NewGuid();
sso.Add(new SSO { Cert = cert, Token = base.CurrentUser.Token, Time = DateTime.Now.AddHours(3) });
HttpContext.Cache["SSO"] = sso;
if (!string.IsNullOrWhiteSpace(url))
{
if (url.Contains('?'))
{
var args = url.Substring(url.IndexOf('?') + 1).Split('&');
url = url.Substring(0, url.IndexOf('?') + 1);
foreach (var arg in args)
{
if (!arg.StartsWith("cert="))
{
url += arg;
}
}
url += "cert=" + cert;
}
else
{
url += "?cert=" + cert;
}
}
return url;
}
js模版引擎handlebars.js实用教程-LMLPHP

这样登录的功能就完成了。

下面是授权站的jsonp接口:一个返回token,一个返回用户信息。

刚才生成的缓存在这里进行维护,通过一次性密钥从缓存中获取token,返回给分站,并把过期的缓存条目和密钥删除掉。

正常情况下密钥生成后马上就会被获取->删除,条目的过期时间其实设置成几分钟就行了,这个缓存中的数据也不会积累。

PS:

1 为什么要返回密钥而不是直接返回token,因为密钥是url形式返回的,如果其它人得到这个链接会有安全问题,所以生成一个url请求一次token马上失效,提升一下安全度。

2 JsonpResult(即jsonp服务端实现)需要自己扩展。

js模版引擎handlebars.js实用教程-LMLPHP
//根据一次性密钥返回token
public JsonpResult Token(Guid cert)
{
var sso = HttpContext.Cache["SSO"] == null ? new List<SSO>() : (List<SSO>)HttpContext.Cache["SSO"];
sso.RemoveAll(p => p.Time < DateTime.Now);
var single = sso.SingleOrDefault(p => p.Cert == cert);
sso.Remove(single);
HttpContext.Cache["SSO"] = sso;
if (null != single)
return Jsonp(new { State = 1, Token = single.Token });
return Jsonp(new { State = 0 });
}
//根据token查询用户信息
public JsonpResult Identity(Guid token)
{
var user = UserInfo.SingleOrDefault(token);
return Jsonp(new { State = 1, Result = user });
}
js模版引擎handlebars.js实用教程-LMLPHP

下面上分站代码:

后台代码:

1 将分站的token返回给页面供js调用。

2 一个ajax接口存储token。

js模版引擎handlebars.js实用教程-LMLPHP
public ActionResult Index()
{
ViewBag.Token = Session["SSO_Token"]; return View();
} public JsonResult UpdateToken(Guid token)
{
Session["SSO_Token"] = token;
return Json(new { State = 1 });
}
js模版引擎handlebars.js实用教程-LMLPHP

分站页面js:

http://localhost:8001 是我本地的授权站。

js模版引擎handlebars.js实用教程-LMLPHP
<script type="text/javascript">
  /*url参数辅助方法,此处用来获取url回传的一次性密钥参数值*/
function querystring(key, val) {
var s = window.location.search.substr(1).split('&');
var obj = {};
for (var k in s) {
if (s[k].indexOf('=') >= 0) {
var temp = s[k].split('=');
obj[temp[0]] = temp[1];
}
}
if (arguments.length >= 2) {
obj[key] = val;
s = "";
for (var o in obj) {
s = s + '&' + o + '=' + obj[o];
}
return s.replace('&', '?');
} else {
return obj[key];
}
}
  
  
  /*用token跨域获取用户信息*/
function identityByToken(token) {
$.getJSON('http://localhost:8001/SSO/Identity?callback=?', { token: token }, function (d) {
alert(d.Result.Name + "检测到SSO登录");
       //...todo
});
}
  
  
  /*用密钥获取用户信息(先跨域获取token,然后调用token获取)*/
function identityByCert(cert) {
$.getJSON("http://localhost:8001/SSO/Token?callback=?", { cert: cert }, function (d) {
if (d.State == 1) {
$.post("/Home/UpdateToken?token=" + d.Token);//成功获取token,ajax提交给分站后台存储,下次访问直接可获取到token
identityByToken(d.Token);
} else {//失败则跳转至授权登录页获取一次性密钥
window.location = 'http://localhost:8001/Account/Login?returnurl=' + window.location;
}
});
} if (!!'@(ViewBag.Token)') {//有令牌
identityByToken('@(ViewBag.Token)');
} else {
if (!!querystring('cert')) {//有一次性key
identityByCert(querystring('cert'));
} else {//失败则跳转至授权登陆页(注意将本页url作为returnurl参数传递给了授权页,授权登录页经过处理会把密钥作为参数回传重定向到本页面)
window.location = 'http://localhost:8001/Account/Login?returnurl=' + window.location;
}
}
</script>
js模版引擎handlebars.js实用教程-LMLPHP

完成。下面是一大篇渣渣截图,可略过。


看看效果:

此时主站未登录

js模版引擎handlebars.js实用教程-LMLPHP

访问本地分站:192.168.2.31:8010

直接跳转到了登录页,注意returnurl参数:

js模版引擎handlebars.js实用教程-LMLPHP

1 登录成功

2 跳转回分站并带回密钥

3 通过密钥跨域获取token

4 ajax提交token给分站后台存储

4 通过token跨域获取user(弹窗提示)

ps:这个带cert参数的url经过这次请求以后就失效了,所以别人得到这个url访问也不会得到对应的token。

js模版引擎handlebars.js实用教程-LMLPHPjs模版引擎handlebars.js实用教程-LMLPHP

再重新访问一次分站点:

可以看到由于分站已经有了token,所以只有一个请求了。

PS:实际应用中会把登陆user一些常用信息存储在分站点,直到过期才会去主站请求,不用每次都用token去请求。

js模版引擎handlebars.js实用教程-LMLPHP

此时主站已经登录,我懒得再弄一个分站B来测试了,这里模拟一下:

最后模拟一下用户已经登录,但是分站未登录的情况。

先清空分站session,然后登录主站,再访问分站192.168.2.31:8010

js模版引擎handlebars.js实用教程-LMLPHP

结果直接弹出了登录信息。

梳理一下:

1 主站的功能就是通过token提供用户信息给分站,只要分站有token就提供(注意用户的token虽然是可变的,但仍有一些安全隐患,解决方案前面提过用分发的方式,我这里没有具体实现)。

2 主站的接口可以通过设置分站列表,验证访问来源来过滤一些非法请求,提高安全度。

3 分站如何获得token。只能通过主站给的密钥获得,密钥都是一次性且有时限的。

4 分站如何获得密钥。通过访问主站的登录页面,主站重定向将密钥用url方式返回。

最后的最后,关于注销:

思路:

1 在主站设一个注销接口,任何分站注销都去访问主站的注销。

2 主站的注销清空所有分站的登录信息(这里为session)。

3 如何跨域清空?百度了一下,有个方式就是实现一个主站的注销页面,页面上动态创建多个iframe(有多少个分站就创建多少个)来注销分站登录信息。

我这没具体实现的原因是:

项目不大,只是要集成一下原来的项目。

本来就不需要很严谨的一个应用,我把分站上的session时间设置的很短,分站不会有很长的退出延时。

最重要的原因是懒......

 
 
 
 
 
分类: 技术文章
标签: Handlebars.js
04-04 12:51