安装与调用
引用下面CSS:
<link rel="stylesheet" href="https://qidian.gtimg.com/lulu/hope/ui/ErrorTip/index.css">
JS为:
<script type="module" src="https://qidian.gtimg.com/lulu/hope/ui/ErrorTip/index.js"></script>
单个出错提示演示与代码
button.addEventListener('click', function () {
if (input.value == '') {
new ErrorTip(input, '尚未输入搜索内容' + (index + 1));
}
});
同时出错提示演示与代码
button.addEventListener('click', function () {
if (input.value == '') {
new ErrorTip(input, '尚未输入搜索内容' + (index + 1), {
unique: false
});
}
});
任意元素出现错误提示
这里是一段文字
button.addEventListener('click', function () {
errorSpan.errorTip('这里出现了错误');
});
红色提示语法和参数
语法如下:
var myErrorTip = new ErrorTip(element, content, options);
或者
element.errorTip(content, options);
其中:
- element
- 必须。Object DOM 元素。用来帮助提示定位的元素。
- content
- 必须。String 字符串 | Function 函数。提示的文案信息,支持 HTML 字符串。
- options
- 可选。Object 纯对象。表示可选参数,具体见下表:
| 参数名称 | 支持类型 | 默认值 | 释义 |
|---|---|---|---|
| unique | Boolean | true | 是否页面是只会出现一个错误提示,默认是 true, 永远只会有一个。此参数实际开发很少用到。
|
| onShow | Function | function () {} | 红色出错提示显示时候的回调方法。函数的上下文 this 是当前实例,支持两个参数,分别表示当前提示元素的定位元素和浮层提示元素。 |
| onHide | Function | function () {} | 红色出错提示隐藏时候的回调方法。函数的上下文 this 是当前实例,支持两个参数,分别表示当前提示元素的定位元素和浮层提示元素。 |
其他说明
在实际开发中,ErrorTip 出错提示组件和表单验证强关联,可以试试使用 Validate 验证组件。
另外,红色出错提示出现的时候,会自动给该定位元素添加类名 .valided 和属性 is-error,红色出错提示隐藏的时候会移除属性 is-error,.valided 类名会保留,方便识别是否已经验证提示过。
实例对象
myErrorTip 就是返回的实例对象,暴露了以下属性和方法:
{
// 提示内容显示与否,布尔值
display: false,
element: {
// 触发提示显示的元素
trigger: null,
// 提示元素
tips: null,
// 提示内容元素
content: null,
// 提示三角元素
arrow: null
},
callback: {
// 显示的回调方法
show: function () {},
// 隐藏的回调方法
hide: function () {}
},
params: {
// 布尔值,是否唯一提示显示
unique: true
},
// 提示显示
show: function () {},
// 提示隐藏
hide: function () {}
}
本页贡献者:
zhangxinxu