网页制作

html5写一个BUI折叠菜单插件的实现方法
网页制作 2024/12/23 佚名
3 2

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

html5写一个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);

结语

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

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

标签：
html5,BUI,折叠菜单
免责声明：本站文章均来自网站采集或用户投稿，网站不提供任何软件下载或自行开发的软件！ 如有用户或公司发现本站内容信息存在侵权行为，请邮件告知！ 858582#qq.com
岱庙资源网 Copyright www.zgmyg.com

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

暂无“html5写一个BUI折叠菜单插件的实现方法”评论...
www.zgmyg.com 岱庙资源网
129,905影音资源
244,626技术资源
111,817软件资源
578,645站长资源

更新日志

友情链接

杰晶网络 DDR爱好者之家 桃源资源网 杰网资源 富贵资源网 南强小屋 铁雪资源网 幽灵资源网 万梅资源网 狼山资源网 白云岛资源网 昆仑资源网 相思资源网 明霞山资源网 内蒙古资源网 黑松山资源网 茶园资源网 饿虎岗资源网 大旗谷资源网 常春岛资源网 岱庙资源网 兴国资源网 快活林资源网 蝙蝠岛资源网 帝王谷资源网 白云城资源网 伏龙阁资源网 清风细雨楼 天枫庄资源网 圆月山庄资源网 无争山庄资源网 神水资源网 移花宫资源网 神剑山庄资源网 无为清净楼资源网 金钱帮资源网 丐帮资源网 华山资源网 极乐门资源网 小李飞刀资源网 凤求凰客栈 风云阁资源网 金狮镖局 鸳鸯亭资源网 千金楼资源网 更多链接
岱庙资源网 Copyright www.zgmyg.com