模組概覽#
若要取得隨機圖片，請使用 {{$image.url}}。這不會直接回傳圖片，而是回傳一個指向圖片的 URL，圖片來自兩個示範圖片提供者之一：「Picsum」和「LoremFlickr」。你可以使用 {{$image.urlLoremFlickr}} 或 {{$image.urlPicsumPhotos}}，指定從這兩個提供者之一請求圖片。若要取得只包含純色和文字的隨機佔位圖片，請使用 {{$image.urlPlaceholder}}（使用第三方服務）或 {{$image.dataUri}}（回傳 SVG 字串）。若要取得隨機使用者頭像圖片，請使用 {{$image.avatar}}。此模組先前也包含用於特定主題圖片的方法，例如「fashion」或「food」，但這些現在已被棄用。如果你需要更精細地控制圖片類型，可以使用 {{$image.urlLoremFlickr}} 請求分類圖片、直接使用圖片提供者，或提供你自己的佔位圖片集合。
avatar#
avatarGitHub#
avatarLegacy#
從 https://cloudflare-ipfs.com/ipfs/Qmd3W5DuhgHirLHGVixi6V76LhCkZUz6pnFt5AJBiyvHye/avatar 產生隨機頭像。
dataUri#
產生包含 URL 編碼 SVG 圖片或 Base64 編碼 SVG 圖片的隨機資料 URI。| 名稱 | 類型 | 預設值 | 說明 |
|---|
| color | string | {{$color.rgb}} | 圖片的顏色。必須是 svg 支援的顏色。 |
| height | number | {{$number.int(min=1,max=3999)}} | 圖片的高度。 |
| type | 'svg-uri' | 'svg-base64' | {{$helpers.arrayElements(['svg-uri','svg-base64'])}} | 圖片的類型。 |
| width | number | {{$number.int(min=1,max=3999)}} | 圖片的寬度。 |
url#
| 名稱 | 類型 | 預設值 | 說明 |
|---|
| height | number | {{$number.int(min=1,max=3999)}} | 圖片的高度。 |
| width | number | {{$number.int(min=1,max=3999)}} | 圖片的寬度。 |
urlLoremFlickr#
| 名稱 | 類型 | 預設值 | 說明 |
|---|
| category | string | | 用於圖片的分類。 |
| height | number | {{$number.int(min=1,max=3999)}} | 圖片的高度。 |
| width | number | {{$number.int(min=1,max=3999)}} | 圖片的寬度。 |
urlPicsumPhotos#
| 名稱 | 類型 | 預設值 | 說明 |
|---|
| blur | 0 | 10 | 2 | 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | {{$number.int(max=10)}} | 圖片是否應模糊。0 會停用模糊。 |
| grayscale | boolean | {{$datatype.boolean}} | 圖片是否應為灰階。 |
| height | number | {{$number.int(min=1,max=3999)}} | 圖片的高度。 |
| width | number | {{$number.int(min=1,max=3999)}} | 圖片的寬度。 |
urlPlaceholder#
| 名稱 | 類型 | 預設值 | 說明 |
|---|
| backgroundColor | string | {{$color.rgb(prefix=' ',format='hex')}} | 圖片的背景顏色。 |
| format | 'gif' | 'jpeg' | 'jpg' | 'png' | 'webp' | {{$helpers.arrayElement(['gif','jpeg','jpg','png','webp'])}} | 圖片的格式。 |
| height | number | {{$number.int(min=1,max=3999)}} | 圖片的高度。 |
| text | number | {{$color.rgb(prefix=' ',format='hex')}} | 顯示在圖片上的文字。 |
| textColor | string | {{$number.int(min=1,max=3999)}} | 圖片的文字顏色。 |
| width | number | {{$number.int(min=1,max=3999)}} | 圖片的寬度。 |
Modified at 2026-06-11 10:26:02
