# 動態分頁
利用[分頁組件](pagination.html),創建基于JavaScript的動態分頁。
分頁組件將根據給定的選項自動計算頁面。這非常有用,例如在Ajax支持的列表視圖中,你必須觸發一個事件來動態地加載新的條目時。
* * *
## 用法
要使用這個組件,只需要添加 `data-uk-pagination` 到一個帶有 `.uk-pagination` 類名的 `<ul>` 元素中。注意 使用此組件需要額外添加 `pagination.js` 文件,在`js/components`文件夾中。
### Example

### 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
- 上傳