最近都忙着写这个插件,用它来统合跑马灯(marquee),轮播(carousel),风手琴(accordion), 切换卡(tabs), slide(幻灯片)这五种控件。
下面是它们的一些描述:
- 跑马灯没有触发点(trigger),而显示内容通常是一行行文字或扁平状的图片,自动往上往下滚动。不过也有从左到右滚动的。
- 轮播经常出现新闻的首页,触发点与面板个数相同,基本上从左到右切换,到了尽头回到第一张继续切换。触发点都浮于控件的最上层的右下角。
- 风手琴与轮播很相似,不过很少会自动进行自动切换。其触发器与控件同宽或同高,非常显眼。
- 切换卡的触发器会于控件的上方,也比较少自动切换。
- 幻灯片基本会提供两个触发点,上一页与下一页,还有绑定键盘事件进行上下翻。
因此,我们要提供一个API,用于让用户切换到指定的面板,同时让对应的触发点处于激活状态(高亮状态)。
另外此五个控件就只在HTML结构上存在出入,什么功能只是添多或添少的问题而已。因此我提供了两种方案来指定控件的主体。一种是像EXT那样,其HTML与CSS都是动态生成的,另一种是,指定页面已有的某一HTML片段作为页面的主体。然后再从这主体中抽取出触发点(triggers)与面板(panels),转化为控件实例的属性,供其他API调用。
下面是其API的说明:
$.fn.switchable(settings)
settings的配置参数:
- data:用于创建控件,必须是一个对象数组,每个对象都拥有trigger(可选)与panel属性。
- data_expr:页面现存的具有切换卡,手风琴等结构的HTML元素的CSS表达式。此属性与data属性只能二选一。
- trigger_class:触发器的类名,它起着类似按钮的作用,用于切换面板。
- panel_class:面板的类名。
- active_class:处于激活状态的面板与触发器都会添加上此类名。
- active_event:用于切换面板的事件,不是click就是mouseover。
- active_callback:切换面板时的回调函数。
- autoplay:是否自动进行切换,默认是false。
- pause_over_panel:当鼠标移到控件之上是否中止切换,默认是false。
- interval:切换面板后要延迟多久才自动开始下一个切换,单位为ms,默认是1000。
- switch_out:正在处于激活状态的面板在失去激活状态时要进行的切换动画,默认是$.fn.slideUp。
- switch_out_args:上面动画的参数, 默认为500。
- switch_in:某一面板在变成激活状态时要进行的切换动画,默认是$.fn.slideDown。
- switch_in_args:上面动画的参数, 默认为500。
切换卡对象默认拥有以下方法,都是使用$(expr).tabs(method,args1,args2,args3)的形式进行调用:
- active(index, [callback],[e]): 切换到某一面板,index为面板的序号,从零开始。callback为回调函数,e为事件对象。回调函数中的this指向事件源对象或ui.target[0], 参数为e或ui
- remove(index, [callback]): 移除到某一面板,index为面板的序号,从零开始。callback为回调函数,拥有一个参数,就是实例自身, this指向ui.target[0]。
- add(index, trigger, panel): 在某一切换卡之后添加一个切换卡,trigger与panel为新切换卡的按钮与面板。
- destroy(): 销毁切换卡实例,移除相关事件绑定。
- invoke(method, args1, args2): 如果method为实例的一个方法,则调用此方法,将其他参数传进去,否则则重写或添加相关属性。