需要实现类似下图的一个效果,达到导航图片的目的。
可以使用jquery去实现,但容易陷入怎么做的思维中,如果自己手写的话,就可以先思考做什么,然后再思考怎么做。(当然这里做什么指原型已确定的)
第一步:做什么[分析]?
我们要做一个图片导航,一屏显示5张图片,用户能点“上一张”/“下一张”按钮,实现移动切换图片,如果往前没有图片了则“上一张”是无效状态,如果往后没有图片了则“下一张”是无效状态。
对应到我们的问题域则需要几个对象来完成相应的职责:
1、应该有一个movePanel类,状态:它应该知道总共有多少张图片,一屏显示多少张,当前显示的是哪些,还能不能向前或向后移动了;行为:它有last()和next()方法,分别表示向前或向后移动图片的功能。
function movePanel(totalCount,showNum){
var curStep=0;
this.getCanLast=function(){};
this.getCanNext=function(){};
this.last=function(){};
this.next=function(){};
}
但是有一个问题,没有通知“上一张”/“下一张”按钮的状态切换,所以movePanel还一个通知外界自己状态改变的方法
function notify(){}
还有原型未列出,但出于性能考虑,需要图片预加载
function loadImg(){}
2、原型要求点击按钮后,需要移动的切换图片,即是一个动画效果,我们需要一个做移动类mover,状态:它知道自己所处的坐标;行为:以某种速度移动到另一个坐标;回调函数:当它移动时每一帧的坐标通知给外界,以及到达指定坐标后通知外界。我们通过回调方式,让外界知道当前的状态,而不是直接修改页面元素的坐标,达到解耦目的。
function mover(posX, posY) {
this.moveTo = function (posX, posY, speed, frequencyfn, endfn) { };
}
明确了问题域和相应的职责,即确定了要做什么?接下来是怎么做了。
第二步:怎么做[设计]?
1、实现movePanel类
先实现它的getCanLast和getCanNext两个状态,根据当前位置curStep和总长度totalCount去计算得到相应的状态
this.getCanLast=function(){
if(curStep==0) return false;
return true;
};
this.getCanNext=function(){
if(curStep+showNum>=totalCount) return false;
return true;
};
显然movePanel类中的last()/next()方法是依赖于mover类的,而mover类目前还有没实现,所以我们先用todo占个位。
this.last=function(){
if(!this.getCanLast()) return;
//…todo向前移动的代码
curStep--;
};
this.next=function(){
if(!this.getCanNext()) return;
//…todo向后移动的代码
curStep++;
}
关于通知外界的notify(),我们很自然的想到observer模式,需要一个注册方法和一个观察者队列
var subscriberArray=[];
var me=this;
this.register=function(fn){
subscriberArray.push(fn);
}
function _notify(){
for(var i in subscriberArray){
subscriberArray[i](me);
}
}
由于notify并不会被外界调用,把它设计成私有的,还需要将notify放在last()/next()方法体的最后。
由于register()必须在构建movePanel的实例后才得调用,所以必须增加一个类似初始化显示图片的方法show(),在register()调用后再执行,而不能直接放在movePanel构造函数内。
this.show = function () {
for (var i = 0; i < showNum; i++) {
_loadImg();
}
_notify();
}
假设我们一个加载图片的私有方法loadImg(),关于预加载图片,开始时预加载一张,并在执行next()后,根据情况再进行预加载。所以需要修改show()方法和next()/last()方法,并用一个变量bufferImgCount来跟踪缓存中的图片数量
var bufferImgCount = 0;
this.last = function(){
if (!this.getCanLast()) return;
//…todo向前移动的代码
bufferImgCount++;
curStep--;
};
this.next = function(){
if(!this.getCanNext()) return;
//…todo向后移动的代码
bufferImgCount--;
if (bufferImgCount == 0 && _loadImg())
bufferImgCount++;
curStep++;
}
this.show = function () {
for (var i = 0; i <= showNum; i++) { //include one buffer img
_loadImg();
}
bufferImgCount = 1;
_notify();
}
接下来就要实现 loadImg()方法,这个方法要根据当前已加载的情况,去加载下一个的图片,所以我们需要在movePanel类中增加一个alreadyCreateCount的变量,等等,这个变量其他方法会用到吗,好像不会,那么干嘛不设计成一个闭包,让变量存在闭包中,不去污染movePanel的空间
var _loadImg = (function () {
var alreadyCreateCount = 0;
return function () {// closure function
if (alreadyCreateCount == totalCount) return false;
_createImgByIndexfn(alreadyCreateCount);
alreadyCreateCount++;
return true;
}
})();
其中createImgByIndexfn是回调函数,用于调用具体创建图片的方法,这也跟页面相关,所以不放在这个问题域中。
至此,我们的代码成这样
function movePanel(totalCount, showNum) {
var subscriberArray=[];
var me=this;
var bufferImgCount = 0;
this.getCanLast=function(){
if(curStep==0) return false;
return true;
};
this.getCanNext=function(){
if(curStep+showNum>=totalCount) return false;
return true;
};
this.register=function(fn){
subscriberArray.push(fn);
}
this.last = function(){
if (!this.getCanLast()) return;
//…todo向前移动的代码
bufferImgCount++;
curStep--;
_notify();
};
this.next = function(){
if(!this.getCanNext()) return;
//…todo向后移动的代码
bufferImgCount--;
if (bufferImgCount == 0 && _loadImg())
bufferImgCount++;
curStep++;
_notify();
}
this.show = function (createImgByIndexfn) {
_createImgByIndexfn = createImgByIndexfn;
for (var i = 0; i <= showNum; i++) { //include one buffer img
_loadImg();
}
bufferImgCount = 1;
_notify();
}
var _createImgByIndexfn = function (index) { }; //callback
var _loadImg = (function () {
var alreadyCreateCount = 0;
return function () {// closure function
if (alreadyCreateCount == totalCount) return false;
_createImgByIndexfn(alreadyCreateCount);
alreadyCreateCount++;
return true;
}
})();
function _notify(){
for(var i in subscriberArray){
subscriberArray[i](me);
}
}
}
2、实现mover类
mover类就一个moveTo()方法,要实现它有动画效果,在一定时间内持续移动一定的距离,我们需要一点动画的知识,当连续变化的影像为每秒25次的速度就能给人流畅的感觉,我们就以25/1000为基准,去调节动画移动的快慢,需要借助setTimeout()方法,在适当的时候去执行坐标的变化。如果考虑可用性,我们可以给移动速度一些默认选项(快/中/慢)。
function mover(posX, posY) {
this.posX = posX;
this.posY = posY;
this.speedCfg = { 'slow': 2000, 'normal': 1000, 'fast': 500 };
this.frequency = 25.0 / 1000; //25 frames per second
var me = this;
this.moveTo = function (posX, posY, speed, frequencyfn, endfn) {
if (typeof (speed) == 'string') {
if (!speed in this.speedCfg) { speed = 'normal'; }
speed = this.speedCfg[speed];
}
var steps = speed * this.frequency;
var distanceX = (posX - this.posX) / steps;
var distanceY = (posY - this.posY) / steps;
for (var i = 0; i < steps - 1; i++) {
setTimeout(function () {
me.posX += distanceX;
me.posY += distanceY;
frequencyfn(me.posX, me.posY);
}, (1 / this.frequency) * (i + 1));
}
setTimeout(function () {
this.posX = posX;
this.posY = posY;
endfn(this.posX, this.posY);
}, (1 / this.frequency) * steps);
};
}
我们可以看到,代码中只是纯计算,并不依赖其他页面元素或其他第三方框架,这样是方便测试的,我们只需填上合适的值,就可以看到是否是期望的结果。
<html> <body> <div id='begin'> begin: </div> <div id='frame'> frame: </div> <div id='end'> end: </div> </body> </html> <script> function mover(posX, posY) { this.posX = posX; this.posY = posY; this.speedCfg = { 'slow': 2000, 'normal': 1000, 'fast': 500 }; this.frequency = 25.0 / 1000; var me = this; this.moveTo = function (posX, posY, speed, frequencyfn, endfn) { if (typeof (speed) == 'string') { if (!speed in this.speedCfg) { speed = 'normal'; } speed = this.speedCfg[speed]; } var steps = speed * this.frequency; var distanceX = (posX - this.posX) / steps; var distanceY = (posY - this.posY) / steps; for (var i = 0; i < steps - 1; i++) { setTimeout(function () { me.posX += distanceX; me.posY += distanceY; frequencyfn(me.posX, me.posY); }, (1 / this.frequency) * (i + 1)); } setTimeout(function () { this.posX = posX; this.posY = posY; endfn(this.posX, this.posY); }, (1 / this.frequency) * steps); }; } var dt=new Date(); document.getElementById('begin').innerHTML += '<br/>(X:' + 10 + ' Y:' + 20 + ') @ '+ dt.getSeconds()+"."+dt.getMilliseconds(); new mover(10,20).moveTo( 60, 80, 'normal', function (x, y) { var dt=new Date(); document.getElementById('frame').innerHTML += '<br/>(X:' + x + ' Y:' + y + ') @ '+ dt.getSeconds()+"."+dt.getMilliseconds(); }, function (x, y) { var dt=new Date(); document.getElementById('end').innerHTML += '<br/>(X:' + x + ' Y:' + y + ') @ '+ dt.getSeconds()+"."+dt.getMilliseconds(); } ); </script>
3、使用mover去实现movePanel中的相关方法
我们使用mover实例来具体实现movePanel中的last()/next()方法,由于动画是异步的,所以原先在last()/next()中的todo后面代码需要放在动画结束的回调函数中。
而mover.moveTo所需的相关回调函数,movePanel拦截后,并作为last()/next()方法的参数,供调用方定制。
mover需要当前坐标才能初始化,所以movePanel需要维持当前坐标的变量curPos,curPos的初始化由movePanel参数提供。
具体实现如下
var curPos = { 'x': curLeft, 'y': curTop };
this.last = function (speed, frequencyfn, endfn) {
if (!this.getCanLast()) return;
new mover(curPos.x, curPos.y).moveTo(
_getLastPos().x, _getLastPos().y, speed, frequencyfn,
function (x, y) {
endfn(x, y);
curPos.x = x;
curPos.y = y;
bufferImgCount++;
curStep--;
_notify();
}
);
};
this.next = function (speed, frequencyfn, endfn) {
if (!this.getCanNext()) return;
new mover(curPos.x, curPos.y).moveTo(
_getNextPos().x, _getNextPos().y, speed, frequencyfn,
function (x, y) {
endfn(x, y);
curPos.x = x;
curPos.y = y;
bufferImgCount--;
if (bufferImgCount == 0 && _loadImg())
bufferImgCount++;
curStep++;
_notify();
}
);
};
这里_getLastPos()/_getNextPos()方法是取得上一坐标/下一坐标的私有方法,mover是支持任意坐标间的移动的,但在我们movePanle只需支持横向和纵向就可以,我们需要确定 方向 与 步长 即可计算出下一坐标的值了。这里采用了表驱动的做法,利于减少不必要的if/else,另外如果需要增加新的方向,只需在directCfg增加一个配置即可。
var directCfg = { 'horizontal': [1, 0, -1, 0], 'vertical': [0, 1, 0, -1] }; //table-driven
function _getLastPos() {
return { 'x': curPos.x + directCfg[direct][0] * stepLen,
'y': curPos.y + directCfg[direct][1] * stepLen
};
}
function _getNextPos() {
return { 'x': curPos.x + directCfg[direct][2] * stepLen,
'y': curPos.y + directCfg[direct][3] * stepLen
};
}
第三步:怎么用[调用]?
可以看出movePanel/mover没有依赖页面元素,但最终页面图片的创建是需要依赖这些的。所以需要在调用时将这些依赖通过回调的方式传进去。以下是调用一个示例
var imgList = [//初始化图片列表
{ title: 'A',
src: 'http://img3.douban.com/icon/u1386103-5.jpg'
},
{ title: 'B',
src: 'http://img3.douban.com/icon/u4134736-7.jpg'
},
{ title: 'C',
src: 'http://img3.douban.com/icon/u1364691-1.jpg'
},
{ title: 'D',
src: 'http://img3.douban.com/icon/u4616093-4.jpg'
},
{ title: 'E',
src: 'http://img3.douban.com/icon/u43504680-2.jpg'
},
{ title: 'F',
src: 'http://img3.douban.com/icon/u4523892-23.jpg'
},
{ title: 'G',
src: 'http://img3.douban.com/icon/u1901783-16.jpg'
},
{ title: 'H',
src: 'http://img3.douban.com/icon/u1332495-14.jpg'
},
{ title: 'I',
src: 'http://img3.douban.com/icon/u3919874-2.jpg'
},
{ title: 'J',
src: 'http://img3.douban.com/icon/u31834465-48.jpg'
}
];
//初始化panel,确定起始坐标,方向,步长,图片数量,显示数量
var panel = new movePanel(0, 5, 'horizontal', 39, imgList.length, 4);
panel.register(function (p) {//侦听并更新按钮状态
if (p.getCanLast())
document.getElementById('btnLast').disabled = false;
else
document.getElementById('btnLast').disabled = true;
});
panel.register(function (p) {
if (p.getCanNext())
document.getElementById('btnNext').disabled = false;
else
document.getElementById('btnNext').disabled = true;
});
panel.show(function (index) {//显示,并传入创建图片的回调函数
var img = document.createElement('IMG');
img.src = imgList[index].src;
img.title = imgList[index].title;
document.getElementById('imgs').appendChild(img);
});
document.getElementById('btnLast').onclick = function () {
panel.last('fast', function (x, y) {//响应每一帧的变化
document.getElementById('imgs').style.left = x + 'px';
}, function (x, y) {
document.getElementById('imgs').style.left = x + 'px';
});
};
document.getElementById('btnNext').onclick = function () {
panel.next('fast', function (x, y) {
document.getElementById('imgs').style.left = x + 'px';
}, function (x, y) {
document.getElementById('imgs').style.left = x + 'px';
});
};
这一部份是比较容易变化的区域,比如想用A标签来代替现在的button,创建图片的过程中会加入其他事件等等,如果在这里觉得改变按纽状态,或创建图片比较复杂时,可以考虑使用jquery或者第三方的库(但不能一开始分析问题域时就使用第三方的库)。
完整的代码与示例:
<html> <head> <style> div#content1 {position:relative; width:158px; height:50px; overflow:hidden; padding:0; } div#imgs1 {position:absolute; top:5px; width:1000px; height:40px; padding:0; } div#imgs1 img {margin:2px; width:35px; height:35px; display:block; float:left; } div#content2 {position:relative; width:50px; height:182px; overflow:hidden; padding:0; } div#imgs2 {position:absolute; left:5px; width:40px; height:1000px; padding:0; } div#imgs2 img {margin:2px; width:35px; height:35px; display:block; } </style> </head> <body> <div id='content1'> <div id='imgs1'></div> </div> <input type='button' id='btnLast1' value="last" /> <input type='button' id='btnNext1' value="next" /> <br/> <br/> <div id='content2'> <div id='imgs2'></div> </div> <br/> <input type='button' id='btnLast2' value="last" /> <input type='button' id='btnNext2' value="next" /> </body> </html> <script> /*API Begin*/ function mover(posX, posY) { this.posX = posX; this.posY = posY; this.speedCfg = { 'slow': 1500, 'normal': 1000, 'fast': 500 }; this.frequency = 25.0 / 1000; var me = this; this.moveTo = function (posX, posY, speed, frequencyfn, endfn) { if (typeof (speed) == 'string') { if (!speed in this.speedCfg) { speed = 'normal'; } speed = this.speedCfg[speed]; } var steps = speed * this.frequency; var distanceX = (posX - this.posX) / steps; var distanceY = (posY - this.posY) / steps; for (var i = 0; i < steps - 1; i++) { setTimeout(function () { me.posX += distanceX; me.posY += distanceY; frequencyfn(me.posX, me.posY); }, (1 / this.frequency) * (i + 1)); } setTimeout(function () { this.posX = posX; this.posY = posY; endfn(this.posX, this.posY); }, (1 / this.frequency) * steps); }; } function movePanel(curLeft, curTop, direct, stepLen, totalCount, showNum) { var me = this; var curPos = { 'x': curLeft, 'y': curTop }; var directCfg = { 'horizontal': [1, 0, -1, 0], 'vertical': [0, 1, 0, -1] }; //table-driven var subsciberArray = []; var curStep = 0; var bufferImgCount = 0; var isMoving = false; this.register = function (fn) { subsciberArray.push(fn); }; this.getCanLast = function () { if (curStep == 0) return false; return true; }; this.getCanNext = function () { if (curStep + showNum >= totalCount) return false; return true; }; this.last = function (speed, frequencyfn, endfn) { if (!this.getCanLast()) return; if (isMoving) return; isMoving = true; new mover(curPos.x, curPos.y).moveTo( _getLastPos().x, _getLastPos().y, speed, frequencyfn, function (x, y) { endfn(x, y); curPos.x = x; curPos.y = y; bufferImgCount++; curStep--; _notify(); isMoving = false; } ); }; this.next = function (speed, frequencyfn, endfn) { if (!this.getCanNext()) return; if (isMoving) return; isMoving = true; new mover(curPos.x, curPos.y).moveTo( _getNextPos().x, _getNextPos().y, speed, frequencyfn, function (x, y) { endfn(x, y); curPos.x = x; curPos.y = y; bufferImgCount--; if (bufferImgCount == 0 && _loadImg()) bufferImgCount++; curStep++; _notify(); isMoving = false; } ); }; this.show = function (createImgByIndexfn) { _createImgByIndexfn = createImgByIndexfn; for (var i = 0; i <= showNum; i++) { _loadImg(); } bufferImgCount = 1; _notify(); } var _createImgByIndexfn = function (index) { }; var _loadImg = (function () { var alreadyCreateCount = 0; return function () { if (alreadyCreateCount == totalCount) return false; _createImgByIndexfn(alreadyCreateCount); alreadyCreateCount++; return true; } })(); function _notify() { for (var i in subsciberArray) subsciberArray[i](me); } function _getLastPos() { return { 'x': curPos.x + directCfg[direct][0] * stepLen, 'y': curPos.y + directCfg[direct][1] * stepLen }; } function _getNextPos() { return { 'x': curPos.x + directCfg[direct][2] * stepLen, 'y': curPos.y + directCfg[direct][3] * stepLen }; } } /*API end*/ var imgList = [ { title: 'A', src: 'http://img3.douban.com/icon/u1386103-5.jpg' }, { title: 'B', src: 'http://img3.douban.com/icon/u4134736-7.jpg' }, { title: 'C', src: 'http://img3.douban.com/icon/u1364691-1.jpg' }, { title: 'D', src: 'http://img3.douban.com/icon/u4616093-4.jpg' }, { title: 'E', src: 'http://img3.douban.com/icon/u43504680-2.jpg' }, { title: 'F', src: 'http://img3.douban.com/icon/u4523892-23.jpg' }, { title: 'G', src: 'http://img3.douban.com/icon/u1901783-16.jpg' }, { title: 'H', src: 'http://img3.douban.com/icon/u1332495-14.jpg' }, { title: 'I', src: 'http://img3.douban.com/icon/u3919874-2.jpg' }, { title: 'J', src: 'http://img3.douban.com/icon/u31834465-48.jpg' } ]; /*sample 1 begin*/ var panel1 = new movePanel(0, 5, 'horizontal', 39, imgList.length, 4); panel1.register(function (p) { if (p.getCanLast()) document.getElementById('btnLast1').disabled = false; else document.getElementById('btnLast1').disabled = true; }); panel1.register(function (p) { if (p.getCanNext()) document.getElementById('btnNext1').disabled = false; else document.getElementById('btnNext1').disabled = true; }); panel1.show(function (index) { var img = document.createElement('IMG'); img.src = imgList[index].src; img.title = imgList[index].title; document.getElementById('imgs1').appendChild(img); }); document.getElementById('btnLast1').onclick = function () { panel1.last(200, function (x, y) { document.getElementById('imgs1').style.left = x + 'px'; document.getElementById('btnNext1').disabled = true; document.getElementById('btnLast1').disabled = true; }, function (x, y) { document.getElementById('imgs1').style.left = x + 'px'; document.getElementById('btnNext1').disabled = false; document.getElementById('btnLast1').disabled = false; }); }; document.getElementById('btnNext1').onclick = function () { panel1.next(200, function (x, y) { document.getElementById('imgs1').style.left = x + 'px'; document.getElementById('btnNext1').disabled = true; document.getElementById('btnLast1').disabled = true; }, function (x, y) { document.getElementById('imgs1').style.left = x + 'px'; document.getElementById('btnNext1').disabled = false; document.getElementById('btnLast1').disabled = false; }); }; /*sample 1 end*/ /*sample 2 begin*/ var panel2 = new movePanel(5, 0, 'vertical', 37, imgList.length, 5); panel2.register(function (p) { if (p.getCanLast()) document.getElementById('btnLast2').disabled = false; else document.getElementById('btnLast2').disabled = true; }); panel2.register(function (p) { if (p.getCanNext()) document.getElementById('btnNext2').disabled = false; else document.getElementById('btnNext2').disabled = true; }); panel2.show(function (index) { var img = document.createElement('IMG'); img.src = imgList[index].src; img.title = imgList[index].title; document.getElementById('imgs2').appendChild(img); }); document.getElementById('btnLast2').onclick = function () { panel2.last(200, function (x, y) { document.getElementById('imgs2').style.top = y + 'px'; document.getElementById('btnNext2').disabled = true; document.getElementById('btnLast2').disabled = true; }, function (x, y) { document.getElementById('imgs2').style.top = y + 'px'; document.getElementById('btnNext2').disabled = false; document.getElementById('btnLast2').disabled = false; }); }; document.getElementById('btnNext2').onclick = function () { panel2.next(200, function (x, y) { document.getElementById('imgs2').style.top = y + 'px'; document.getElementById('btnNext2').disabled = true; document.getElementById('btnLast2').disabled = true; }, function (x, y) { document.getElementById('imgs2').style.top = y + 'px'; document.getElementById('btnNext2').disabled = false; document.getElementById('btnLast2').disabled = false; }); }; /*sample 2 end*/ </script>
结论:
“做什么”,根据需求,建立问题域,分析相应的职责与协作,这其实是面向对象分析的范畴(问题域其实与具体实现语言的关联性并不大)。
“怎么做”,根据建立的问题域,利用一些设计手法,尽可能无依赖(第三方库/框架/浏览器特性/页面元素等)的实现相应的类或函数,将易变的部分解耦(javascript的编程既可使用面向对象的技术来解依赖,如例子中的observer,也有它自己的一些方式,如闭包,回调,表驱动等),并适当考虑更好的复用。这部分属于API设计与实现范畴。
“怎么用”,根据已实现API,进行调用,既依赖于API,也可能依赖于第三方库,包括结合CSS和HTML达到想要的效果,处于易变区域。属于实现与配置范畴。