CutestUI 分页组件

美观、多功能的纯 CSS 分页导航解决方案

概述

CutestUI 分页组件是一个完全基于 CSS 实现的分页导航解决方案,无需 JavaScript。它提供了丰富的样式变体和交互效果,能够满足各种网站的分页需求。组件设计简洁美观,响应式适配各种屏幕尺寸,同时支持多种状态和自定义样式。

特点:

基本使用方法

分页组件的基本结构非常简单,通过组合几个核心类来创建功能完整的分页导航。

基础分页示例
<nav> <ul class="pagination"> <li class="pagination-item pagination-prev"> <a href="#" class="pagination-link">上一页</a> </li> <li class="pagination-item"> <a href="#" class="pagination-link">1</a> </li> <li class="pagination-item"> <a href="#" class="pagination-link -active">2</a> </li> <li class="pagination-item"> <a href="#" class="pagination-link">3</a> </li> <li class="pagination-ellipsis">...</li> <li class="pagination-item pagination-next"> <a href="#" class="pagination-link">下一页</a> </li> </ul> </nav>

基本结构由以下几个部分组成:

样式变体

CutestUI 分页组件提供了多种样式变体,可以通过添加相应的类来应用不同的视觉效果。

圆角样式

圆角样式 (.-rounded)

药丸形状

药丸形状 (.-pill)

方形样式

方形样式 (.-squared)

带背景色的分页

带背景色的分页 (.-background)

透明背景的分页

透明背景的分页 (.-transparent)

深色主题分页

深色主题分页 (.-dark)

浅色主题分页

浅色主题分页 (.-light)

尺寸变体

分页组件提供了不同尺寸的变体,适应不同的布局需求。

小号分页 (.-small)
默认尺寸
大号分页 (.-large)

状态类

分页组件支持多种状态类,用于表示当前页面、禁用状态等。

激活状态

使用 .-active 类来标记当前活动的页码:

禁用状态

使用 .-disabled 类来禁用特定的分页项:

响应式设计

CutestUI 分页组件具有响应式设计,能够自动适应不同的屏幕尺寸。在移动设备上,分页组件会自动调整布局,隐藏部分页码,以确保良好的用户体验。

响应式特性:
提示: 为了在移动设备上获得最佳体验,建议保持分页项的数量合理,避免过多的页码导致界面拥挤。

组合样式

分页组件的各种样式变体可以组合使用,创建更加个性化的视觉效果。

药丸形状 + 小号
方形样式 + 大号
深色主题 + 圆角

类名参考

以下是 CutestUI 分页组件的所有可用类名及其描述:

类名 描述 适用元素
.pagination 基础分页容器 ul
.pagination-item 分页项 li
.pagination-link 分页链接 a
.pagination-prev 上一页按钮 li
.pagination-next 下一页按钮 li
.pagination-ellipsis 省略号 li
.-rounded 圆角样式 .pagination
.-pill 药丸形状 .pagination
.-squared 方形样式 .pagination
.-background 带背景色 .pagination
.-transparent 透明背景 .pagination
.-dark 深色主题 .pagination
.-light 浅色主题 .pagination
.-small 小号尺寸 .pagination
.-large 大号尺寸 .pagination
.-active 激活状态 .pagination-link
.-disabled 禁用状态 .pagination-link

使用指南

安装

将 pagings.css 文件引入到您的 HTML 页面中:

<link rel="stylesheet" href="/static/css/pagings.css">

基本步骤

  1. 创建一个 <nav> 元素作为分页的容器
  2. <nav> 内部添加一个无序列表 <ul> 并应用 .pagination
  3. 为每个分页项创建一个 <li> 元素并应用 .pagination-item
  4. 在每个 <li> 元素内部添加 <a> 标签并应用 .pagination-link
  5. 根据需要添加特殊类,如上一页 (.pagination-prev)、下一页 (.pagination-next) 和省略号 (.pagination-ellipsis)
  6. 应用所需的样式变体和状态类

最佳实践

注意: 虽然分页组件本身是纯 CSS 实现的,但在实际应用中,您可能需要使用 JavaScript 来处理页码的动态生成和点击事件。