萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Flask 分頁功能實戰:Flask-SQLAlchemy paginate() 與前端導航列

為什麼需要分頁?

一次載入數千筆貼文:頻寬浪費、記憶體暴增、渲染緩慢。分頁將資料切割為固定大小頁面,按需載入。

後端:paginate() 一鍵搞定

from flask import request, render_template
from models import Post

@app.route('/')
@app.route('/index')
@login_required
def index():
    page = request.args.get('page', 1, type=int)
    per_page = current_app.config['POSTS_PER_PAGE']  # 設定檔定義,如 10
    
    pagination = Post.query.order_by(Post.timestamp.desc()).paginate(
        page=page, per_page=per_page, error_out=False
    )
    posts = pagination.items
    return render_template('index.html', posts=posts, pagination=pagination)

Pagination 物件屬性速查

屬性/方法說明
items當前頁資料列表
page當前頁碼 (1-based)
per_page每頁筆數
total總筆數
pages總頁數
has_prev / has_next是否有上/下一頁
prev_num / next_num上/下一頁頁碼
iter_pages()產生導航列頁碼 (含省略號)

前端導航列模板 templates/_pagination.html

{% macro render_pagination(pagination, endpoint) %}
{% if pagination.pages > 1 %}

{% endif %}
{% endmacro %}

在頁面引用巨集

{# index.html #}
{% from "_pagination.html" import render_pagination %}

{% for post in posts %}
    <article>{{ post.body }}</article>
{% endfor %}

{{ render_pagination(pagination, 'index') }}

進階:AJAX 無限捲動

// 簡易版:捲動到底載入下一頁
let loading = false;
window.addEventListener('scroll', () => {
    if (loading) return;
    if (window.innerHeight + window.scrollY >= document.body.offsetHeight - 100) {
        loading = true;
        fetch(`/api/posts?page={{ pagination.next_num }}`)
            .then(r => r.json())
            .then(data => {
                data.posts.forEach(p => appendPost(p));
                loading = false;
            });
    }
});

設定檔 config.py

POSTS_PER_PAGE = 10
MAX_SEARCH_RESULTS = 50

結語

Flask-SQLAlchemy paginate() + Jinja2 巨集 = **後端一行、前端可復用** 的分頁系統。記得設定 error_out=False 避免無效頁碼拋 404,並善用 iter_pages() 產生智慧型導航列(自動縮略中間頁碼)。

copyright © 萬盛學電腦網 all rights reserved