第一百八十九节，jQueryUI，折叠菜单 UI

Posted 2020-09-06 林贵秀

jQueryUI，折叠菜单 UI

 

学习要点：

　　1.使用 accordion

　　2.修改 accordion 样式

　　3.accordion()方法的属性

　　4.accordion()方法的事件

　　5.accordion 中使用 on

 

折叠菜单（accordion），和选项卡一样也是一种在同一个页面上切换不同内容的功能 UI。它和选项卡的使用几乎没有什么太大区别，只是显示的效果有所差异罢了。

 

一．使用 accordion

使用 accordion 比较简单，但需要按照指定的规范即可。

HTML 部分

<div id="accordion">
    <h1>菜单 1</h1>
    <div>内容 1</div>
    <h1>菜单 2</h1>
    <div>内容 2</div>
    <h1>菜单 3</h1>
    <div>内容 3</div>
</div>

jQuery 部分

accordion()方法，让符合要求的区块执行折叠菜单方法

$(\'#accordion\').accordion();

 

二．修改 accordion 样式

在显示的 accordion 折叠菜单中，在火狐浏览器中打开 Firebug 或者右击->查看元素。这 样，我们可以看看 accordion 的样式，根据样式进行修改。我们为了和网站主题符合，对 accordion 的标题背景进行修改。

//无须修改 ui 里的 CSS，直接用 style.css 替代掉
.ui-widget-header {
    background:url(../img/ui_header_bg.png);
}

 

三．accordion()方法的属性

选项卡方法有两种形式：1.accordion(options)，options 是以对象键值对的形式传参，每 个键值对表示一个选项；2.accordion(\'action\', param)，action 是操作选项卡方法的字符串， param 则是 options 的某个选项。

accordion 外观选项

collapsible false/布尔值 当设置为 true 是，允许菜单折叠对应的内容。默认值为 false，不会关闭对应内容。

    $(\'#accordion\').accordion({
        collapsible:true        //允许菜单折叠对应的内容。默认值为 false，不会关闭对应内容
    });

 

disabled 无/布尔值 默认为 false，设置为 true 则禁用折叠菜单。禁止后菜单无法折叠

    $(\'#accordion\').accordion({
        collapsible:true,        //允许菜单折叠对应的内容。默认值为 false，不会关闭对应内容
        disabled:true            //禁止后菜单无法折叠
    });

 

event click/字符串 触发 accordion 的事件类型，默认为 click。可以设置 mouseover 等其他鼠标事件。设置什么事件触发折叠

    $(\'#accordion\').accordion({
        collapsible:true,        //允许菜单折叠对应的内容。默认值为 false，不会关闭对应内容
        // disabled:true,            //禁止后菜单无法折叠
        event:\'mouseover\'       //设置什么事件触发折叠
    });

 

active 数组和布尔值如果是数组，初始化时默认显示哪个 tab，默认值为 0。如果是布尔值，那么默认是否折叠。条件必须是 collapsible 值为 true。

    $(\'#accordion\').accordion({
        collapsible:true,        //允许菜单折叠对应的内容。默认值为 false，不会关闭对应内容
        // disabled:true,            //禁止后菜单无法折叠
        event:\'mouseover\',       //设置什么事件触发折叠
        active:true
    });

 

 

heightStyle content/字符串默认为 auto，即自动根据最高的那个为基准，fill 则是填充一定的可用高度，content 则是根据内容伸展高度。

    $(\'#accordion\').accordion({
        // collapsible:true,        //允许菜单折叠对应的内容。默认值为 false，不会关闭对应内容
        // disabled:true,            //禁止后菜单无法折叠
        // event:\'mouseover\',       //设置什么事件触发折叠
        // active:true,
        heightStyle:\'content\'       //折叠高度设置
    });

 

header h1/字符串 设置折叠菜单的标题标签。

    $(\'#accordion\').accordion({
        // collapsible:true,        //允许菜单折叠对应的内容。默认值为 false，不会关闭对应内容
        // disabled:true,            //禁止后菜单无法折叠
        // event:\'mouseover\',       //设置什么事件触发折叠
        // active:true,
        // heightStyle:\'content\'       //折叠高度设置
        header:\'h3\'                 //设置折叠菜单的标题标签,如设置成h3,在html里也要对应
    });

 

 

icons 默认图标 设置想要的图标。

    $(\'#accordion\').accordion({
        // collapsible:true,        //允许菜单折叠对应的内容。默认值为 false，不会关闭对应内容
        // disabled:true,            //禁止后菜单无法折叠
        // event:\'mouseover\',       //设置什么事件触发折叠
        // active:true,
        // heightStyle:\'content\'       //折叠高度设置
        // header:\'h3\'                 //设置折叠菜单的标题标签,如设置成h3,在html里也要对应
        icons: {
            "header": "ui-icon-plus",           //折叠时图标
            "activeHeader": "ui-icon-minus"     //设置展开时图标
        }
    });

 

 

三．accordion()方法的事件

除了属性设置外，accordion()方法也提供了大量的事件。这些事件可以给各种不同状态 时提供回调函数。

 

accordion 事件选项

create 当创建一个折叠菜单时激活此事件。
该方法有两个参数(event, ui)，ui 参数有两个子属性 header 和 panel，得到当前标题和内容选项的对象。

    $(\'#accordion\').accordion({
        create: function (event, ui) {    //当创建一个折叠菜单时激活此事件。
            alert($(ui.header.get()).html()); //的到当前展开的菜单标题对象
            alert($(ui.panel.get()).html());  //的到当前展开的菜单内容对象
        }
    });

 

activate 当切换一个折叠菜单时，启动此事件。
该方法有两个参数(event, ui)，ui 参数有四个子属性 newHeader、newPanel、oldHeader，oldPanel。分别得到的时候新 header 对象、
新内容对象、旧 header 对象和旧内容对象。

    $(\'#accordion\').accordion({
        activate: function (event, ui) {    //当切换一个折叠菜单时，启动此事件
            alert($(ui.oldHeader.get()).html()); //获取上一个展开菜单的标题对象
            alert($(ui.oldPanel.get()).html());  //获取上一个展开菜单的内容对象
            alert($(ui.newHeader.get()).html()); //获取当前要展开的标题对象
            alert($(ui.newPanel.get()).html());  //获取当前要展开的内容对象
        }
    });

 

beforeActivate 当切换一个折叠菜单之前，启动此事件。
该方法有两个参数 (event, ui)，ui 参数 有四 个子属 性 newHeader、newPanel、oldHeader，oldPanel。分别得到的时候新 header对象、新内容对象、旧 header 对象和旧内容对象。

    $(\'#accordion\').accordion({
        beforeActivate: function (event, ui) {    //当切换一个折叠菜单之前，启动此事件
            alert($(ui.oldHeader.get()).html()); //获取上一个展开菜单的标题对象
            alert($(ui.oldPanel.get()).html());  //获取上一个展开菜单的内容对象
            alert($(ui.newHeader.get()).html()); //获取当前要展开的标题对象
            alert($(ui.newPanel.get()).html());  //获取当前要展开的内容对象
        }
    });

 

 

accordion(\'action\', param)方法

accordion(\'disable\') jQuery 对象 禁用折叠菜单

    $(\'#accordion\').accordion({

    });
    $(\'#accordion\').accordion(\'disable\');       //禁用折叠菜单

 

accordion(\'enable\') jQuery 对象 启用折叠菜单

    $(\'#accordion\').accordion({

    });
    $(\'#accordion\').accordion(\'enable\');       //启用折叠菜单

 

accordion(\'widget\') jQuery 对象 获取折叠菜单的 jQuery 对象

    $(\'#accordion\').accordion({

    });
    alert($(\'#accordion\').accordion(\'widget\'));       //获取折叠菜单的 jQuery 对象

 

accordion(\'destroy\') jQuery 对象 删 除 折 叠 菜 单 ， 直 接 阻 断 了accordion。

    $(\'#accordion\').accordion({

    });
    $(\'#accordion\').accordion(\'destroy\');       //直 接 阻 断 了accordion。

 

accordion(\'refresh\') jQuery 对象 更新折叠菜单，比如高度。

    $(\'#accordion\').accordion({

    });
    $(\'#accordion\').accordion(\'refresh\');       //更新折叠菜单，比如高度

 

accordion(\'option\', param) 一般值 获取 options 属性的值

    $(\'#accordion\').accordion({
        event:\'mouseover\'       //设置什么事件触发折叠
    });
    alert($(\'#accordion\').accordion(\'option\', \'event\'));       //获取accordion属性的值

 

accordion(\'option\', param,value)jQuery 对象 设置 options 属性的值

    $(\'#accordion\').accordion({
        event:\'mouseover\'       //设置什么事件触发折叠
    });
    $(\'#accordion\').accordion(\'option\', \'event\',\'mouseover\');       //设置accordion属性的值

 

 

五．accordion 中使用 on()

在 accordion 的事件中，提供了使用 on()方法处理的事件方法。

accordionactivate 折叠菜单切换时触发

    $(\'#accordion\').accordion({
        event: \'mouseover\'       //设置什么事件触发折叠
    });
    //菜单切换时触发
    $(\'#accordion\').on(\'accordionactivate\', function () {
        alert(\'菜单切换时触发！\');
    });

 

accordionbeforeactivate折叠菜单切换前触发

    $(\'#accordion\').accordion({
        event: \'mouseover\'       //设置什么事件触发折叠
    });
    //菜单切换前触发
    $(\'#accordion\').on(\'accordionbeforeactivate \', function () {
        alert(\'菜单切换前触发！\');
    });