# Pagination Standard

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

- Skill: `majiayu000/pagination-standard` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/pagination-standard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/pagination-standard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/pagination-standard

---


## 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

```typescript
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

```typescript
// 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.