Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/TerryZ/SelectPage

A simple style and powerful selector, including ajax remote data, autocomplete, pagination, tags, i18n and keyboard navigation features
https://github.com/TerryZ/SelectPage

ajax-search autocomplete javascript jquery jquery-plugin keyboard pagination select-multiple selection selectpage tagsinput

Last synced: 3 months ago
JSON representation

A simple style and powerful selector, including ajax remote data, autocomplete, pagination, tags, i18n and keyboard navigation features

Awesome Lists containing this project

README

        

![SelectPageLogo](https://terryz.github.io/image/logo/SelectPage.png)

# SelectPage

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

## 插件运行效果预览

*多选Tags模式*

![SelectPage1](https://terryz.github.io/image/SelectPage1.png "SelectPage")

*单选模式*

![SelectPage](https://terryz.github.io/image/SelectPage.png "SelectPage")

## 入门指南、DEMO、文档

*项目GitHub地址:*

[https://github.com/TerryZ/SelectPage](https://github.com/TerryZ/SelectPage)

*插件官方首页(入门指南、DEMO、文档):*

[https://terryz.github.io](https://terryz.github.io)

### 如果您觉得项目还不错,还请给项目( [Github](https://github.com/TerryZ/SelectPage) / [码云](https://gitee.com/TerryZ/selectpage) )加个Star,同时欢迎Follow [Github个人主页](https://github.com/TerryZ)





## 什么是SelectPage

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

### 功能特点

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

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

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

## 为什么要有SelectPage

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

## 怎么使用SelectPage

在 [Github](https://github.com/TerryZ/SelectPage) 或 [码云](https://gitee.com/TerryZ/selectpage) 上下载最新版本,解压后并放入需要使用的项目中

### 引用文件

```html

< /script>

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

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

### HTML页面元素设置

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

### 脚本初始化插件

```js
//定义数组,在服务端返回的数据也以该格式返回: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
});
```