# layui-plugin
**Repository Path**: zhang_qy/layui-plugin
## Basic Information
- **Project Name**: layui-plugin
- **Description**: 最近在写框架，选了layui作为前端，此项目将会记录我在开发过程中，对layui相关的插件扩展。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 43
- **Created**: 2021-09-26
- **Last Updated**: 2021-09-26
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
### Layui-Plugin
---
  
---
#### layui-uploadx
> 该插件是对原有layui-upload功能的扩展，用户可以自定义文件的上传路径、下载路径、删除路径等，原upload参数也可以完全支持，在原本的upload传入参数的时候，增加了ex和page参数用来定义uploadx插件的额外功能。该插件目前**必须**放置在表单中。
##### 使用案例
```html
```
##### 效果预览
##### 参数说明
原layui上传组件，分页组件的参数都可以全部使用，部分参数类似绑定id的html元素请不要随意设置，避免功能错乱。**参数属性加*则意味着此参数必填。**
```javascript
uploadx.render({
ex:{
//...
}
});
```
| 参数选项 | 说明 | 类型 | 默认值 |
| ------------ | ------------------------------------------------------------ | ------------- | -------- |
| elem | 指向容器选择器，如：elem: '#id'。也可以是DOM对象 | string/object | - |
| name | 用于生成表单input元素时候的字段名称 | String | 附件 |
| title | 附件上传弹出框的标题 | String | 文件管理 |
| **form*** | 表单属性设置的layui-filter的值，插件需要借用此属性获得id来请求后台数据 | String | - |
| **url*** | 请求附件数据进行显示的路径，组件将会自动将form属性获得的id填充进请求参数中，方便后台处理 | String | - |
| biz | 用于在区别在同一个表单存在多个附件上传功能的功能，上传和请求都会携带此参数 | String | - |
| loadType | 请求url属性的request method类型 | String | get |
| mainId | 对应的主键名是什么，这参数会影响请求时候，主键的参数名 | String | id |
| downId | 对应的主键名是什么，这参数会影响下载时候，主键的参数名 | String | id |
| **downUrl*** | 下载附件的url | String | - |
| **delUrl*** | 删除附件的url | String | - |
| successCode | 请求成功码，所有不是此码的请求，都被视失败。 | int | 200 |
| successName | 请求成功码属性名称。 | String | code |
| resultName | 请求结果属性名称。 | String | result |
| countName | 请求附件总数的属性名称 | String | count |
| success | 操作成功的回调 会根据返回成功码来执行 200 执行 | function | - |
| error | 操作失败的回调 非200执行 | function | - |
```javascript
uploadx.render({
page:{
//... 原 layui 分页组件的参数都可以使用
}
});
```
| 参数选项 | 说明 | 类型 | 默认值 |
| ----------- | ---------------------- | ------ | ------ |
| limitName | 获取limit的属性名称 | String | limit |
| currentName | 获取当前页数的属性名称 | String | curr |
##### 方法
> addExt(options)
```javascript
layui.config({
base: 'plugin/'
}).use(['jquery', 'layer', 'uploadx','form'], function() {
var $ = layui.jquery,
uploadx = layui.uploadx,
form = layui.form;
// 添加 .txt类型的文件icon
uploadx.addExt({
ext:'txt',
type:'svg',
icon:''
});
uploadx.render({
//...
});
// 添加 .json类型的文件icon
uploadx.addExt({
ext:'json',
type:'img',
icon:'./icon/uploadx/javascript.png'
});
});
```
此方法用于将还没有收录的**其他类型文件**自定义添加到组件中，可在，有更好的展示效果。icon目前支持两种类型，一个`svg`，另一个`img`；
**添加前**
**添加后**
