适合
Syntax
RESOURCE.Fit SPEC
Returns
images.ImageResource
按比例缩小图像以适应给定尺寸,同时保持其宽高比。您必须同时提供宽度和高度。
{{ with resources.Get "images/original.jpg" }}
{{ with .Fit "200x200" }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}
处理规范
处理规范是一个以空格分隔、不区分大小写的列表,可以按任意顺序包含以下内容之一:
- action
- 仅适用于
Process
方法。指定零或一个动作,其中可以是resize
、fit
、fill
或crop
。如果指定了动作,还必须提供尺寸。 - dimensions
- 在使用
Resize
方法时,提供宽度 或 高度,否则提供宽度 和 高度。详见 详情。 - anchor
- 与
Crop
和Fill
方法一起使用。指定零或一个锚点,其中可以是TopLeft
、Top
、TopRight
、Left
、Center
、Right
、BottomLeft
、Bottom
、BottomRight
或Smart
。默认值是Smart
。详见 详情。 - rotation
- 通常指定零或一个
r90
、r180
或r270
。还支持任意旋转角度。详见 详情。 - 目标格式
- 指定零或一个
gif
、jpeg
、png
、tiff
或webp
。详见 详情。 - 质量
- 适用于 JPEG 和 WebP 图像。可选择指定
qN
,其中N
是介于 [0, 100] 范围内的整数。默认值是75
。详见 详情。 - 提示
- 适用于 WebP 图像。指定零或一个
drawing
、icon
、photo
、picture
或text
。默认值是photo
。详见 详情。 - 背景色
- 当将透明度为 PNG 或 WebP 转换为不支持透明度的格式时,可以选择使用 3 位或 6 位十六进制颜色码指定背景色。默认值是
#ffffff
(白色)。详见 详情。 - 重采样滤波器
- 通常指定零或一个
Box
、Lanczos
、CatmullRom
、MitchellNetravali
、Linear
或NearestNeighbor
。还有其他可用的重采样滤波器。详见 详情。
示例
{{ with resources.Get "images/original.jpg" }}
{{ with .Fit "300x175 webp q85 lanczos" }}
<img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
{{ end }}
Original
Processed