您的位置:

Layui二级联动-详解

一、概述

Layui是一款基于jQuery开发的UI框架,它提供了便捷的接口、丰富的组件和模板,开发者可以轻松地构建出美观、易用的Web界面。Layui提供了许多组件,其中之一就是二级联动。

二级联动是指一个下拉框的值的选取需要依赖于另外一个下拉框的值。比如一个省份下拉框和一个城市下拉框,当选择一个省份时,城市下拉框会根据选择的省份动态更新可选的城市列表。Layui提供了非常方便的二级联动组件,我们只需要提供数据源和一些配置参数,就可以轻松实现二级联动功能。

二、数据源格式

Layui二级联动组件的数据源是一个Javascript对象(JSON)数组。每个元素表示一个选项,它至少包含两个属性:value和name。value是选项的值,name是选项的名称。在二级联动中,每个选项还可以包含一个children属性,它是一个数组,表示该选项的子选项。children数组的每一个元素也必须包含value和name属性,但是不需要children属性,因为子选项的子选项可以通过遍历数据源来获取。

三、配置参数

Layui二级联动组件提供了一些配置参数,可以影响联动的行为。以下是一些比较常用的参数:

1、elem:指定联动的父元素的id。父元素通常是一个div或者fieldset元素,包含了两个下拉框。

2、url:指定数据源的url。如果不指定url,则需要在js中定义一个data数组作为数据源。

3、value:指定下拉框默认选中的值。如果不指定value,则选中第一个选项。

4、disabled:指定下拉框是否禁用。如果设置为true,则下拉框不可用。

5、change:指定下拉框的选中项发生变化时的回调函数。回调函数的第一个参数是被选中的选项的value值。

四、示例代码

以下是一个简单的示例,展示了如何使用Layui二级联动组件:

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>Layui二级联动示例</title>
    <link rel="stylesheet" href="layui/css/layui.css">
</head>
<body>
    <div class="layui-form">
        <div class="layui-form-item">
            <div class="layui-input-inline">
                <select id="province"></select>
            </div>
            <div class="layui-input-inline">
                <select id="city"></select>
            </div>
        </div>
    </div>
    <script src="layui/layui.js"></script>
    <script>
        //定义数据源
        var data = [
            {
                "value": "110000",
                "name": "北京市",
                "children": [
                    {
                        "value": "110100",
                        "name": "市辖区"
                    },
                    {
                        "value": "110200",
                        "name": "县"
                    }
                ]
            },
            {
                "value": "120000",
                "name": "天津市",
                "children": [
                    {
                        "value": "120100",
                        "name": "市辖区"
                    },
                    {
                        "value": "120200",
                        "name": "县"
                    }
                ]
            }
        ];

        //示例代码
        layui.use('form', function(){
            var form = layui.form;
            var province = $('#province');
            var city = $('#city');

            //填充省份下拉框
            $.each(data, function(){
                province.append('<option value="' + this.value + '">' + this.name + '</option>');
            });

            //绑定省份下拉框的change事件
            province.on('change', function(){
                var value = $(this).val();

                //根据选中的省份来填充城市下拉框,同时清空旧选项
                city.empty();
                $.each(data, function(){
                    if(this.value === value && this.children){
                        $.each(this.children, function(){
                            city.append('<option value="' + this.value + '">' + this.name + '</option>');
                        });
                        form.render('select');
                    }
                });
            });

            //trigger省份下拉框的change事件,触发初始化
            province.trigger('change');
        });
    </script>
</body>
</html>

以上代码演示了如何创建两个下拉框,并且实现二级联动。该例子中省份和城市的数据都是在js中定义的,二级联动的实现方法是在province的change事件中遍历数据源,并判断当前选中的省份是否有子选项,如果有,则将子选项填充到城市下拉框中。

五、总结

Layui提供了非常方便的二级联动组件,可以帮助开发者轻松实现省市联动等需求。在使用Layui二级联动组件时,我们需要提供一个符合规范的数据源,并且设置一些必要的配置参数,就可以轻松实现二级联动功能。