跳到主要内容

图片(Image)

生成图片的模块。


概述

对于随机图片,请使用 {{$image.url}}。这不会直接返回图片,而是一个指向两个演示图片提供商“Picsum”和“LoremFlickr”之一的图片的 URL。你可以使用 {{$image.urlLoremFlickr}}{{$image.urlPicsumPhotos}} 专门从两个提供商之一请求图片。


对于仅包含纯色和文本的随机占位符图片,请使用 {{$image.urlPlaceholder}}(使用第三方服务)或 {{$image.dataUri}}(返回 SVG 字符串)。


对于随机用户头像图片,请使用 {{$image.avatar}}


此模块以前还包含用于生成特定主题图片的方法,例如“时尚”或“食物”,但这些方法现已弃用。如果你需要对图片类型进行更多控制,可以使用 {{$image.urlLoremFlickr}} 请求分类图片,直接使用图片提供商或提供你自己的占位符图片集。

avatar

生成一个随机的头像图片 URL。

返回: 字符串

示例

{{$image.avatar}} // 'https://cloudflare-ipfs.com/ipfs/Qmd3W5DuhgHirLHGVixi6V76LhCkZUz6pnFt5AJBiyvHye/avatar/65.jpg'

avatarGitHub

从 GitHub 生成一个随机的头像。

返回: 字符串

示例

{{$image.avatarGitHub}} // 'https://avatars.githubusercontent.com/u/30238607'

avatarLegacy

https://cloudflare-ipfs.com/ipfs/Qmd3W5DuhgHirLHGVixi6V76LhCkZUz6pnFt5AJBiyvHye/avatar 生成一个随机的头像。

返回: 字符串

示例

{{$image.avatarLegacy}} // 'https://cloudflare-ipfs.com/ipfs/Qmd3W5DuhgHirLHGVixi6V76LhCkZUz6pnFt5AJBiyvHye/avatar/386.jpg'

dataUri

生成一个随机的数据 URI,其中包含 URL 编码的 SVG 图片或 Base64 编码的 SVG 图片。

参数

名称类型默认值描述
color字符串{{$color.rgb}}图片的颜色。必须是 SVG 支持的颜色。
height数字{{$number.int(min=1,max=3999)}}图片的高度。
type'svg-uri' | 'svg-base64'{{$helpers.arrayElements(['svg-uri','svg-base64'])}}图片的宽度。
width数字{{$number.int(min=1,max=3999)}}图片的宽度。

返回: 字符串

示例

{{$image.dataUri}}  // 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIxNTE1IiBoZWlnaHQ9IjM1MCI+PHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAwJSIgZmlsbD0iIzliYmU5YiIvPjx0ZXh0IHg9Ijc1Ny41IiB5PSIxNzUiIGZvbnQtc2l6ZT0iMjAiIGFsaWdubWVudC1iYXNlbGluZT0ibWlkZGxlIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBmaWxsPSJ3aGl0ZSI+MTUxNXgzNTA8L3RleHQ+PC9zdmc+'

{{$image.dataUri(type='svg-base64')}} // 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgYmFzZVByb2ZpbGU9ImZ1bGwiIHdpZHRoPSIyMDMxIiBoZWlnaHQ9IjI4ODAiPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9IiNkNDM5YTIiLz48dGV4dCB4PSIxMDE1LjUiIHk9IjE0NDAiIGZvbnQtc2l6ZT0iMjAiIGFsaWdubWVudC1iYXNlbGluZT0ibWlkZGxlIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIiBmaWxsPSJ3aGl0ZSI+MjAzMXgyODgwPC90ZXh0Pjwvc3ZnPg=='

url

生成一个随机的图片 URL。

参数

名称类型默认值描述
height数字{{$number.int(min=1,max=3999)}}图片的高度。
width数字{{$number.int(min=1,max=3999)}}图片的宽度。

返回: 字符串

示例

{{$image.url}}  // 'https://picsum.photos/seed/nJK2R/2332/2694'

urlLoremFlickr

通过 https://loremflickr.com 生成一个随机的图片 URL。

参数

名称类型默认值描述
category字符串要用于图片的类别。
height数字{{$number.int(min=1,max=3999)}}图片的高度。
width数字{{$number.int(min=1,max=3999)}}图片的宽度。

返回: 字符串

示例

{{$image.urlLoremFlickr}}  // 'https://loremflickr.com/11/794?lock=4460902446123441'

{{$image.urlLoremFlickr(width=128)}} // 'https://loremflickr.com/128/1314?lock=569187007940822'

{{$image.urlLoremFlickr(height=128)}} // 'https://loremflickr.com/2575/128?lock=7327202370111549'

{{$image.urlLoremFlickr(category='nature')}} // 'https://loremflickr.com/1911/126/nature?lock=2207830818001848'

urlPicsumPhotos

通过 https://picsum.photos 生成一个随机的图片 URL。

参数

名称类型默认值描述
blur0 | 10 | 2 | 1 | 3 | 4 | 5 | 6 | 7 | 8 | 9{{$number.int(max=10)}}图片是否应该模糊。0 禁用模糊。
grayscale布尔值{{$datatype.boolean}}图片是否应该为灰度。
height数字{{$number.int(min=1,max=3999)}}图片的高度。
width数字{{$number.int(min=1,max=3999)}}图片的宽度。

返回: 字符串

示例

{{$image.urlPicsumPhotos}}  // 'https://picsum.photos/seed/eOBLomQ1/1855/2500?blur=4'

{{$image.urlPicsumPhotos(width=128)}} // 'https://picsum.photos/seed/bCbuNt3B6U/128/2821?grayscale&blur=4'

{{$image.urlPicsumPhotos(height=128)}} // 'https://picsum.photos/seed/XJ2rBGY/184/128?blur=7'

{{$image.urlPicsumPhotos(grayscale=true)}} // 'https://picsum.photos/seed/kPftIofTd/1752/3352?grayscale&blur=8'

{{$image.urlPicsumPhotos(grayscale=true,blur=4)}} / 'https://picsum.photos/seed/7FxoLqG/48/412?grayscale&blur=4'

{{$image.urlPicsumPhotos(blur=4)}} //. 'https://picsum.photos/seed/DNM5Ncdzk/388/538?blur=4'

urlPlaceholder

通过 https://via.placeholder.com/ 生成一个随机的图片 URL。

参数

名称类型默认值描述
backgroundColor字符串{{$color.rgb(prefix=' ',format='hex')}}图片的背景色。
format'gif' | 'jpeg' | 'jpg' | 'png' | 'webp'{{$helpers.arrayElement(['gif','jpeg','jpg','png','webp'])}}图片的格式。
height数字{{$number.int(min=1,max=3999)}}图片的高度。
text数字{{$color.rgb(prefix=' ',format='hex')}}要在图片上显示的文本。
textColor字符串{{$number.int(min=1,max=3999)}}图片的文本颜色。
width数字{{$number.int(min=1,max=3999)}}图片的宽度。

返回: 字符串

示例

{{$image.urlPlaceholder}} // 'https://via.placeholder.com/1168x536/7dd5df/b705ad.jpeg?text=umquam%20adsum%20sit'

{{$image.urlPlaceholder(width=128)}} // 'https://via.placeholder.com/128x1123/9fcd41/a28509.png?text=sodalitas%20audeo%20causa'

{{$image.urlPlaceholder(height=128)}} // 'https://via.placeholder.com/210x128/429e9c/34de09.png?text=suasoria%20paens%20toties'

{{$image.urlPlaceholder(backgroundColor='000000')}} // 'https://via.placeholder.com/1719x1836/000000/aea69b.jpg?text=cibo%20coaegresco%20deludo'

{{$image.urlPlaceholder(textColor='000000')}} // 'https://via.placeholder.com/769x743/68aa4c/000000.png?text=perspiciatis%20cubicularis%20libero'

{{$image.urlPlaceholder(format='png')}} // 'https://via.placeholder.com/883x687/7cfe8b/8390a0.png?text=porro%20tantillus%20curto'

{{$image.urlPlaceholder(text='lorem ipsum')}} // 'https://via.placeholder.com/1497x1095/4b7dd6/71cdf4.png?text=lorem%20ipsum'

{{$image.urlPlaceholder(width=128,height=128,backgroundColor='000000',textColor='000000',format='png',text='lorem ipsum')}} // 'https://via.placeholder.com/128x128/000000/000000.png?text=lorem%20ipsum'