re:re:actable
Урок 082 минуты чтения

Как сделать пагинацию поиск и сортировку

На этой странице
Кратко

Пагинация ограничивает число строк в ответе. Поиск и сортировка должны выполняться с проверенными параметрами, сохраняя ограничение доступа к данным пользователя.

Вопрос

Как не загружать все задачи сразу и безопасно учитывать параметры адреса?

Основная идея

Для небольших списков подойдет LIMIT и OFFSET: пропустить строки предыдущих страниц и взять следующие. Для больших и часто меняющихся списков используют курсор — значения последней показанной строки.

Пример: серверная функция поиска

Добавь в отдельный файл рядом с DAL. Используются уже созданные пул и сессии:

// lib/task-search.ts
import "server-only";
import { z } from "zod";
import { pool } from "./db";
import { requireUser } from "./session";
import type { Task } from "./tasks";
 
export async function searchTasks(raw: unknown) {
  const user = await requireUser();
  const input = z.object({
    page: z.coerce.number().int().min(1).max(1000).default(1),
    query: z.string().max(100).default(""),
    sort: z.enum(["new", "title"]).default("new"),
  }).parse(raw);
  const order = input.sort === "title"
    ? "title ASC, id ASC" : "created_at DESC, id DESC";
  const result = await pool.query<Task>(
    `SELECT id, title, completed FROM tasks
     WHERE owner_id = $1 AND title ILIKE $2
     ORDER BY ${order} LIMIT 21 OFFSET $3`,
    [user.id, `%${input.query}%`, (input.page - 1) * 20],
  );
  return { items: result.rows.slice(0, 20), hasNext: result.rows.length > 20 };
}

Двадцать первая строка нужна только для определения следующей страницы. В SQL подставляется один из двух заранее заданных вариантов сортировки; пользовательский текст в ORDER BY не попадает. Поисковое значение передается параметром.

В серверной странице параметры читают через await searchParams. Передай в функцию объект { page, query, sort } из URL /tasks?page=2&query=React&sort=new, а полученный список отрисуй вместо прежнего listTasks().

Что важно помнить

searchParams может содержать массивы при повторении параметра. Приведенная схема такие значения отвергает; покажи понятную ошибку фильтра вместо аварийного экрана.

Символы % и _ в ILIKE имеют смысл шаблона, но параметризация не дает им стать SQL-командой. Для буквального поиска эти символы экранируют отдельно.

Большой OFFSET может быть дорогим. Курсорная пагинация по паре (created_at, id) лучше масштабируется, но требует такого же устойчивого порядка. Проверяй индекс и план запроса.

Мини-шпаргалка

  • Ограничивай страницу и длину поиска.
  • Для сортировки используй список допустимых вариантов.
  • Добавляй уникальный ключ к порядку строк.
  • Условие владельца остается при любых фильтрах.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам