Skip to content

Latest commit

 

History

History
96 lines (63 loc) · 3.25 KB

README-CN.md

File metadata and controls

96 lines (63 loc) · 3.25 KB
Raw

SelectPageLogo

SelectPage

支持autocomplete、键盘操作、分页、标签多选等多功能的选择器插件

插件运行效果预览

多选Tags模式

SelectPage1

单选模式

SelectPage

入门指南、DEMO、文档

项目GitHub地址：

https://github.com/TerryZ/SelectPage

插件官方首页（入门指南、DEMO、文档）：

https://terryz.github.io

如果您觉得项目还不错，还请给项目（ Github / 码云 ）加个Star，同时欢迎Follow Github个人主页





什么是SelectPage

SelectPage是一个基于jQuery开发的多功能下拉分页选择器，作为一个功能强大的表单控件，它一定会有很多缺点和不足，欢迎您 提交 对项目的意见和建议，让我们一起让SelectPage变得更好

功能特点

  • 基于jQuery、Bootstrap2、3开发
  • 也可应用于无任何UI框架的原生HTML环境
  • Autocomplete输入自动查找功能
  • 结果列表分页展示
  • 允许使用静态json数据源或ajax动态请求的数据源
  • 使用键盘快速操作基本功能及分页功能
  • 多项选择以标签（Tag）形式展现
  • 结果列表自动判断屏幕边缘，避免内容超出可视范围
  • 丰富的参数设置及功能API调用

浏览器兼容：IE8+、Chrome、Firefox等

插件基于jQuery开发，可在Bootstrap2、3环境下使用，亦可在原生无UI框架的环境下直接使用

为什么要有SelectPage

有时候我们需要有一个插件，它可以输入关键字进行快速查找，可以下拉进行选择，可以在展示大量数据时进行分页显示，可以使用键盘进行快速操作，可以适应各种UI环境，可以被灵活定制，而上述的情况就真的出现在现实项目的需求里了

怎么使用SelectPage

在 Github 或 码云 上下载最新版本，解压后并放入需要使用的项目中

引用文件

<!-- jQuery的基础脚本引用 -->
<script type="text/javascript" src="jquery.min.js" >< /script>

<!-- 核心样式文件 -->
<link rel="stylesheet" href="selectpage.css" type="text/css">

<!-- 插件核心脚本 -->
<script type="text/javascript" src="selectpage.min.js" >< /script>

HTML页面元素设置

<!-- 设置文本框为插件基本元素 -->
<input type="text" id="selectPage" >

脚本初始化插件

//定义数组，在服务端返回的数据也以该格式返回：Array[{Object},{...}]
var tag_data = [
    {id:1 ,name:'Chicago Bulls',desc:'芝加哥公牛'},
    {id:2 ,name:'Cleveland Cavaliers',desc:'克里夫兰骑士'},
    {id:3 ,name:'Detroit Pistons',desc:'底特律活塞'},
    {id:4 ,name:'Indiana Pacers',desc:'印第安纳步行者'}
];
//初始化插件
$('#selectPage').selectPage({
    showField : 'desc',
    keyField : 'id',
    data : tag_data
});