一次載入數千筆貼文:頻寬浪費、記憶體暴增、渲染緩慢。分頁將資料切割為固定大小頁面,按需載入。
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') }}
// 簡易版:捲動到底載入下一頁
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.pyPOSTS_PER_PAGE = 10
MAX_SEARCH_RESULTS = 50
Flask-SQLAlchemy paginate() + Jinja2 巨集 = **後端一行、前端可復用** 的分頁系統。記得設定 error_out=False 避免無效頁碼拋 404,並善用 iter_pages() 產生智慧型導航列(自動縮略中間頁碼)。