pagination-standard

---

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

Response Parameters

Usage Examples

Backend Interface

Copyinterface 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

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

Frontend Pagination Calculation

Copy// 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.