Поиск по ключевым словам и пагинация

В этой главе вы научитесь использовать SQLAlchemy для комбинированного поиска и оптимизировать страницу списка с помощью встроенной пагинации Flask-SQLAlchemy.


ilike — поиск без учёта регистра

В SQLAlchemy методilikeреализует нечувствительное к регистру нечёткое сопоставление.

Он соответствует SQLLIKEоператор, но игнорирует регистр.

Пример

# Поиск по одному полю
posts = Post.query.filter(Post.title.ilike('%flask%')).all()

# Комбинированный поиск по нескольким полям: or_() обозначает связь ИЛИ
from sqlalchemy import or_
posts = Post.query.filter(
    or_(
        Post.title.ilike('%flask%'),
        Post.summary.ilike('%flask%')
    )
).all()
МетодыОператоры SQLС учётом регистра
like()LIKEРазличает
ilike()LIKE (без учёта регистра)Не различает
contains()LIKE '%x%'Различает
startswith()LIKE 'x%'Различает
in_()INТочное совпадение

paginate — Пагинация

Flask-SQLAlchemy предоставляетpaginate()Этот метод возвращает данные текущей страницы + метаданные пагинации за один вызов.

Пример

# Отрефакторить представление index из main.py
page = request.args.get('page', 1, type=int)  # Номер текущей страницы (по умолчанию страница 1)
per_page = 6                                    # Отображать 6 статей на странице

# paginate(page, per_page, error_out)
# error_out=False: когда номер страницы выходит за диапазон, возвращает пустой список вместо 404
pagination = posts_query.paginate(page=page, per_page=per_page, error_out=False)
posts = pagination.items     # Список статей для текущей страницы

атрибуты объекта pagination

СвойствоTypeОписание
itemsСписокДанные текущей страницы
pageintНомер текущей страницы
pagesintОбщее количество страниц
totalintОбщее количество записей
has_prevboolЕсть ли предыдущая страница
has_nextboolЕсть ли следующая страница
prev_numintНомер предыдущей страницы
next_numintНомер следующей страницы

Полное представление поиска + пагинации

Пример

# Путь к файлу: app/blueprints/main.py
from flask import Blueprint, render_template, request
from sqlalchemy import or_
from app.models import Post, Category

main_bp = Blueprint('main', __name__)

@main_bp.route("/")
def index():
    category_slug = request.args.get('category', '')
    keyword = request.args.get('q', '').strip()
    page = request.args.get('page', 1, type=int)
    per_page = 6

    # Базовый запрос
    posts_query = Post.query.order_by(Post.created_at.desc())

    # Фильтр по категории
    if category_slug:
        posts_query = posts_query.join(Category).filter(Category.slug == category_slug)

    # Поиск по ключевым словам (заголовок или краткое описание)
    if keyword:
        posts_query = posts_query.filter(
            or_(
                Post.title.ilike(f'%{keyword}%'),
                Post.summary.ilike(f'%{keyword}%')
            )
        )

    # Пагинация
    pagination = posts_query.paginate(
        page=page, per_page=per_page, error_out=False)
    posts = pagination.items

    return render_template('index.html',
        posts=posts, pagination=pagination,
        categories=Category.query.all(),
        category_slug=category_slug, keyword=keyword)

Параметры запроса передаются через URL (например,/?q=flask&page=2), ссылки постраничной навигации должны содержать текущие параметры поиска и категории, иначе после постраничного перехода условия будут потеряны.


Поле поиска и постраничная навигация в шаблоне

Пример

<!-- Путь к файлу: app/templates/index.html -->
{% extends 'base.html' %}

{% block title %}EXAMPLE Blog - Главная{% endblock %}

{% block content %}
<h2 class="section-title">Последние статьи</h2>

<!-- Поле поиска -->
<div class="search-bar">
    <form method="get" action="{{ url_for('main.index') }}">
        <input type="text" name="q" value="{{ keyword }}"
              placeholder=Поиск по заголовкам или аннотациям статей... class="search-input">
        {% if keyword %}
        <a href="{{ url_for('main.index', category=category_slug) }}" class="clear-btn">✕</a>
        {% endif %}
    </форма>
</div>

<!-- Фильтр по категориям -->
<div class="category-bar">
    <a href="{{ url_for('main.index', q=keyword) }}"
      class="{% if not category_slug %}active{% endif %}">Все</a>
    {% for cat in categories %}
    <a href="{{ url_for('main.index', category=cat.slug, q=keyword) }}"
      class="{% if category_slug == cat.slug %}active{% endif %}">
        {{ cat.name }}
    </a>
    {% endfor %}
</div>

<p class="result-info">
Всего {{ pagination.total }} статей
{% if keyword %}, поиск "{{ keyword }}"{% endif %}
</p>

{% if posts %}
<div class="article-grid">
    {% for post in posts %}
    <a href="{{ url_for('posts.post_detail', post_id=post.id) }}" class="card-link">
        <div class="article-card">
            <div class="card-content">
                <span class="card-category">{{ post.category.name }}</span>
                <h3>{{ post.title }}</h3>
                <p>{{ post.summary|truncate(80) }}</p>
                <span class="card-date">{{ post.created_at.strftime('%Y-%m-%d') }}</span>
            </div>
        </div>
    </a>
    {% endfor %}
</div>

<!-- Навигация по страницам -->
{% if pagination.pages > 1 %}
<div class="pagination">
    {% if pagination.has_prev %}
    <a href="{{ url_for('main.index', page=pagination.prev_num, category=category_slug, q=keyword) }}">← Предыдущая страница</a>
    {% endif %}

    {% for page_num in range(1, pagination.pages + 1) %}
        {% if page_num == pagination.page %}
        <span class="current">{{ page_num }}</span>
        {% else %}
        <a href="{{ url_for('main.index', page=page_num, category=category_slug, q=keyword) }}">{{ page_num }}</a>
        {% endif %}
    {% endfor %}

    {% if pagination.has_next %}
    <a href="{{ url_for('main.index', page=pagination.next_num, category=category_slug, q=keyword) }}">Следующая страница →</a>
    {% endif %}
</div>
{% endif %}

{% else %}
<p class="empty-tip">Подходящие статьи не найдены.</p>
{% endif %}
{% endblock %}

Итоги главы

В этой главе вы освоили практические возможности страницы списка: регистронезависимый поиск с ilike, комбинированный поиск по нескольким полям с or_(), запрос пагинации с paginate() и отрисовку навигации по страницам в шаблонах с сохранением параметров фильтра.

Поиск + фильтрация по категориям + пагинация можно комбинировать любым способом, и условия не будут потеряны.

Другие расширения