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

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.