首页前端开发HTMLhtml5写一个BUI折叠菜单插件的实现方法

html5写一个BUI折叠菜单插件的实现方法

时间2024-01-25 01:42:29发布访客分类HTML浏览774
导读:收集整理的这篇文章主要介绍了html5写一个BUI折叠菜单插件的实现方法,觉得挺不错的,现在分享给大家,也给大家做个参考。 写一个BUI折叠菜单插件效果预览控件分析控件结构一个点击显示隐藏的效果, 并且点击的时候, 会先把展开进行...
收集整理的这篇文章主要介绍了html5写一个BUI折叠菜单插件的实现方法,觉得挺不错的,现在分享给大家,也给大家做个参考。

写一个BUI折叠菜单插件效果预览

控件分析控件结构

一个点击显示隐藏的效果, 并且点击的时候, 会先把展开进行隐藏, 再展开自己的. 从界面上我们来看看结构的设计.
!-- 一般控件最外层就是控件的容器名 -->
    div class="bui-foldmenu">
        div class="bui-foldmenu-item">
    菜单/div>
        div class="bui-foldmenu-content">
    内容/div>
        div class="bui-foldmenu-ITem">
    菜单2/div>
        div class="bui-foldmenu-content">
    内容2/div>
    /div>
    
这里我们采用的是并列同级的方式, 那结构写起来有点麻烦, 其实这个结构跟 dl,dt,dd 是一致的, 那我们完全可以优化成以下结构.
!-- 一般控件最外层就是控件的容器名 -->
    dl class="bui-foldmenu">
        dt>
    菜单/dt>
        dd>
    内容/dd>
        dt>
    菜单2/dt>
        dd>
    内容2/dd>
    /dl>
    
bui的设计是基于按钮的原型撑开容器的方式, 这样可以保持每个容器都是一致的标准高度, 所以我们再对结构进行优化.
!-- 一般控件最外层就是控件的容器名 -->
    dl class="bui-foldmenu">
        dt class="bui-BTn">
    菜单/dt>
        dd>
    内容/dd>
        dt class="bui-btn">
    菜单2/dt>
        dd>
    内容2/dd>
    /dl>
    
像刚刚效果图,菜单的点击还会有图标的切换, 再结合布局来得到以下结构, 一切皆布局, 一切皆容器.
!-- 一般控件最外层就是控件的容器名 -->
    dl class="bui-foldmenu">
        dt class="bui-btn bui-box">
    div class="span1">
    菜单/div>
    i class="icon-foldmenu">
    /i>
    /dt>
        dd>
    内容/dd>
        dt class="bui-btn bui-box">
    div class="span1">
    菜单2/div>
    i class="icon-foldmenu">
    /i>
    /dt>
        dd>
    内容2/dd>
    /dl>
    

控件样式

一般作为插件的独立样式引入, bui-foldmenu.css文件

 

.bui-foldmenu {
}
    .bui-foldmenu>
    dt,.bui-foldmenu>
[class*=bui-btn] {
        border: 0;
        border-bottom: 1px solid #eee;
}
    /*  默认隐藏内容 */.bui-foldmenu>
dd {
        display: none;
        border: 0;
        overflow-y: auto;
        border-bottom: 1px solid #eee;
        background: #fff;
}
/*  图标 */.bui-foldmenu .icon-foldmenu {
        -webkit-transition: -webkit-transform 0.3s ease-in-out 0s;
        transition: transform 0.3s ease-in-out 0s;
}
.bui-foldmenu .icon-foldmenu:before {
        content: "\e649";
}
    /* 激活的时候显示block */.bui-foldmenu>
.active+dd {
        display: block;
}
    /* 激活的二级菜单的时候,把箭头翻转 */.bui-foldmenu>
.active .icon-foldmenu {
        -webkit-transform: rotate(-180deg);
        transform: rotate(-180deg);
}
    
样式里面就默认隐藏内容标签(dt相邻的dd),由控件初始化, 其它都是一些修饰, 设置激活状态的时候,箭头翻转.

控件脚本

1.5.4 新增 bui.extend 方法,可以用来扩展插件, 并且保持跟 bui原本的使用方式一致.

bui.extend 控件参数是一个对象, 其中包含以下参数

name string 控件名称config object 控件默认参数callback function 控件的逻辑最简单的版本

// 最简单的版本bui.extend({
    name: "foldmenu",    config: {
        id: ""    }
,    callback: function(opt) {
            // that 指向插件的抛出的公共方法, option widget 等        let that = this;
            // this.config 为已经跟初始化参数合并以后的结果;
            let param = this.config;
            // 缓存选择器        let $id = null;
        // 要抛给开发者的方法        that.init = function(option) {
            // 对直接调用init方法的参数进行合并            param = $.extend(true, {
}
    , param, option);
                // 单页多页选择器,如果是单页,这个插件只能在模块里面用, 不能在bui.ready            $id = bui.$(param.id);
                // 绑定事件,点击的时候增加激活样式            $id.children("dt").click(function(e) {
                    VAR hasActive = $(this).hasClass("active");
                if (hasActive) {
                        $(this).removeClass("active");
                }
 else {
                        // 加上样式以后会自动对箭头及下一层级展示处理;
                        $(this).addClass("active");
                }
            }
    )            return that;
        }
        // 如果有依赖bui控件,应该在这里写,这样方便外部调用        // that.widgets.loading = ui.loading({
        //     apPEndTo: opt.id        // }
    );
        // 如果需要销毁的生命周期,则在这里加上.        // that.beforedestroy = function() {
            //        //     return that;
        // }
        // 必须传id        if (!param.id) {
                // 抛出错误            bui.showLOG("必须传id参数.")            return that;
        }
            // 默认先初始化一次        return this.init(opt);
    }
}
    );
    

控件使用

dl id="folder" class="bui-foldmenu">
        dt class="bui-btn">
    菜单/dt>
        dd>
    内容/dd>
        dt class="bui-btn">
    菜单2/dt>
        dd>
    内容2/dd>
    /dl>
    
  // 初始化  var uiFloder = bui.foldmenu({
id:"#folder"}
    )  // uiFloder.config 可以拿到一些实例的参数

插件预览

在线预览bui.folder插件

完善插件

用闭包防止全局污染

放在一个闭包里,这样可以防止控件受到污染, window.libs 指的是 zepto 或者 jquery, 当你去掉引入 zepto.js 的时候, 引入 jquery.js 就可以完美切换成jquery版本. (jquery版本建议在: 1.9.x - 1.11.x)
;
(function(ui, $) {
        "use strict";
}
)(window.bui || {
}
    , window.libs);
    

加上注释

/* @namespace bui  *  @class foldmenu  *  @constructor  *  @param {
object}
 option  *  @param {
string}
 option.id [控件id]  *  @param {
string}
 [option.handle] [点击的区域]  *  @param {
number}
 [option.height] [父层高度,0则自适应]  *  @param {
string}
 [option.target] [要显示隐藏的目标]  *  @param {
number}
 [option.targetHeight] [目标自适应高度还是限制高度]  *  @param {
boolean}
 [option.single] [ false(显示多个) || true(一次只折叠一个) ]  *  @param {
function}
 [option.onInited] [ 1.5.1新增 初始化以后触发 ]  *  @param {
function}
     [option.callback] [ 点击按钮的回调 ]  *  @example  *  */

完整版

;
(function(ui, $) {
        "use strict";
    /* @namespace bui      *  @class foldmenu      *  @constructor      *  @param {
object}
 option      *  @param {
string}
 option.id [控件id]      *  @param {
string}
 [option.handle] [点击的区域]      *  @param {
number}
 [option.height] [父层高度,0则自适应]      *  @param {
string}
 [option.target] [要显示隐藏的目标]      *  @param {
number}
 [option.targetHeight] [目标自适应高度还是限制高度]      *  @param {
boolean}
 [option.single] [ false(显示多个) || true(一次只折叠一个) ]      *  @param {
function}
 [option.onInited] [ 1.5.1新增 初始化以后触发 ]      *  @param {
function}
 [option.callback] [ 点击按钮的回调 ]      *  @example      *      */      ui.extend({
          name: "foldmenu",          config: {
              id: ""          }
,          callback: function(opt) {
                  // that 指向插件的抛出的公共方法, option widget 等              let that = this;
                  // this.config 为已经跟初始化参数合并以后的结果;
                  let param = this.config;
                  // 缓存选择器              let $id = null;
              // 要抛给开发者的方法              that.init = function(option) {
                  // 对直接调用init方法的参数进行合并                  param = $.extend(true, {
}
    , param, option);
                      // 单页多页选择器,如果是单页,这个插件只能在模块里面用, 不能在bui.ready                  $id = ui.$(param.id);
                      // 绑定事件,点击的时候增加激活样式                  $id.children("dt").click(function(e) {
                          var hasActive = $(this).hasClass("active");
                      if (hasActive) {
                              $(this).removeClass("active");
                      }
 else {
                              // 加上样式以后会自动对箭头及下一层级展示处理;
                              $(this).addClass("active");
                      }
                  }
    )                  return that;
              }
              // 如果有依赖bui控件,应该在这里写,这样方便外部调用              // that.widgets.loading = ui.loading({
              //     appendTo: opt.id              // }
    );
              // 如果需要销毁的生命周期,则在这里加上.              // that.beforeDestroy = function() {
                  //              //     return that;
              // }
              // 必须传id              if (!param.id) {
                      // 抛出错误                  ui.showLog("必须传id参数.")                  return that;
              }
                  // 默认先初始化一次              return this.init(opt);
          }
      }
    );
}
)(window.bui || {
}
    , window.libs);
    

结语

上面我们示例了一个最简单的插件的开发及使用, 但插件的适应性还不够, 还需要考虑各种扩展性,复杂的场景如何去适应, 比方内容是需要固定高度,选择器换成其它,只展示一个,等各种需求都不能满足, 我们需要考虑更多的场景, 抽取更多的变量作为可配置.

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。

声明:本文内容由网友自发贡献,本站不承担相应法律责任。对本内容有异议或投诉,请联系2913721942#qq.com核实处理,我们将尽快回复您,谢谢合作!

html5

若转载请注明出处: html5写一个BUI折叠菜单插件的实现方法
本文地址: https://pptw.com/jishu/585997.html
html5借用repeating-linear-gradient实现一把刻度尺(ruler) HTML5 3D旋转相册的实现示例

游客 回复需填写必要信息