完善文档

This commit is contained in:
wanggeng 2022-08-29 22:22:41 +08:00
parent a7042d9650
commit e252ee3abb
2 changed files with 67 additions and 67 deletions

View File

@ -5,7 +5,7 @@ layui需要引入 **ztree** 模块
js js
```html ```html
<script src="assets/js/common/layui-input-tree.js"></script> <script src="assets/js/layui/util/layui-input-tree.js"></script>
``` ```
初始化 初始化
@ -59,15 +59,15 @@ layuiInputTree.initSelect({
参数 参数
|名称|类型|描述|是否必填| | 名称 | 类型 | 描述 | 是否必填 |
|---|---|---|---| |-----------------|----------|--------------------------------------------------------------------------------------------------------------------|------|
|url|string|请求地址|是| | url | string | 请求地址 | |
|id|string|触发选择的input输入框ID|是| | id | string | 触发选择的input输入框ID | |
|key|obj|返回列表对象与ztree节点匹配的字段。id:节点idname:名称title:标题pId:上级IDchecked:是否选中isParent:是否父节点isHidden是否隐藏url:节点链接。以上属性均为非必填|否| | key | obj | 返回列表对象与ztree节点匹配的字段。id:节点idname:名称title:标题pId:上级IDchecked:是否选中isParent:是否父节点isHidden是否隐藏url:节点链接。以上属性均为非必填 | |
|defaultParams|obj|请求默认携带的参数|否| | defaultParams | obj | 请求默认携带的参数 | |
|getSelectedData|function|返回已经选择的数据|否| | getSelectedData | function | 返回已经选择的数据 | |
|onConfirm|function|点击确定按钮后触发|否| | onConfirm | function | 点击确定按钮后触发 | |
|onClear|function|点击清除按钮后触发|否| | onClear | function | 点击清除按钮后触发 | |
方法 方法
@ -77,16 +77,16 @@ getSelectedData返回ztree回显时的数据
onConfirm树形列表点击确定按钮后触发 onConfirm树形列表点击确定按钮后触发
|名称|类型| 描述 | | 名称 | 类型 | 描述 |
|---|---|---------| |--------------|-----|---------|
|zTree|obj| ztree对象 | | zTree | obj | ztree对象 |
|selectedNode|obj| 选择的节点 | | selectedNode | obj | 选择的节点 |
onClear树形列表点击清空按钮后触发 onClear树形列表点击清空按钮后触发
|名称|类型| 描述 | | 名称 | 类型 | 描述 |
|---|---|---------| |-------|-----|---------|
|zTree|obj| ztree对象 | | zTree | obj | ztree对象 |
### 多选 ### 多选
@ -142,16 +142,16 @@ layuiInputTree.initMultiSelect({
参数 参数
|名称|类型|描述| 是否必填 | | 名称 | 类型 | 描述 | 是否必填 |
|---|---|---|------| |------------------|----------|--------------------------------------------------------------------------------------------------------------------|------|
|url|string|请求地址| 是 | | url | string | 请求地址 | 是 |
|id|string|触发选择的input输入框ID| 是 | | id | string | 触发选择的input输入框ID | 是 |
|key|obj|返回列表对象与ztree节点匹配的字段。id:节点idname:名称title:标题pId:上级IDchecked:是否选中isParent:是否父节点isHidden是否隐藏url:节点链接。以上属性均为非必填| 否 | | key | obj | 返回列表对象与ztree节点匹配的字段。id:节点idname:名称title:标题pId:上级IDchecked:是否选中isParent:是否父节点isHidden是否隐藏url:节点链接。以上属性均为非必填 | 否 |
|checkboxType|obj|复选框类型Y 属性定义 checkbox 被勾选后的情况N 属性定义 checkbox 取消勾选后的情况;"p" 表示作会影响父级节点;"s" 表示操作会影响子级节点。默认均为"ps"| 否 | | checkboxType | obj | 复选框类型Y 属性定义 checkbox 被勾选后的情况N 属性定义 checkbox 取消勾选后的情况;"p" 表示作会影响父级节点;"s" 表示操作会影响子级节点。默认均为"ps" | 否 |
|defaultParams|obj|请求默认携带的参数| 否 | | defaultParams | obj | 请求默认携带的参数 | 否 |
|getSelectedDatas|function|返回已经选择的数据列表| 否 | | getSelectedDatas | function | 返回已经选择的数据列表 | 否 |
|onConfirm|function|点击确定按钮后触发| 否 | | onConfirm | function | 点击确定按钮后触发 | 否 |
|onClear|function|点击清除按钮后触发| 否 | | onClear | function | 点击清除按钮后触发 | 否 |
方法 方法
@ -161,13 +161,13 @@ getSelectedDatas返回ztree回显时的数据列表
onConfirm树形列表点击确定按钮后触发 onConfirm树形列表点击确定按钮后触发
|名称|类型| 描述 | | 名称 | 类型 | 描述 |
|---|---|-----------| |---------------|-------|-----------|
|zTree|obj| ztree对象 | | zTree | obj | ztree对象 |
|selectedNodes|array| 触发选择的节点列表 | | selectedNodes | array | 触发选择的节点列表 |
onClear树形列表点击清空按钮后触发 onClear树形列表点击清空按钮后触发
|名称|类型| 描述 | | 名称 | 类型 | 描述 |
|---|---|---------| |-------|-----|---------|
|zTree|obj| ztree对象 | | zTree | obj | ztree对象 |

View File

@ -36,7 +36,7 @@
js js
```js ```js
<script src="assets/js/common/layui-select.js"></script> <script src="assets/js/layui/util/layui-select.js"></script>
``` ```
初始化 初始化
@ -99,35 +99,35 @@ layuiSelect.selectData({
参数 参数
|名称| 类型 | 描述 | 是否必填 | | 名称 | 类型 | 描述 | 是否必填 |
|---|----------|----------------------------------------------------------|------| |--------------------|----------|----------------------------------------------------------|------|
|url| string | 请求地址 | 是 | | url | string | 请求地址 | 是 |
|domId| string | 加载下拉的div | 是 | | domId | string | 加载下拉的div | 是 |
|name| string | select的ID与NAME属性值 | 是 | | name | string | select的ID与NAME属性值 | 是 |
|required| boolean | 是否校验 | 否 | | required | boolean | 是否校验 | 否 |
|dataForm| string | 表单的lay-filter值 | 是 | | dataForm | string | 表单的lay-filter值不存在渲染全部的select | 否 |
|valueKey| string | 接口返回的数据渲染到option的value属性的值 | 是 | | valueKey | string | 接口返回的数据渲染到option的value属性的值 | 是 |
|nameKey| string | 接口返回的数据渲染到option的innerText的值 | 是 | | nameKey | string | 接口返回的数据渲染到option的innerText的值 | 是 |
|selectedValue| string | 选中的默认值 | 否 | | selectedValue | string | 选中的默认值 | 否 |
|optionDataKeyArray| array | 需要附带在option上的属性值取值的时候通过option.dataset.dataX 获取其中X为数组下标 | 否 | | optionDataKeyArray | array | 需要附带在option上的属性值取值的时候通过option.dataset.dataX 获取其中X为数组下标 | 否 |
|onInit| function | 渲染时触发回调 | 否 | | onInit | function | 渲染时触发回调 | 否 |
|onSelect| function | 选择时触发回调 | 否 | | onSelect | function | 选择时触发回调 | 否 |
事件 事件
onInit渲染或更新时触发事件 onInit渲染或更新时触发事件
|名称| 类型 | 描述 | | 名称 | 类型 | 描述 |
|---|--------|----------------------| |---------------|--------|----------------------|
|selectedValue| string | 选中的默认值,空字符串时,不触发数据加载 | | selectedValue | string | 选中的默认值,空字符串时,不触发数据加载 |
|option| dom | 默认选中的option | | option | dom | 默认选中的option |
onSelect选择时触发事件 onSelect选择时触发事件
|名称|类型| 描述 | | 名称 | 类型 | 描述 |
|---|---|----------------------------------| |--------|-----|----------------------------------|
|data|obj| 选择的option数据包含原始DOM美化后的DOM选中的值 | | data | obj | 选择的option数据包含原始DOM美化后的DOM选中的值 |
|option|dom| 选中的option | | option | dom | 选中的option |
### 下拉联动 ### 下拉联动
@ -180,19 +180,19 @@ layuiSelect.selectLinkageArea({
参数 参数
|名称|类型|描述| 是否必填 | | 名称 | 类型 | 描述 | 是否必填 |
|---|---|---|------| |--------------------|----------|----------------------------------------------------------|------|
|baseRootId|string|第一个下拉框的根节点ID| 是 | | baseRootId | string | 第一个下拉框的根节点ID | 是 |
|selectId|string|select的ID不包含下标| 是 | | selectId | string | select的ID不包含下标 | 是 |
|optionDataKeyArray|array|需要附带在option上的属性值取值的时候通过option.dataset.dataX 获取其中X为数组下标| 否 | | optionDataKeyArray | array | 需要附带在option上的属性值取值的时候通过option.dataset.dataX 获取其中X为数组下标 | 否 |
|onSelect|function|选择事件| 是 | | onSelect | function | 选择事件 | 是 |
事件 事件
onSelect选择时触发事件 onSelect选择时触发事件
|名称|类型| 描述 | | 名称 | 类型 | 描述 |
|---|---|----------------------------------| |--------|--------|----------------------------------|
|data|obj| 选择的option数据包含原始DOM美化后的DOM选中的值 | | data | obj | 选择的option数据包含原始DOM美化后的DOM选中的值 |
|option|dom| 选中的option | | option | dom | 选中的option |
|index|number| select下标 | | index | number | select下标 |