mirror of
https://github.com/lukaszraczylo/go-telegram.git
synced 2026-06-06 22:49:32 +00:00
lukaszraczylo
ac7cae8fa7
A fully-generated, strongly-typed Go client for the Telegram Bot API. * 176 methods + 301 types generated from Bot API v10.0 * 1408 auto-generated tests (8 scenarios per method) * Typed unions throughout — no 'any' in the public surface * Pluggable HTTP transport and JSON codec (default goccy/go-json) * Built-in retry middleware honouring Telegram's retry_after * Generic dispatcher with filters and conversation handlers * Self-verifying codegen pipeline (regen → audit → emit → run tests) * 14 example bots covering common patterns
30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# pagination
|
|
|
|
Multi-page inline keyboard for browsing a list. No server-side session required — page state is encoded in callback data.
|
|
|
|
## What it shows
|
|
|
|
- `OnCommand("/list")` sends the first page with inline navigation buttons
|
|
- `OnCallback("^page:(\\d+)$")` parses page number from callback data via `c.Values["regex_match"]`
|
|
- `api.EditMessageText` edits the message in-place on each page turn
|
|
- `api.AnswerCallbackQuery` dismisses the loading spinner
|
|
|
|
## Pattern
|
|
|
|
Callback data format: `page:<n>` where `n` is the 0-based page index.
|
|
|
|
The `renderPage` helper builds both the text content and the keyboard in one call. Only [« Prev] or [Next »] buttons that make sense for the current page are rendered, so the keyboard is always minimal.
|
|
|
|
## Running
|
|
|
|
```bash
|
|
export TELEGRAM_BOT_TOKEN=123456:ABC...
|
|
go run ./examples/pagination
|
|
```
|
|
|
|
Send `/list` to the bot. Tap Next/Prev to navigate 20 sample items, 5 per page.
|
|
|
|
## Extending
|
|
|
|
To paginate dynamic data (database results, API responses), replace `sampleItems` with a function that takes `(page, pageSize)` and returns items + total count.
|