myFocus代码库使用方法总结

简单3步，你即可以用上myFocus。

Step 1. 在html的标签内引入相关文件

<script type="text/javascript" src="js/myfocus-2.0.0.min.js"></script><!--引入myFocus库-->
<script type="text/javascript" src="js/mf-pattern/slide3D.js"></script><!--引入风格js文件-->
<link href="js/mf-pattern/slide3D.css" type="text/css" /><!--引入风格css文件-->

提示：符合条件的情况下，引入风格文件(js/css)可省，引入myFocus库即可。那么风格文件是如何自动引入的？详情请看myFocus的文件结构与自动引入风格文件机制。

Step 2. 创建myFocus标准的html结构，并填充你的内容

<div id="boxID"><!--焦点图盒子-->
  <div class="loading"><img src="img/loading.gif" alt="请稍候..." /></div><!--载入画面(可删除)-->
  <div class="pic"><!--内容列表(li数目可随意增减)-->
  	<ul>
        <li><a href="#"><img src="img/1.jpg" thumb="" alt="标题1" text="详细描述1" /></a></li>
        <li><a href="#"><img src="img/2.jpg" thumb="" alt="标题2" text="详细描述2" /></a></li>
        <li><a href="#"><img src="img/3.jpg" thumb="" alt="标题3" text="详细描述3" /></a></li>
        <li><a href="#"><img src="img/4.jpg" thumb="" alt="标题4" text="详细描述4" /></a></li>
        <li><a href="#"><img src="img/5.jpg" thumb="" alt="标题5" text="详细描述5" /></a></li>
  	</ul>
  </div>
</div>

IMG标签的属性说明：

• src : 图片地址；
• thumb : 图片的略缩图地址(需要风格支持，可以省略，如果省略即把大图地址作为它的地址)；
• alt : 图片的描述文字；
• text : 图片更详细的描述文字(需要风格支持，可以省略)

Step 3. 在step1代码之后的任意一个位置调用(建议在head标签结束前调用)

//你可以简单的调用---只设置它的盒子id，其它参数全部默认设置：
<script type="text/javascript">
myFocus.set({id:'boxID'});
</script>

//或详细一点的参数调用：
<script type="text/javascript">
myFocus.set({
    id:'boxID',//焦点图盒子ID
    pattern:'mF_fancy',//风格应用的名称
    time:3,//切换时间间隔(秒)
    trigger:'click',//触发切换模式:'click'(点击)/'mouseover'(悬停)
    width:450,//设置图片区域宽度(像素)
    height:296,//设置图片区域高度(像素)
    txtHeight:'default'//文字层高度设置(像素),'default'为默认高度，0为隐藏
});
</script>

//更多参数设置及jQuery方式调用请查看使用者API。

进过这3步，你应该可以在浏览器欣赏到你的杰作了。enjoy it~

myFocus的文件结构与自动引入风格文件机制

事实上，风格文件是不需要在使用时手动引入，myFocus会根据你的pattern设置，寻找myFocus库文件目录下的mf-pattern目录，当找到相应的风格文件后，自动引入。

这样，你只需要把你的风格文件放在myFocus库文件目录下的mf-pattern目录内，即可实现自动引入机制。

例如，你的myFocus-2.0.0.min.js文件放在js目录，那么，只需在js目录内建立一个mf-pattern的子目录，这个子目录便是myFocus程序可以识别的存放风格文件的目录。

在mf-pattern目录中，也存在一个img的子目录，它是存放某些风格的图片文件，虽然并不是每款风格都会有图片文件。

建议把所有的风格文件都存放在这个mf-pattern目录，这样你就可以随意切换你的风格了，而且它是按需加载，并不会引入其它多余的文件。myFocus的整个加载量(主库+风格)平均只有12KB左右。

另外需要说明的是，这个自动引入机制已经做的足够智能，它并不会重复引入风格文件，例如当你已经手动引入风格文件，又或者干脆把某风格的js代码写在页面上，这时myFocus并不会再次寻找引入风格文件，而是直接读取页面上的。

如何做简单的修改:

修改css文件 - 个性化样式

每个风格应用都有一个css文件，你可以很方便的修改它以适合你自己网站的风格

myFocus CSS样式规则常见定义有

• .pic(主图class)
• .txt(文字class)
• .num(数字按钮class)
• .thumb(略缩图class)

以‘mF_taobao2010’这款风格应用为例，因为是淘宝风格默认是橙色，如果我网站的主题色是蓝色，该怎么改？

经过观察，只需更改它的按钮颜色即可：

 .mF_taobao2010 .num li a{float:left;color:#333;width:20px;height:18px;position:relative;line-height:18px;border:1px solid #196BA9;text-align:center;margin-right:3px;cursor:pointer;background:#C1C8BD;text-decoration:none;}/*改字体颜色、边框颜色、背景颜色*/ .mF_taobao2010 .num li.current a,.mF_taobao2010 .num li.hover a{background:#0099FF;color:#fff;border-color:#196BA9;font-weight:bold;height:20px;line-height:20px;top:-2px;}/*按钮的当前(current)、悬停(hover)样式最好也一起改*/

我再想改变数字按钮的位置？那也一样很简单：

.mF_taobao2010 .num{position:absolute;z-index:3;left:6px;top:6px;}/*按钮样式*/

全部修改完毕，点击查看demo

修改js文件 - 个性化运动效果

还是以‘mF_taobao2010’这款风格应用为例。

它的缓动形式(easing)默认有中有5种选择:'linear'(匀速),'swing'(摆钟),'easeOut'(减速),'easeIn'(加速),'easeInOut'(加速再到减速),如果你想你的焦点图运动的更酷一点，你可以加入更多的缓动函数，myFocus支持Tween类的所有缓动算法。(Tween类运动相关资料)，另外myFocus也提供了整套easing缓动插件的下载：myFocus.easing.2.0

在下例中，我们将给它添加一个easeOutElastic的运动效果。

1、首先在这款风格应用的js文件中加入下面运动算法代码（在myFocus.easing.2.0文件中取出）：

myFocus.extend( myFocus.fn.easing {//为myFocus的easing缓动类加入easeOutElastic运动算法
    easeOutElastic: function (t, b, c, d) {
		var s=1.70158;var p=0;var a=c;
		if (t==0) return b;  if ((t/=d)==1) return b+c;  if (!p) p=d*.3;
		if (a < Math.abs(c)) { a=c; var s=p/4; }
		else var s = p/(2*Math.PI) * Math.asin (c/a);
		return a*Math.pow(2,-10*t) * Math.sin( (t*d-s)*(2*Math.PI)/p ) + c + b;
	}
});

2、再在参数easing设置中选择'easeOutElastic'效果：

<script type="text/javascript">
myFocus.set({
    id:'boxID',//焦点图盒子ID
    pattern:'mF_name',//风格应用的名称
    time:3,//切换时间间隔(秒)
    trigger:'click',//触发切换模式:'click'(点击)/'mouseover'(悬停)
    width:450,//设置宽度(主图区)
    height:296,//设置高度(主图区)
    txtHeight:'default',//文字层高度设置,'default'为默认高度，0为隐藏
    easing:'easeOutElastic' });
</script>