# 动态分页
利用[分页组件](pagination.html),创建基于JavaScript的动态分页。
分页组件将根据给定的选项自动计算页面。这非常有用,例如在Ajax支持的列表视图中,你必须触发一个事件来动态地加载新的条目时。
* * *
## 用法
要使用这个组件,只需要添加 `data-uk-pagination` 到一个带有 `.uk-pagination` 类名的 `<ul>` 元素中。注意 使用此组件需要额外添加 `pagination.js` 文件,在`js/components`文件夹中。
### Example
![](https://box.kancloud.cn/2016-05-12_57346f3ba4279.jpg)
### Markup
```
<ul class="uk-pagination" data-uk-pagination="{items:100, itemsOnPage:10}"></ul>
```
* * *
## JavaScript 选项
| 选项 | 可用值 | 默认值 | 描述 |
| --- | --- | --- | --- |
| `items` | integer | 1 | 条目的总数,用于计算页面。 |
| `itemsOnPage` | integer | 1 | 每个页面上显示的条目数。 |
| `pages` | integer | 0 | 如果被指定了值, **items** and **itemsOnPage** 将不会用于计算页面数目。 |
| `displayedPages` | integer | 3 | 导航时有多少页码是可见的。 |
| `edges` | integer | 3 | 在分页的首页或末页有多少页面是可见的。 |
| `currentPage` | integer | 1 | 初始化后,哪一页应该被立即选中。 |
### 事件
| 名称 | 参数 | 描述 |
| --- | --- | --- |
| `select.uk.pagination` | event, pageIndex, pagination object | 页面点击时 |
每当你点击某个页面时,分页组件便会触发 `uk-select-page`事件。
```
$('[data-uk-pagination]').on('select.uk.pagination', function(e, pageIndex){
alert('You have selected page: ' + (pageIndex+1));
});
```
### 手动初始化
```
var pagination = UIkit.pagination(element, { /* options */ });
```
- UIkit 中文文档
- 开始使用
- 初学者
- 开始使用
- 如何自定义
- 布局示例
- 开发者
- 项目结构
- Less & Sass 文件
- 创建主题
- 创建样式
- Customizer.json
- JavaScript
- 自定义前缀
- 核心组件
- 默认
- 基础
- 打印
- 布局类组件
- 网格
- 面板/Panel
- 块/Block
- 文章
- 评论/Comment
- 效果/Utility
- Flex 布局
- 覆盖/Cover
- 导航类组件
- 导航菜单
- 导航栏
- 二级导航
- 面包屑/Breadcrumb
- 分页
- 选项卡
- 缩略图导航/Thumbnav
- 页面元素
- 列表
- 描述列表
- 表格
- 表单
- 常用组件
- 按钮
- 图标
- 关闭/Close
- 徽章/Badge
- 提示框
- 缩略图/Thumbnail
- 遮罩/Overlay
- 文本
- 列
- 动画
- 对比度/Contrast
- JAVASCRIPT组件
- 下拉菜单
- 模态对话框
- 抽屉/Off-canvas
- 切换器/Switcher
- 拨动/toggle
- 滚动监听/Scrollspy
- 平滑滚动
- 附加组件
- 布局类组件
- 动态网格
- 视差网格
- 导航类组件
- 圆点导航
- 滑动导航/Slidenav
- 动态分页
- 常用组件
- 高级表单
- 文件表单/Form file
- 密码表单
- 选择表单
- 占位符
- 进度条/Progress
- JAVASCRIPT组件
- 灯箱/Lightbox
- 自动完成/Autocomplete
- 日期选择器/Datepicker
- HTML 编辑器
- 滚动条/Slider
- 滑块集/Slideset
- 幻灯片/Slideshow
- 视差/Parallax
- 手风琴/Accordion
- 通知/Notify
- 搜索/Search
- 可嵌套/Nestable
- 可排序/Sortable
- 附着/Sticky
- 时间选择器
- 工具提示/Tooltip
- 上传