Funciones de vista — Renderizar lista de artículos y página de detalle
En este capítulo aprenderás a usar funciones de vista para consultar datos de la base de datos, renderizar la página de inicio y la página de detalle, y dividir rutas con Blueprint.
Responsabilidades de las funciones de vista
Las responsabilidades de las funciones de vista en Flask son las mismas que en Django:Recibir solicitud → Consultar datos → Renderizar plantilla。
Ejemplo
from flask import Flask, render_template
from models import Post, Category
@app.route("/")
def index():
"""Página de inicio del blog: mostrar todos los artículos"""
posts = Post.query.order_by(Post.created_at.desc()).all()
categories = Category.query.all()
return render_template('index.html', posts=posts, categories=categories)
Parámetros de ruta y parámetros de consulta
| Tipo de parámetro | Ejemplo de URL | Método de obtención en la vista |
|---|---|---|
| Parámetro de ruta | /post/3 | En la ruta <tipo:nombre_variable> → parámetro de función |
| Parámetro de consulta | /?category=python | request.args.get('key') |
Las rutas de Flask admiten varios convertidores de tipo:<int:id>(entero),<string:slug>(predeterminado, sin incluir /),<path:path>(incluye /),<float:price>etc.
Página de detalle del artículo
Ejemplo
from flask import abort
@app.route("/post/<int:post_id>")
def post_detail(post_id):
"""Página de detalle del artículo"""
# get_or_404 es equivalente a: Post.query.get(post_id) or abort(404)
post = Post.query.get_or_404(post_id,
description=f'El artículo #{post_id} no existe')
return render_template('post_detail.html', post=post)
Página de error 404 personalizada
Ejemplo
def not_found(error):
return render_template('404.html'), 404
Filtrado por categoría
Ejemplo
from flask import request
@app.route("/")
def index():
category_slug = request.args.get('category', '')
keyword = request.args.get('q', '') # Palabra clave de búsqueda (implementada en el capítulo 6)
posts_query = Post.query.order_by(Post.created_at.desc())
# Filtrar por categoría
if category_slug:
posts_query = posts_query.join(Category).filter(Category.slug == category_slug)
posts = posts_query.all()
categories = Category.query.all()
return render_template('index.html',
posts=posts, categories=categories,
category_slug=category_slug, keyword=keyword)
request.argses un MultiDict inmutable, utilizado para leer los parámetros de consulta de la URL. Usa.get('key', '默认值')obtenerlo de forma segura; cuando el parámetro no existe, devuelve un valor predeterminado en lugar de un error.
Blueprint — División de rutas
Cuando las funciones de vista aumentan, apilarlas todas en app.py puede volverse incontrolable.
BlueprintEs el esquema de agrupación de rutas de Flask: divide las vistas por módulos funcionales y se registra mediante app.register_blueprint().
app/ ├── blueprints/ │ ├── __init__.py │ ├── main.py # 首页、关于、搜索 │ └── posts.py # 文章列表、详情 ├── templates/ ├── models.py └── __init__.py
Ejemplo
from flask import Blueprint, render_template, request
from app.models import Post, Category
# Blueprint('nombre_del_blueprint', __name__, url_prefix='/')
main_bp = Blueprint('main', __name__)
@main_bp.route("/")
def index():
"""Página de inicio del blog"""
category_slug = request.args.get('category', '')
posts_query = Post.query.order_by(Post.created_at.desc())
if category_slug:
posts_query = posts_query.join(Category).filter(Category.slug == category_slug)
return render_template('index.html',
posts=posts_query.all(),
categories=Category.query.all(),
category_slug=category_slug)
Ejemplo
from flask import Blueprint, render_template, abort
from app.models import Post
posts_bp = Blueprint('posts', __name__)
@posts_bp.route("/post/<int:post_id>")
def post_detail(post_id):
post = Post.query.get_or_404(post_id)
return render_template('post_detail.html', post=post)
Registrar el Blueprint en la entrada de la aplicación:
Ejemplo
from flask import Flask
from app.blueprints.main import main_bp
from app.blueprints.posts import posts_bp
app = Flask(__name__)
# Registrar blueprint: todas las funciones de vista de los blueprints se fusionarán en la misma aplicación
app.register_blueprint(main_bp)
app.register_blueprint(posts_bp)
Blueprint puede especificar
url_prefix(comourl_prefix='/blog'), entonces todas las rutas dentro del blueprint agregarán automáticamente ese prefijo. Blueprint también puede tener su propio directorio de plantillas y archivos estáticos.
Crear plantillas para la página de inicio y la página de detalle
index.html
Ejemplo
{% extends 'base.html' %}
{% block title %}EJEMPLO Blog - Inicio{% endblock %}
{% block content %}
<h2 class="section-title">Artículos recientes</h2>
<!-- Navegación de filtrado por categoría -->
<div class="category-bar">
<a href="{{ url_for('main.index') }}"
class="{% if not category_slug %}active{% endif %}">Todos</a>
{% for cat in categories %}
<a href="{{ url_for('main.index', category=cat.slug) }}"
class="{% if category_slug == cat.slug %}active{% endif %}">
{{ cat.name }}
</a>
{% endfor %}
</div>
{% 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>
{% else %}
<p class="empty-tip">No hay artículos en esta categoría.</p>
{% endif %}
{% endblock %}
Cuando se usan vistas de Blueprint en url_for(), el formato es
url_for('蓝图名.函数名'), comourl_for('posts.post_detail', post_id=3). Nota: comparado con el de Django{% url %}comparación de etiquetas: Flask usa{{ url_for() }}, se puede anidar en expresiones de Python para mayor flexibilidad.
Resumen del capítulo
En este capítulo has dominado la organización de vistas y rutas en Flask: Post.query para consultar datos, parámetros de ruta <int:post_id> y parámetros de consulta request.args, get_or_404 para consultas seguras, abort(404) y páginas de error personalizadas, y Blueprint para dividir rutas por módulos.
El blog ahora tiene tres páginas completas: la lista de artículos de la página de inicio, el filtrado por categorías y la página de detalle.
Otras extensiones