我在 impress.js 中学到的小套路
写在开篇
作为了一个自学 JavaScript 才一个月的新手,前几天“妄图”研究 jQuery-3.1.0 源码,结果自然是被虐得死去活来。机缘巧合之下,遇到了 impress.js ,代码量只有 jQ 的十分之一,看起来挺好下手,研究了两天,勉强弄懂了其中的原理。于是写下此文,记录我在 impress.js 中学到的小套路。
附上impress.js github链接。
impress.js 简介
套路开始
如何使用 JS 为某个元素添加多个样式?
一般情况下,在 JS 中改变元素的样式都是通过元素的 style 属性,比如这样:
element.style.width = 100 + "px";
添加一个样式还好,如果添加多个呢,比如同时添加 width 和 height ,难道要这样?
element.style.width = 100 + "px";
element.style.height = 50 + "px";
非也,同时添加多个样式,可以通过函数来解决,如下:
/**
* 为指定的元素添加一组 CSS 样式
* @param ele 指定的元素
* @param props 一组 CSS 属性和值,JSON 的形式,属性名和属性值都要加引号
* @return 返回指定的元素
*/
var css = function(ele, props) {
var key, pkey;
for (key in props) {
if (props.hasOwnProperty(key)) {
pkey = pfx(key);
if (pkey !== null) {
ele.style[pkey] = props[key];
}
}
}
return ele;
}
如何使用 JS 为 CSS 属性添加当前浏览器能够识别的前缀?
比如 transform ,为了让他在各个浏览器上都支持,在 CSS 中就得写成这样:
#box {
transform: rotateX(45deg);
-webkit-transform: rotateX(45deg);
-moz-transform: rotateX(45deg);
-ms-transform: rotateX(45deg);
-o-transform: rotateX(45deg);
}
可是这样写真的很麻烦啊,怎么办?用函数自动添加!
/**
* 在需要的时候,为 CSS 属性添加当前浏览器能够识别的前缀
* @param prop 一定要记住,参数是一个字符串,所以传入的 CSS 属性一定要加引号
* @return 返回当前浏览器能够识别的 CSS 属性
*/
var pfx = (function() {
var prefixes = "Moz Webkit O ms".split(" ");
var style = document.createElement("dummy").style;
var memory = {}; return function(prop) {
var uProp = prop.charAt(0).toUpperCase() + prop.slice(1);
var props = (prop + " " + prefixes.join(uProp + " ") + uProp).split(" "); memory[prop] = null;
for (var i in props) {
if (style[props[i]] !== undefined) {
memory[prop] = props[i];
break;
}
}
return memory[prop];
}
})();
把上面的 css() 和 pfx() 两个函数结合起来,就可以方便地在 JS 中为元素添加样式啦。
如何通过 hash 值定位元素?
首先元素必须得有一个 id ,这个简单,遍历一下,没有 id 的加上 id 就可以了,在此不表。
有了 id 之后,就可以改变 hash 值啦,如下:
h3[i].onclick = function(event) {
window.location.hash = event.target.id;
}
改变 hash 值有什么用?当然有用,假如 hash 值是 #h3-3 ,就会自动跳转到 id 为 h3-3 的元素上面,然后转念一想,这不是可以生成目录吗?锚点什么的,out 啦!
基本思想是这样子:首先,保证每一个标题标签都有一个 id ,然后遍历所有的标签,找到标题标签,提取出来,利用自定义列表生成一个目录;目录下的每一项也都有一个 id ,为 # + 对象标题的 id 。当点击目录上的标题时,将这个标题的 id 赋给 hash 值,就 OK 啦。
附上本文生成目录的 JS 代码,仅供参考!
window.onload = function() {
addId();
createContents();
createLink();
} // 保证所有的标题标签都有 id ,以 h2-* h3-* 的格式
var addId = function() {
var h3 = document.querySelectorAll("h3");
for (var i = 0; i < h3.length; i++) {
if( !h3[i].id ) {
h3[i].id = "h3-" + (i + 1);
}
}
var h2 = document.querySelectorAll("h2");
for (var i = 0; i < h2.length; i++) {
if( !h2[i].id ) {
h2[i].id = "h2-" + (i + 1);
}
}
}; // 创建目录
var createContents = function() {
// 创建 dl 标签
var dl = document.createElement("dl");
dl.id = "dl";
document.body.appendChild(dl); // 遍历所有的标签,找到 h2 和 h3
var tags = document.getElementsByTagName("*");
for (var i = 0; i < tags.length; i++) {
// 如果是 h2 ,则将标题保存在 dt 标签中,并给这个 dt 标签一个 id ,格式为 #h2-*
if(tags[i].nodeName.toLowerCase() === "h2") {
var dt = document.createElement("dt");
dt.id = "#" + tags[i].id;
var dt_text = document.createTextNode(tags[i].firstChild.nodeValue);
dt.appendChild(dt_text)
dl.appendChild(dt);
}
// 如果是 h3 ,则将标题保存在 dd 标签中,并给这个 dd 标签一个 id ,格式为 #h3-*
if(tags[i].nodeName.toLowerCase() === "h3") {
if(tags[i].firstChild) {
var dd = document.createElement("dd");
dd.id = "#" + tags[i].id;
var dd_text = document.createTextNode(tags[i].firstChild.nodeValue);
dd.appendChild(dd_text);
dl.appendChild(dd);
}
}
}
} // 定义目录与标题的联系
// 点击目录中的某一项,将这一项的 id 赋给 hash 值,通过 hash 值的改变定位到相应的标题
function createLink() {
var dl = document.getElementById("dl");
var tags = dl.getElementsByTagName("*");
for (var i = 0; i < tags.length; i++) {
tags[i].onclick = function() {
window.location.hash = this.id;
}
}
}
自定义属性 data 与 dataset 对象
在 impress.js 中,充分利用了 data 来定义各个 step 的样式。首先在 HTML 中的元素标签上定义 data 属性,然后在 JS 中通过 dataset 对象读取,然后 通过 css() 函数为元素添加这些样式。虽然最终的结果与直接在 CSS 样式表中定义的一样,不过这能通过 JS 对样式进行更多控制。
举个栗子,下面是 HTML :
然后在 JS 中通过 el.dataset 获取这些属性,长这样:
var data = el.dataset = {
x : 0,
z : 1000,
rotateY : 45,
rotateZ : 80,
scale : 1
}
然后就可以通过 data 获取具体的属性值,就像这样:
step = {
translate: {
x: toNumber( data.x ),
y: toNumber( data.y ),
z: toNumber( data.z )
},
rotate: {
x: toNumber( data.rotateX ),
y: toNumber( data.rotateY ),
z: toNumber( data.rotateZ || data.rotate )
},
scale: toNumber( data.scale, 1 ),
el: el
};
然后调用 css() 函数将这些样式同时添加到元素上。
css( el, {
position: "absolute",
transform: "translate(-50%,-50%)" +
translate( step.translate ) +
rotate( step.rotate ) +
scale( step.scale ),
transformStyle: "preserve-3d"
} );
鉴于 step.translate 和 step.rotate 是一个对象,为了解析它们的值,还得需要两个辅助函数,如下:
/**
* 设置 3D 转换元素的 translate 值
* @param t 位移值,以对象字面量的形式,属性值不需要带单位
* @return 返回 "translate3d() "
*/
var translate = function(t) {
return "translate3d(" + t.x + "px," + t.y + "px," + t.z +"px) ";
} /**
* 设置 3D 转换元素的 rotate 值
* @param r 旋转值,以对象字面量的形式,属性值不需要带单位
* @return 返回 "rotateX() rotateY() rotateZ() "
*/
var rotate = function( r, revert ) {
var rX = " rotateX(" + r.x + "deg) ",
rY = " rotateY(" + r.y + "deg) ",
rZ = " rotateZ(" + r.z + "deg) "; return revert ? rZ + rY + rX : rX + rY + rZ;
};
自定义事件并立即触发
在 impress.js 的初始化函数中,函数的最后,是这样的:
triggerEvent( root, "impress:init", { api: roots[ "impress-root-" + rootId ] } );
调用的 triggerEvent() 函数长这样:
/**
* 自定义事件并立即触发
* @param el 触发事件的元素
* @param eventName 事件名
* @param detail 事件信息
*/
var triggerEvent = function( el, eventName, detail ) {
var event = document.createEvent( "CustomEvent" );
// 事件冒泡,并且可以取消冒泡
event.initCustomEvent( eventName, true, true, detail );
el.dispatchEvent( event );
};
我个人理解,在初始化完成之后,自定义了一个 impress:init 事件,并立即触发,然后在 root 元素接收该事件,并以此为依据,执行另外的任务。
同样在 impress.js 中,每一幕的进入在经过一段时间的延迟之后,都会自定义一个 impress:stepenter 事件并触发,在 root 上接收到这个事件,从而改变 hash 值。