page.js
頁面 (page) 是指對應路由的唯一使用者介面。
Props 屬性
params
(選用)
一個包含從根區段到該頁面的動態路由參數 (dynamic route parameters) 的物件。例如:
範例 | URL | params |
---|---|---|
app/shop/[slug]/page.js | /shop/1 | { slug: '1' } |
app/shop/[category]/[item]/page.js | /shop/1/2 | { category: '1', item: '2' } |
app/shop/[...slug]/page.js | /shop/1/2 | { slug: ['1', '2'] } |
searchParams
(選用)
一個包含當前 URL 的搜尋參數 (search parameters) 的物件。例如:
URL | searchParams |
---|---|
/shop?a=1 | { a: '1' } |
/shop?a=1&b=2 | { a: '1', b: '2' } |
/shop?a=1&a=2 | { a: ['1', '2'] } |
須知事項:
searchParams
是一個**動態 API (Dynamic API),其值無法預先得知。使用它會使頁面在請求時選擇動態渲染 (dynamic rendering)**。searchParams
會回傳一個純 JavaScript 物件,而非URLSearchParams
實例。
版本歷史
版本 | 變更內容 |
---|---|
v13.0.0 | 引入 page 功能。 |