美文网首页
学习LULU-UI源码系列 - Tab选项卡

学习LULU-UI源码系列 - Tab选项卡

作者: 侠客有情剑无情QAQ | 来源:发表于2018-09-24 23:00 被阅读72次

1、LULU-UI介绍

本系列是学习基于JQuery1.9.0版本的开源UI框架LULU-UI源码文章。自己的目标是学习一些常用组件的写法,以便以后不能使用JS库的时候能自己写。对于LULU-UI的学习过程是先从单依赖组件来渐进学习,本次记录的是我们常用的Tab选项卡的源码学习。点击 效果展示源码地址 可以看到Tab选项卡的效果,以及Tab选项卡插件在页面的使用和Tab源码。

2、HTML部分

<div id="tabView" class="ui-tab-tabs">
    <a href="javascript:" class="ui-tab-tab" data-rel="tabTarget1">选项卡1</a>
    <a href="javascript:" class="ui-tab-tab" data-rel="tabTarget2">选项卡2</a>
    <a href="javascript:" class="ui-tab-tab checked" data-rel="tabTarget3">选项卡3</a>
</div>
<div class="ui-tab-contents">
    <div id="tabTarget1" class="ui-tab-content">内容1</div>
    <div id="tabTarget2" class="ui-tab-content">内容2</div>
    <div id="tabTarget3" class="ui-tab-content checked">内容3</div>
</div>

html部分不多做介绍了,外面可以包裹一层DIV来控制整体的样式。需要注意的是a标签需要绑定dataTarget属性,内容部分需要绑定id属性与a标签的data-rel属性做关联。

2、CSS部分

.ui-tab-tabs {
  height: 40px;
  line-height: 40px;
  border-bottom: 1px solid #d0d0d5;
  position: relative; }

.ui-tab-tab {
  float: left;
  margin-right: 50px;
  font-size: 16px;
  text-align: center;
  color: #4c5161;
  overflow: hidden;
  cursor: pointer; }

.ui-tab-tab a {
  display: block;
  color: #4c5161; }

.ui-tab-tab:hover,
.ui-tab-tab:hover a {
  color: #00a5e0; }

.ui-tab-tabs .checked,
.ui-tab-tabs .checked a,
.ui-tab-tabs .checked:hover {
  line-height: 36px;
  padding-top: 2px;
  margin-bottom: -1px;
  border-bottom: 3px solid;
  color: #00a5e0;
  cursor: default; }

.ui-tab-line {
  display: none;
  position: absolute;
  bottom: -1px;
  left: 0;
  width: 0;
  border-bottom: 3px solid #00a5e0;
  -webkit-transition: all .35s;
  transition: all .35s; }

.ui-tab-tabs > .ui-tab-line ~ .ui-tab-tab {
  line-height: 40px;
  padding-top: 0;
  margin-bottom: 0;
  border-bottom: 0; }

/* contents */
.ui-tab-contents {
  margin-top: 30px; }

.ui-tab-content {
  display: none; }

.ui-tab-content.checked {
  display: block; }

CSS部分设计简洁,有助于自己学习的时候按照这种设计CSS的思路来编写自己的CSS。

3、JS部分:Tab选项卡JS源码几个大步骤

  1. 静态变量的定义
  2. 通用方法的定义
  3. 插件的定义
  4. 对传入方法的参数进行处理
  5. 初始化索引
  6. 事件绑定
  7. url无刷新标记选项卡地址
  8. 模拟点击事件页面初始化调用一次

下面通过注释的方式来对Tab选项卡代码的解读

/**
 * @Tab.js
 * @author xunxuzhang
 * @version
 * Created: 15-06-12
 */

(function (global, factory) {
    if (typeof define === 'function' && (define.amd || define.cmd)) {
        define(factory);
    } else {
        global.Tab = factory();
    }
}(this, function () {
    /**
     * 定制级极简的选项卡
     * 选项卡效果本质上就是单选框切换效果
     * 因此,状态类名使用.checked
     * @使用示例
     *  new Tab($('#container > a'), {
     *     callback: function() {}
     *  });

     * 或者包装器用法
     * $('#container > a').tab({
     *   callback: function() {}
     * });
     */
     
     //静态变量的定义
    var STATE = 'checked';
    /*根据传入的key(key默认是a标签自定义属性的data-rel)来获取属性的value值(value值对应的是content内容区域的ID)*/
    $.fn.eqAttr = function(key) {
        key = key || "data-rel";
        // 获得属性对应的值
        var value = $(this).attr(key);
        if (!value) return $();
        // 当作id来处理
        var target = $("#" + value);
        if (target.length) return target;
        // 否则当作className处理
        return $("." + value);
    };
    
    // 根据属性获得对应的元素,设置为JQuery插件
    $.fn.tab = function(options) {
        //通过data()方法来判断是否已经绑定了Tab对象,如果已经绑定就直接返回。防止重复调用。
        if (!$(this).data('tab')) {
            $(this).data('tab', new Tab($(this), options));
        }
    };

    $.queryString = function(key, value, str) {
        // 有则替换,无则加勉
        var href = (str || location.href).split('#')[0], root = '', hash = location.hash;
        // 查询数组
        var arr_query = href.split('?'), arr_map = [];
        if (arr_query.length > 1) {     
            if (arr_query[1] != '') {
                arr_map = $.grep(arr_query[1].split('&'), function(query) {
                    return query.split('=')[0] != key;
                });
            }
            root = arr_query[0] + '?' + arr_map.join('&') + '&';
            root = root.replace('?&', '?');
        } else {
            root = href + '?';
        }
        return root + key + '=' + value + hash;
    };
    
    /*Tab插件的主要代码*/  
    var Tab = function(el, options) {
        // 选项卡元素,点击主体
        el = $(el);
        // 如果元素没有,打道回府
        if (el.length == 0) return;
        
        // 下面3语句参数获取
        options = options || {};
        var defaults = {
            //事件类型
            eventType: 'click',
            //选中选项卡的索引值。默认'auto'表示根据选项卡上的状态类名,如.checked获取index值。
            index: 'auto',  
            // 是否通过url无刷新标记选项卡地址。默认true表示选项卡切换时候查询地址变化。IE10+增强功能。IE9-使用hash标记。
            history: true, 
             //点击切换的回调。其中,上下文this指点击元素DOM对象。支持4个参数。分别表示:当前点击元素选项卡元素,恢复到非选中态的选项卡元素,显示的面板元素,恢复到非选中态的面板元素。  
            callback: $.noop
        };

         //合并参数对象
        var params = $.extend({}, defaults, options);
        
        // 很重要的索引,indexTab设置为当前传入的索引值
        var indexTab = params.index;
        // 首先,循环对象来获得索引值,绑定到对应的元素上
        el.each(function(index) {
            if (typeof indexTab != 'number' && $(this).hasClass(STATE)) {
                indexTab = index;
            }
            $(this).data('index', index);
        });
        //如果传入的不是数字,索引值默认为 0
        if (typeof indexTab != 'number') {
            indexTab = 0;
        }
        
        
        // 获得选项卡对应的面板元素
        // 两种情况
        // 1. 直接切换
        // 2. ajax并载入
        
        // 目前先第一种
        // 则直接就是页面元素
        // 事件gogogo
        el.on(params.eventType, function(event) {   
            //如果点击的是当前已经选中的样式
            if ($(this).hasClass(STATE)) {
                //如果是代码方式触发事件,就执行回调函数 (目的是页面初始化的时候执行回调函数一次)
                if (event.isTrigger) {
                    //执行传入的回调函数。
                    params.callback.call(this, this, $(), $(), $());
                }
                //直接返回,不再执行后面代码
                return; 
            }
            
            // 选项卡样式变变变
            // 类名变化
            var targetTab = $(this).addClass(STATE),
            // 要移除类名的选项卡
            resetTab = el.eq(indexTab).removeClass(STATE);
            
            // 面板的变化(添加样式和移除样式)
            var targetPanel = targetTab.eqAttr().addClass(STATE),
            resetPanel = resetTab.eqAttr().removeClass(STATE);
            
            // 重新获取当前选中的索引
            indexTab = targetTab.data('index');
            
            // 执行回调方法
            params.callback.call(this, targetTab, resetTab, targetPanel, resetPanel);

            //是否通过url无刷新标记选项卡地址
            if (/^(:?javas|#)/.test(this.getAttribute('href'))) {
                var rel = targetTab.attr('data-rel');
                if (params.history && history.replaceState) {
                    history.replaceState(null, document.title, $.queryString('targetTab', rel));
                } else if (params.history) {
                    location.hash = '#targetTab=' + rel;
                }
                event.preventDefault();
            }
        });
        
        //模拟用户点击事件,页面初始化调用一次该方法
        $(function() {
            el.eq(indexTab).trigger(params.eventType);
        });
                
        // 暴露的属性或方法,供外部调用
        this.el = {
            tab: el 
        };
        this.params = params;
    };
    
    return Tab;
}));

上述就是对JS源码的解读部分。源码难度其实并不大,需要花点时间去学习,通过对源码的学习,会让自己编写插件更有思路,让自己编程方式更简洁。

相关文章

网友评论

      本文标题:学习LULU-UI源码系列 - Tab选项卡

      本文链接:https://www.haomeiwen.com/subject/tlmhoftx.html