[Day 09] 做出一個網站：Jinja Template

2023 iThome 鐵人賽

DAY 9

Software Development

FastAPI 開發筆記：從新手到專家的成長之路系列第 9 篇

15th鐵人賽

ck642509

2023-09-22 23:28:36

1266 瀏覽

分享至

在昨天的文章中，我們提到了 FastAPI 的回應可以是 HTML，今天讓我們來看看要怎麼讓 FastAPI 回傳一個靜態網站

製作網站

當然，這個網站無法像 API 文件一樣自動生成，因此，第一步就是要要自己製作一個網頁

想要做出一個靜態網站，基本上都會需要 HTML、CSS、JavaScript，這邊就不多作介紹了

這邊我們先快速建構一個畫面 (這邊我用以前坊間補習班的作業)

https://gist.github.com/CK642509/8986cb0dd9c5835f43a45ccbe41a6571

然後把這段 HTML 貼到下面程式的 html 內
(為了不浪費版面，HTML 就不貼上來了)

from fastapi import FastAPI
from fastapi.responses import HTMLResponse

app = FastAPI()

html = """
<html lang="en">
</html>
"""

@app.get("/hello")
async def hello():
    return HTMLResponse(content=html)

接下來進到 http://127.0.0.1:8000/hello，就可以看到畫面了

如果想把網頁內容拆成 index.html 和 main.css 分開管理也可以，只要 HTML 內有設好路徑，例如：

<link rel="stylesheet" href="/main.css">

再把對應的檔案改用 FileResponse 就好

from fastapi import FastAPI
from fastapi.responses import FileResponse

app = FastAPI()

@app.get("/hello")
async def hello():
    return FileResponse("index.html")

@app.get("/main.css")
async def css():
    return FileResponse("main.css")

但這樣的做法還是有點太粗暴了，每個 HTML 都要土法煉鋼的慢慢製作，這時，樣板引擎 (template engine) 就登場啦~

此時就可以考慮使用如果遇到需要帶參數到 HTML 內，或是想要更有效率的

樣板引擎 Jinja

樣板引擎主要的功能就是透過樣板來產生 HTML，簡單來說就是用程式來寫 HTML。而基本上，所有樣板引擎 FastAPI 都支援，其中，最常見的是 Jinja

需要多安裝 jinja2，安裝指令是 pip install jinja2

在 FastAPI，要正確使用 jinja 的關鍵點是

要 mount HTML 內會使用到的檔案
設定 HTML template 的資料夾路徑
回傳 TemplateResponse 時，除了指定要使用的樣板 HTML，其他樣板中會使用到的參數也需要一併帶上

來看看官網給的範例

# main.py
from fastapi import FastAPI, Request
from fastapi.responses import HTMLResponse
from fastapi.staticfiles import StaticFiles
from fastapi.templating import Jinja2Templates

app = FastAPI()

app.mount("/static", StaticFiles(directory="static"))

templates = Jinja2Templates(directory="templates")

@app.get("/items/{id}", response_class=HTMLResponse)
async def read_item(request: Request, id: str):
    return templates.TemplateResponse("item.html", {"request": request, "id": id})

item.html

<html>
<head>
    <title>Item Details</title>
    <link href="{{ url_for('static', path='/styles.css') }}" rel="stylesheet">
</head>
<body>
    <h1>Item ID: {{ id }}</h1>
</body>
</html>

styles.css

h1 {
    color: green;
}

接下來就可以看到我們定義的樣板的結果了

其他作法

如果上面的方法都不喜歡，也可以用現在常見的前端框架 (例如：React、Vue、Angular) 做好畫面後，編譯成靜態檔，再用類似上面的方法加在 FastAPI 後端內。

下面這個例子是我把靜態檔都放在 dist 資料夾內

from fastapi import FastAPI, Request
from fastapi.responses import HTMLResponse
from fastapi.staticfiles import StaticFiles
from fastapi.templating import Jinja2Templates

app = FastAPI()

app.mount("/assets", StaticFiles(directory="dist/assets"))

templates = Jinja2Templates(directory="dist")

@app.get("/", response_class=HTMLResponse)
async def read_item(request: Request):
    return templates.TemplateResponse("index.html", {"request": request})