pagination-standard

TrueNine 的头像作者 TrueNine

前端后端分页标准,定义最小参数命名以减少传输字符,适用于所有系统分页场景。

📖 中文导读:前端后端分页标准,定义最小参数命名以减少传输字符,适用于所有系统分页场景。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: pagination-standard description: Frontend-backend pagination standard, defining minimal parameter naming to reduce transmission characters, applicable to all system pagination scenarios.

Pagination Parameter Standard

Request Parameters

Param Full Name Type Default Description
o offset number 0 Offset, starting from which record
s size number 42 Page size

Response Parameters

Param Full Name Type Description
d data array Data list
t total number Total record count
p pages number Total page count

Usage Examples

Backend Interface

interface PageQuery {
  o?: number  // offset, default 0
  s?: number  // size, default 42
}

interface PageResult<T> {
  d: T[]      // data list
  t: number   // total count
  p: number   // total pages
}

Frontend Query Params

GET /api/users?o=0&s=42
GET /api/users?o=42&s=42   // page 2

Frontend Pagination Calculation

// page number to offset
const offset = (page - 1) * size

// offset to page number
const page = Math.floor(offset / size) + 1

// total pages
const totalPages = Math.ceil(total / size)

Design Philosophy

Single-letter minimal parameter naming reduces network transmission characters. Significantly lowers bandwidth consumption in high-frequency call scenarios.