简单分页插件技术文档

1. 安装指南

1.1 下载插件

首先，您需要从项目的GitHub页面下载插件。下载包含插件和CSS主题的zip文件。

1.2 引入jQuery

确保您的页面已经引入了jQuery库。推荐使用jQuery 1.7.2或更高版本。您可以在HTML文件中通过以下代码引入：

<script type="text/javascript" src="path_to/jquery.js"></script>

1.3 引入分页插件

接下来，引入simplePagination.js文件：

<script type="text/javascript" src="path_to/jquery_simplePagination.js"></script>

1.4 引入CSS样式（可选）

如果您需要使用默认的CSS主题，可以引入以下CSS文件：

<link type="text/css" rel="stylesheet" href="path_to/simplePagination.css"/>

如果跳过此步骤，您需要自定义样式或使用Bootstrap。

2. 项目的使用说明

2.1 初始化分页

在您的HTML中，需要有一个元素用作分页的容器。例如：

<div id="pagination-container"></div>

然后，使用jQuery选择器调用pagination()函数来初始化分页：

$(function() {
    $('#pagination-container').pagination({
        items: 100,
        itemsOnPage: 10,
        cssStyle: 'light-theme'
    });
});

2.2 配置选项

以下是初始化时可以使用的配置选项：

• items: 总项数
• itemsOnPage: 每页显示项数
• pages: 总页数（如果指定，将不使用items和itemsOnPage计算页数）
• displayedPages: 显示的页码数
• edges: 分页开始/结束显示的页码数
• currentPage: 初始化后选中的页码
• hrefTextPrefix: 页码链接前缀
• hrefTextSuffix: 页码链接后缀
• prevText: 上一页按钮文本
• nextText: 下一页按钮文本
• labelMap: 自定义页码显示文本
• ellipsePageSet: 点击省略号后是否显示输入框
• cssStyle: CSS主题样式
• selectOnClick: 点击后是否立即选中页码
• onPageClick: 页码点击事件处理函数
• onInit: 分页初始化事件处理函数

3. 项目API使用文档

以下是项目提供的API方法：

• selectPage(pageNumber): 根据页码选择页面
• prevPage(): 选择上一页
• nextPage(): 选择下一页
• getPagesCount(): 返回总页数
• getCurrentPage(): 返回当前页码
• disable(): 禁用分页
• enable(): 启用分页（之前被禁用）
• destroy(): 销毁分页（视觉上移除，保留设置）
• redraw(): 使用现有设置重新绘制分页
• updateItems(number): 动态更改分页显示的项数
• updateItemsOnPage(number): 动态更改每页显示的项数
• drawPage(pageNumber): 设置当前页码并重新绘制分页

4. 项目安装方式

除了通过GitHub下载zip文件外，您还可以使用npm或yarn进行安装：

npm install simple-pagination

或

yarn add simple-pagination

安装完成后，您可以通过import或require的方式在项目中引入插件。