Pajinate - jQuery 分页插件技术文档

1. 安装指南

首先，您需要将 pajinate-x.x 文件夹放置在您的网站目录结构中的某个位置。

然后，在您的 HTML 文件中包含所需的脚本标签。

<script src="path_to_pajinate/pajinate.min.js"></script>

确保所有您想要分页的项目都是具有 CSS 类值 content 的 HTML 元素的第一子元素。子元素可以是任何标签类型。

2. 项目使用说明

在您的 HTML 中创建至少一个 <div>，并为其分配一个 CSS 类 page_navigation。分页链接将被附加到这些 <div> 中。

<div class="page_navigation"></div>

接下来，创建一个包含您想要分页的项目的 <div>，并为其分配一个 CSS 类 content。

<div id="page_container">
    <div class="page_navigation"></div>
    <div class="content">
        <!-- 您的内容项 -->
    </div>
</div>

最后，调用 Pajinate 插件：

$('#id_of_page_container').pajinate();

其中 #id_of_page_container 应包含 page_navigation 和 content 元素。

3. 项目 API 使用文档

Pajinate 插件提供了多个初始化选项：

• items_per_page：一个数字，确定在任何 '页' 上显示的最大项目数。[默认 = 10]
• item_container_id：包含所有列表项的元素 ID 或类名。[默认 = .content]
• nav_panel_id：承载导航链接的元素 ID 或类名。[默认 = .page_navigation]
• num_page_links_to_display：一次显示的页链接数，例如，如果您总共有 20 个页链接但只想一次显示 3 个，请将此值设置为 3。[默认 = 20]
• start_page：您想要首先显示的页面编号。[默认 = 0]
• nav_label_first：导航到第一个分页页面的链接标签。[默认 = '第一页']
• nav_label_prev：导航到上一个分页页面的链接标签。[默认 = '上一页']
• nav_label_next：导航到下一个分页页面的链接标签。[默认 = '下一页']
• nav_label_last：导航到最后一个分页页面的链接标签。[默认 = '最后一页']
• wrap_around：如果设置为 true，则前后导航将循环。[默认 = false]
• show_first_last：如果设置为 false，将阻止第一和最后一个导航链接加载。
• nav_info_id：显示导航信息文本的元素的 ID 或类名。[默认 = ".info_text"]
• nav_label_info：显示当前显示的结果和列表中结果总数的导航信息文本。[默认 = "显示 {0}-{1} 的 {2} 结果"]
• jquery_ui：如果设置为 true，则启用 jQuery UI 主题。[默认 = false]
• jquery_ui_active：活动页面的额外 jQuery UI 类。[默认 = "ui-state-highlight"]
• jquery_ui_default：所有链接的额外 jQuery UI 类。[默认 = "ui-state-default"]
• jquery_ui_disabled：禁用链接的额外 jQuery UI 类。[默认 = "ui-state-disabled"]
• onPageDisplayed：当页面显示时将调用的函数，如果存在，并传递当前页面编号。

4. 项目安装方式

请参考上面的安装指南，确保您已将 pajinate-x.x 文件夹放置在网站的目录结构中，并在 HTML 文件中包含了正确的脚本标签。按照使用说明中的步骤操作，即可成功安装并使用 Pajinate 插件。