Búsqueda por palabras clave y paginación
En este capítulo aprenderás a usar SQLAlchemy para implementar búsqueda combinada y a optimizar la página de listado con la funcionalidad de paginación integrada de Flask-SQLAlchemy.
ilike — búsqueda sin distinción de mayúsculas y minúsculas
El método de SQLAlchemyilikeimplementa la coincidencia difusa sin distinguir mayúsculas y minúsculas.
Corresponde al operador de SQLLIKEpero ignora mayúsculas y minúsculas.
Ejemplo
posts = Post.query.filter(Post.title.ilike('%flask%')).all()
# Búsqueda combinada de varios campos: or_() representa la relación OR
from sqlalchemy import or_
posts = Post.query.filter(
or_(
Post.title.ilike('%flask%'),
Post.summary.ilike('%flask%')
)
).all()
| Método | Operador SQL | Distingue mayúsculas y minúsculas |
|---|---|---|
| like() | LIKE | Distingue |
| ilike() | LIKE (ignora mayúsculas y minúsculas) | No distingue |
| contains() | LIKE '%x%' | Distingue |
| startswith() | LIKE 'x%' | Distingue |
| in_() | IN | Coincidencia exacta |
paginate — paginación
Flask-SQLAlchemy proporciona unpaginate()método que con una sola llamada devuelve los datos de la página actual + metainformación de paginación.
Ejemplo
page = request.args.get('page', 1, type=int) # Número de página actual (por defecto, página 1)
per_page = 6 # Mostrar 6 artículos por página
# paginate(page, per_page, error_out)
# error_out=False: cuando el número de página está fuera de rango, no devuelve 404, sino una lista vacía
pagination = posts_query.paginate(page=page, per_page=per_page, error_out=False)
posts = pagination.items # Lista de artículos de la página actual
Atributos del objeto pagination
| Atributo | Tipo | Descripción |
|---|---|---|
| items | Lista | Datos de la página actual |
| page | int | Número de página actual |
| pages | int | Número total de páginas |
| total | int | Número total de registros |
| has_prev | bool | Si hay página anterior |
| has_next | bool | Si hay página siguiente |
| prev_num | int | Número de página anterior |
| next_num | int | Número de página siguiente |
Vista completa de búsqueda + paginación
Ejemplo
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
# Consulta básica
posts_query = Post.query.order_by(Post.created_at.desc())
# Filtro por categoría
if category_slug:
posts_query = posts_query.join(Category).filter(Category.slug == category_slug)
# Búsqueda por palabra clave (título o resumen)
if keyword:
posts_query = posts_query.filter(
or_(
Post.title.ilike(f'%{keyword}%'),
Post.summary.ilike(f'%{keyword}%')
)
)
# Paginación
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)
Los parámetros de consulta se pasan a través de la URL (por ejemplo,
/?q=flask&page=2) los enlaces de navegación de paginación deben incluir los parámetros actuales de búsqueda y categoría; de lo contrario, las condiciones se perderán al cambiar de página.
Cuadro de búsqueda y navegación de paginación en la plantilla
Ejemplo
{% extends 'base.html' %}
{% block title %}Blog EJEMPLO - Inicio{% endblock %}
{% block content %}
<h2 class="section-title">Artículos recientes</h2>
<!-- Cuadro de búsqueda -->
<div class="search-bar">
<form method="get" action="{{ url_for('main.index') }}">
<input type="text" name="q" value="{{ keyword }}"
placeholder="Buscar título o resumen del artículo..." class="search-input">
{% if keyword %}
<a href="{{ url_for('main.index', category=category_slug) }}" class="clear-btn">✕</a>
{% endif %}
</form>
</div>
<!-- Filtro por categoría -->
<div class="category-bar">
<a href="{{ url_for('main.index', q=keyword) }}"
class="{% if not category_slug %}active{% endif %}">Todos</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">
Total: {{ pagination.total }} artículos
{% if keyword %}, buscando «{{ 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>
<!-- Navegación de paginación -->
{% 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) }}">← Anterior</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) }}">Siguiente →</a>
{% endif %}
</div>
{% endif %}
{% else %}
<p class="empty-tip">No se encontraron artículos que coincidan.</p>
{% endif %}
{% endblock %}
Resumen del capítulo
En este capítulo has dominado las funciones prácticas de la página de listado: búsqueda insensible a mayúsculas y minúsculas con ilike, búsqueda combinada de varios campos con or_(), consulta paginada con paginate(), renderizado de la navegación de paginación en la plantilla y conservación de los parámetros de filtro.
Búsqueda + filtro por categoría + paginación: los tres se pueden combinar de cualquier forma y las condiciones no se pierden.
Otras extensiones