📜  小猫 ui 输入填充 (1)

📅  最后修改于: 2023-12-03 15:39:21.181000             🧑  作者: Mango

小猫 UI 输入填充

概述

小猫 UI 输入填充是一款优秀的输入框填充插件,支持多种类型的自动填充,包括但不限于自定义下拉列表、日期选择器等。使用方便、效率高、美观大方,适用于各种类型的 Web 项目。

特性
  • 支持多种输入框类型,包括文本框、下拉列表、时间选择器等。
  • 支持多种自动填充方式,包括但不限于从后台获取数据、本地数据缓存等。
  • 可以快速配置自定义的下拉列表,支持模糊搜索、关键字高亮。
  • 支持快捷键输入、点击选择方式,提供更友好的使用体验。
  • 基于 jQuery 和 Bootstrap 等优秀的开源库,稳定可靠。
示例
基本用法

可以通过如下方式使用小猫 UI 输入填充:

<!-- 在 HTML 中引用必要的样式文件 -->
<link rel="stylesheet" href="path/to/cat-ui.css">

<!-- 在 HTML 中引用必要的脚本文件 -->
<script src="path/to/jquery.js"></script>
<script src="path/to/bootstrap.js"></script>
<script src="path/to/cat-ui.js"></script>

<!-- 在输入框上应用输入填充 -->
<input type="text" id="test-input">

<script>
// 使用输入填充
$('#test-input').catUIInputFill({
    data: ['apple', 'orange', 'banana'],  // 可用的数据
    minLength: 2  // 输入框最小字符数
});
</script>
自定义下拉列表

可以通过如下方式自定义下拉列表:

<input type="text" id="test-input2">

<script>
// 使用输入填充
$('#test-input2').catUIInputFill({
    data: [
        {id: 1, name: 'apple'},
        {id: 2, name: 'orange'},
        {id: 3, name: 'banana'}
    ],  // 可用的数据
    minLength: 2,  // 输入框最小字符数
    getValue: function(item) {
        return item.name;
    },  // 获取下拉列表项显示的文本
    getId: function(item) {
        return item.id;
    }  // 获取下拉列表项的值
});
</script>
日期选择器

可以通过如下方式使用日期选择器:

<input type="text" id="test-input3">

<script>
// 使用输入填充
$('#test-input3').catUIInputFill({
    type: 'date'  // 将输入框设置为日期选择器
});
</script>
API 文档
配置项

| 名称 | 类型 | 默认值 | 描述 | | --- | --- | --- | --- | | data | Array 或者 Function | [] | 输入框填充的数据。如果是一个 Array,则为固定值;如果是一个 Function,则为异步获取数据的方法。第一个参数为输入框输入的值,第二个参数为回调函数。 | | minLength | Number | 1 | 输入框输入的最小字符数。 | | type | String | text | 输入框的类型。可以为 textpassword 或者 date。 | | delay | Number | 300 | 输入框输入后,等待多少毫秒后触发自动填充。 | | limit | Number | 10 | 下拉列表显示的最大数量。 | | getValue | Function | null | 自定义下拉列表项的显示文本。参数为下拉列表项,返回值为文本。 | | getId | Function | null | 自定义下拉列表项的值。参数为下拉列表项,返回值为值。 | | onSelect | Function | null | 当用户选择下拉列表中的某一项时触发的回调函数。参数为选择的值。 |

方法

| 名称 | 参数 | 描述 | | --- | --- | --- | | destroy | none | 销毁输入填充功能。 | | disable | none | 禁用输入填充功能。 | | enable | none | 启用输入填充功能。 | | updateData | data: Array 或者 data: Function | 更新输入框填充的数据。如果是一个 Array,则为固定值;如果是一个 Function,则为异步获取数据的方法。第一个参数为输入框输入的值,第二个参数为回调函数。 |

事件

小猫 UI 输入填充提供了以下自定义事件:

| 名称 | 参数 | 描述 | | --- | --- | --- | | show.catui.input-fill | none | 显示下拉列表时触发。 | | hide.catui.input-fill | none | 隐藏下拉列表时触发。 |

结束语

小猫 UI 输入填充是一款非常优秀的输入框填充插件,具有简单易用、小巧高效、灵活可扩展等优秀特性。如果你正在寻找一款输入框填充插件,那么它将是你的绝佳选择。