【jQuery UI 1.8 The User Interface Library for jQuery】.学习笔记.4.Tabs控件

时间:2021-10-02 15:33:57

之前,我们已经介绍了 jQuery UI 库,CSS 框架。下面,我们将学习这些有增强可视化效果,高度可配置的用户交互组件。

Tab 的特性是,点击 tab 后,会高亮该 tab,并显示他的关联content panel,期间会确保所有其他的 content panel 是 hidden。一次最多只有一个 content panel 可以被打开,也可以没有。

本章我们主要介绍以下几点:

  • 默认安装启用控件
  • CSS框架是如何触发 tab 控件
  • 怎样为一组 tabs 应用自定义样式
  • 使用 tab 控件的配置选项配置它
  • content panel 变换时,内置过渡效果
  • 使用 tab 控件的方法控制他们
  • tab 的自定义事件
  • AJAX tabs

1.默认安装启用 tab

(function($){ $("#myTabs").tabs(); })(jQuery); </html>

Tab 控件一般由几个特定方式组合在一起的基本HTML元素构建:

  • 一个调用 tabs 方法的外层容器元素
  • 一个元素列表 ,如<ul> 或 <ol>
  • 每个 <li> 都是一个 tab,其中包含 一个 <a> 元素
  • 每个 tab 的 content panel 元素

链接的 href 属性必须设置 # 为前缀的 识别。content panel 使用 <div> 元素,也可以使用其他HTML元素,panle Template 和 tabTemplate配置选项可以用来设置构成控件的匀速。

在 style sheets 和 page elements 后面加载 script ,被证明是一种能够显然改善加载时间的技巧,一旦有可能就要使用。

在链接了jQuery后,我们链接到所有的组件都必须的jquery.ui.core.js文件(除了 effects,它们有自己的 core 文件),还有jquery.ui.widget.js文件。这时我们连接到组件自己的源文件,jquery.ui.tabs.js。

在加载了必须的 script 后,我们加载自己的 script。

2.Tab CSS框架 classes

来简短地复习下 classnames,看看它们如何为控件外貌做贡献 。

外层div 被加上以下 classnames:

Classname Purpose
ui-tabs 允许应用tab特有的结构CSS
ui-widget 设置一般字体样式,被嵌入元素继承
ui-widget-content 提供主题特有的样式
ui-corner-all 为容器应用圆角

<ul>元素被加上以下 classnames:

Classname Purpose
ui-tabs-nav 允许应用tab特有的结构CSS
ui-helper-reset 使应用到<ul>上的浏览器应特有的样式失效
ui-helper-clearfix 当这个元素有子元素在浮动,为这个元素应用clear-fix
ui-widget-header 提供主题特有的样式
ui-corner-all 应用圆角

成为tab headings 的每个<li>元素个体,被加上了以下classnames:

Classname Purpose
ui-state-default 为tab headings 应用基本的、没有激活的、没有被选中的、没有被鼠标悬停的状态
ui-corner-top 将元素上边缘设置为圆角
ui-tabs-selected 仅仅被用在活动的tab上。页面加载后默认是第一个tab,选择其他的tab 会从当前被选中的tab上移除这个class,并应用到新的选中的tab上。
ui-state-active 为当前选中的tab应用主题特有的样式,像ui-tabs-selected一样工作。ui-tabs-selected提供CSS功能,而ui-state-active提供可视化,装饰样式。

每个<li>中的<a>元素,没有得到任何classnames,但是框架依然会为他们应用结构和主题特有的样式。

panel 元素被加上以下classnames:

Classname Purpose
ui-tabs-panel 为content panels应用结构CSS
ui-widget-content 应用主题特有的样式
ui-corner-bottom 为content panels的下边缘应用圆角

所有这些classes被库自动地添加到HTML元素下面,我们在页面编码时或添加基本的化妆时,不需要手动添加他们。

3.为tabs应用自定义主题

下面我们通过覆盖的方法,改变tabs的基本外貌。

}

我们覆盖了jquery.ui.tabs.css中的规则。我们需要使用我们容器元素和jquery.ui.theme.css中的选择器   的ID选择器,最后击败 .ui-tabs .ui-tabs-panle。

4.配置选项

不是默认的行为如下:

Option Default value Used to…
ajaxOptions null 指定额外的AJAX选项。我们可以使用任何jQuery的$.ajax()方法暴漏的选项,如data,type,url等。
cache false 控制远程数据仅在页面初始化时被加载一次。还是每次相应的tab被点击时都被重新加载。
collapsible false 允许一个活动的tab被点击后不被选中,所有的content panels被hidden ,只有tab headings 可见。
cookie null 使用页面加载的cookie data来显示活动tab。这个选项必须使用cookie插件。
disabled false 页面加载时禁用控件。我们也可以传送一个tab索引(从0开始)目录数组来禁用指定的tabs。
event “click” 指定播放content panels时触发的事件
fx null 指定一个变换tabs时的动画效果。支持一个对象或一个动画效果数组。
idPrefix “ui-tabs-” 当远程tab heading的<a>元素没有title attribute,为其生成一个独一无二的ID和碎片标识。
panelTemplate “<div></div>” 指定tab panel的 content 部分所使用的元素名称。
selected 0 当页面加载时,显示一个不是第一个的tab panel(覆盖cookie属性)
spinner “Loding&#8230” 为远程tabs指定加载图标。
tabTemplate <li>
<a href=”#{href}”>
<span>
#{label}
</span>
</a>
</li>
指定当创建一个新的tabs时所使用的元素。当新tab被创建时,#{href}和#{label}字符串会被控件内部替换

4.1 选一个tab,selected、disabled、collapsible选项

var tabOpts = {
selected: 1,
disabled:[2],
collapsible:true
};
$("#myTabs").tabs(tabOpts);

索引从0开始。当页面加载后,第三个tab被应用上ui-widget-disabled,从ui.theme.css获得disabled样式。它不再会相应任何鼠标的交互。

4.2 过渡效果,fx 选项

var tabOpts = {
fx: [{
opacity: "toggle",
duration: "slow"
},
null]
};

设置 fades-out 为淡出,设置 fades-in 为null。

toggle是切换的意思,opacity是不透明,即在可见和不可见见切换。duration是持续时间。

var tabOpts = {
fx: {
opacity: "toggle",
duration: "slow"
}
};

只设置一个时,此时fades-out 和 fades-in 共享此选项。

5. tab的事件

Event Fired when…
add 一个新tab已经被添加
disable 一个tab已经被禁用
enable 一个tab已经被启用
load 一个tab的远程数据已经被加载完毕
remove 一个tab已经被移除
select 一个tab已经被选择
show 一个tab已经被显示

每个组件都有回调选项,我们总是在变更执行之前调用回调函数。因此,你可以从你的回调返回一个false来防止执行。

(function($){
var handleSelect =function(e, tab) {
$("<p></p>", {
text: "Tab at index "+ tab.index +" selected",
"class": "status-message ui-corner-all" }).appendTo(".ui-tabs-nav", "#myTabs").fadeOut(5000, function()
{
$(this).remove();
});
},
tabOpts = {
select: handleSelect
}
$("#myTabs").tabs(tabOpts);
})(jQuery);
.status-message { padding:11px 8px 10px; margin:0; border:1px solid #aaa; position:absolute; right:10px; top:9px; font-size:11px; background-color:#fff; } <style>

5.1 绑定事件

使用组件暴漏的事件回调函数是控制交互的基本的方式,然而,我们也可以抓住在任何组件任何时间触发的事件。我们可以使用基本的jQuery bind()方法,将自定义事件绑定到 event handler,通过像绑定一个基本DOM事件那样,以同样的方式触发,例如点击。下面是自定义绑定事件和它们的触发时机:

Event Fired when…
tabsselect  
tabsload  
tabsshow  
tabsadd 一个tab已经被加到界面
tabsremove 一个tab已经从界面移除
tabsdisable  
tabsenable  

列表中的前三个事件依次发生。这些事件有不同的触发时机,有时在执行之前触发,有时在执行后触发。

(function($) {
$("#myTabs").tabs();
$("#myTabs").bind("tabsselect", function(e, tab) {
alert("The tab at index "+ tab.index +" was selected");
});
})(jQuery);
</script>

通过绑定 tabsselect 和使用 select 回调函数产生同样的效果,在新tab激活前,显示提示信息。所有的空间都能使用bind()方法,只需简单地替换事件的前缀。

6 使用tab的方法

Method Used to…
abort 停止当前进程中的任何的动画或AJAX请求
add 以编码的方式添加一个新tab,指定 content的 URL,一个 label,和可选的index作为参数。
destroy 完全地移除tabs控件
disable 通过传递一个以0开头的索引数字给此方法,禁用指定tab。或什么都不传,禁用全部tabs
enable 通过传递一个以0开头的索引数字给此方法,启用指定tab。或什么都不传,启用全部tabs
length 返回tabs控件的个数
load 重载AJAX tab的 content,指定tab的索引数字。
option 在控件初始化后,get或set 任何属性
remove 指定tab的索引,通过编码的方式移除一个tab。如果没有提供索引,则第一个tab被移除。也可以用tab的href值移除它
rotate 在指定的milliseconds后,自动改变活动tab,一次或者重复地。
select 基于索引,以编码的方式选择一个tab,与浏览者点击一个tab的效果一样。
url 改变AJAX tab的content的URL。这个方法需要tab的索引数字和新url。
widget tabs() widget方法被调用时,返回该元素。

6.1 启用、禁用tabs

(function($){
$("#myTabs").tabs({
disabled: [1]
});
$("#enable").click(function() {
$("#myTabs").tabs("enable", 1);
});
$("#disable").click(function() {
$("#myTabs").tabs("disable", 1);
});
})(jQuery);
</script>

第一个参数是方法名称,第二个参数是索引号。不传递第二个参数将启用禁用全部tabs。

6.2 添加、移除tabs

(function($){
$("#myTabs").tabs();
$("#remove").click(function() {
$("#myTabs").tabs("remove", parseInt($("#indexNum").val(),
10));
});
$("#add").click(function() {
$("#myTabs").tabs("add", "remoteTab.txt", "A New Tab!");
});
})(jQuery);

remove若没有指定索引参数,则删除全部tabs。

add的第二个参数会读取文件中的内容,还可以增加一个索引参数,定义新标签新增的位置,如果没有,则默认在最后一个。

6.3 创建旋转木马样式的tab

rotate方法会使得所有的tabs(和它关联的content panel)自动地一个接一个地播放。

(function($){
$("#myTabs").tabs().tabs("rotate", 1000, true);
})(jQuery);
</script>

尽管我们不能直接地使用初始化的tabs()方法,我们依然可以在链式地使用它。第一个参数是milliseconds,第二个参数是表明循环式是一直不断地还是仅仅发生一次。

6.4 destroy 方法

和所有的jQuery UI控件一样,拥有destroy方法。这个方法会完全移除tab控件,回到HTML的原始状态。如果原始tabs采用硬编码的形式,而不是那些使用add方法添加的,destroyed后会依然残存。

6.5 Getting 和 Setting 选项

ddafaf
fasdfafa
$(function(){
$("#myTabs").tabs();
$("#show").click(function(){
$("<p></p>").text("Tab at index"+$("#myTabs").tabs("option","selected")+" is active")
.appendTo(".ui-tabs-nav").fadeOut(1000);
});
$("#setIndex").click(function(){
$("#myTabs").tabs("option","selected",parseInt($("#newIndex").val(),10));
});
});
</script>

我们通过传递一个字符串 selected 作为第二个参数。任何option的值都能通过这种方法访问到。

7 AJAX tabs

$("#myTabs").tabs();

如果你使用的是DOM浏览器,你会看到我们添加的远程tab的文件路径已经被替换。作为替代,它生成了一个新的片段标示符,并设置给了href。新的片段作为新tab的id,所以tab heading依然显示这个tab。
从外部文件加载数据,依然可以从URLs加载。当使用查询字符串加载content从数据库,或者从web service的时候,很有用。AJAX tabs包含 load 和 url 方法。load 方法用来从在或者重载 content,它能够非常方便地刷新变化很频繁content。
tabs 空间的AJAX功能没有构建固有的 cross-domain 支持 。因此,除非附加地使用PHP或也谢其他的server-scripting language作为代理,
才能使用JSON结构的数据和jQuery的JSONP功能,不然的话文件或者URLs必须处于同一个domain。

7.1 改变远程tab的content 的URL

ddafaf
$(function(){
$("#fileChooser").change(function(){
$("#myTabs").tabs("url",1,$(this).val());
});
$("#myTabs").tabs();
});
</script>

我们只需调用url方法,传递tab的索引和新的URL。

7.2 远程tab的重载

也许你已经注意到了,当远程tab的url已经变更,但是此时content没有更新。直到切换到不同的tab再切换回来。为了维修这个问题,可以使用 load 方法。

$(function(){
$("#fileChooser").change(function(){
$("#myTabs").tabs("url",1,$(this).val()).tabs("load",1);
});
$("#myTabs").tabs();
});

tab heading轻微的闪烁是因为 spinner 选项的默认值被设为 Loading。

7.3 显示通过JSONP获得的数据

使用 jQuery 库的 getJSON 方法,可以绕过 cross-domain 的排除政策,并显示来自其他的 domain 的供给。

ddafaf
(function($){
var img=$("<img />",{
height:100,
width:100 }),
tabOpts={
select:function(event,ui){
if(ui.tab.toString().indexOf("flickr")!=-1){
console.log("flickr");
var flickerAPI ="http://api.flickr.com/services/feeds/photos_public.gne?jsoncallback=?";
$.getJSON(
flickerAPI,
{
tags:"nebula",
format:"json",
tagmode: "any" },
function(data){
console.log("sucess");
$("#flickr").empty();
$.each(data.items,function(i,item){
console.log(i);
img.clone().attr("src",item.media.m).appendTo("#flickr");
if(i==5){
returnfalse;
}
});
}
);
}
}
};
$("#myTabs").tabs(tabOpts);
})(jQuery);
</html>

每次id 为 filickr 的 tab 被选中,jQuery getJSON 方法被用来重新获得 http://www.flickr.com 提供的供给。
一旦数据返回,首先清空contents来防止。。。。然后使用 jQuery 的 each() 功能方法,迭代返回的JSON中的每一个对象,并创建一个 img 克隆来存储。
没个图像的新的拷贝都有src属性,它被设为当前供给对象的信息,并把图像添加到空的tab中。一旦迭代超过6次,我们推出each()方法。

8 总结

tab控件是一个卓越的方式,来组织相关或完全无关的 content 节,当访问者点击的时候让它们隐藏或显示,来节省页面上的空间。它可以调高站点的交互性,提升全部的功能,提供有吸引力的页面。