glhcp/server/public/static/plug/iconpicker/README.md

75 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# LayUI拓展组件IconPicker图标选择器
#### 项目介绍
基于Layui的图标选择器支持查询、分页、点击回调、渲染成功后回调等功能提供手动选择图标事件。注图标来自于Layui2.4.1
#### 效果图
![输入图片说明](https://images.gitee.com/uploads/images/2018/0904/182114_7fbd07ab_1157021.gif "icon-a.gif")
![输入图片说明](https://images.gitee.com/uploads/images/2018/0830/235644_7c9ab176_1157021.gif "b.gif")
![输入图片说明](https://images.gitee.com/uploads/images/2018/0830/235651_a9f30be3_1157021.gif "c.gif")
#### 使用示例
```
默认图标:
<input type="text" id="iconPicker" lay-filter="iconPicker" style="display:none;">
自定义图标:
<input type="text" id="iconPicker2" lay-filter="iconPicker2" value="layui-icon-face-smile-fine" style="display:none;">
```
```
layui.use(['iconPicker'], function () {
var iconPicker = layui.iconPicker;
iconPicker.render({
// 选择器推荐使用input
elem: '#iconPicker',
// 数据类型fontClass/unicode推荐使用fontClass
type: 'fontClass',
// 是否开启搜索true/false默认true
search: true,
// 是否开启分页true/false默认true
page: true,
// 每页显示数量默认12
limit: 12,
// 每个图标格子的宽度:'43px'或'20%'
cellWidth: '43px',
// 点击回调
click: function (data) {
console.log(data);
}
// 渲染成功后的回调
success: function(d) {
console.log(d);
}
});
/**
* 选中图标 (常用于更新时默认选中图标)
* @param filter lay-filter
* @param iconName 图标名称自动识别fontClass/unicode
*/
iconPicker.checkIcon('iconPicker', 'layui-icon-star-fill');
});
```
ps. iconPicker.js文件在module/iconPicker目录中
#### 更新日志
- 2019.04.17
- 添加更多演示到demo.html
- 修复checkIcon后input值不改变的bug
- 2018.09.25
- 添加演示页面demo.html
- 添加无数据提示
- 修复下拉三角无法点击的bug
- 修复点击搜索输入框后选择器关闭的bug
- 添加渲染成功后的回调
- 其他的优化
- 支持修改默认图标修改方式给原始input添加value属性需要与type保持统一
#### 注意事项
1. 推荐使用fontClass
2. 可以再需要渲染的元素上添加 `style="display:none;"` ,保证原始元素不被显示