Placeholder pics 的颜色、渐变与标签自定义写法

Placeholder pics 通过 URL 路径传参,支持背景色、渐变、前景文字/边框色和文字标签四类自定义。颜色用 3 位或 6 位十六进制色值,渐变用两个色值加短横线连接,标签放在 URL 最后且必须位于颜色参数之后。所有图片以 SVG 形式返回,尺寸由 URL 中的宽高决定。

URL 基本结构

图片 URL 必须以 /svg/ 开头,各段按固定顺序拼接:

/svg/WIDTHxHEIGHT/BACKGROUND/FOREGROUND/LABEL
  • 只写一个尺寸时生成正方形,例如 /svg/100 返回 100×100 像素的 SVG。
  • 宽高用 WIDTHxHEIGHT 表示,如 /svg/100x100。
  • 后面的背景、前景、标签都是可选项,但顺序不能颠倒。

背景色与渐变

背景色支持两种写法:

写法 格式 示例
单色 3 位或 6 位十六进制 /svg/100x100/888888
渐变 起始色-结束色 /svg/100x100/888888-EEEEEE

渐变通过 START-STOP 两个色值用短横线连接实现,起始色在前、结束色在后。

前景文字与边框颜色

前景色控制图片中的文字和边框,写法有两种:

  • 单色:一个 3 位或 6 位十六进制色值,同时作用于文字和边框。
  • 双色:TEXT-BORDER,文字色在前、边框色在后,用短横线分隔。

关键限制:必须先定义背景色,才能设置前景色。也就是说,前景色参数不能跳过背景色单独出现。

/svg/100x100/888888/EEE        # 背景 888888,前景 EEE
/svg/100x100/888888/EEE-000    # 文字 EEE,边框 000

标签

标签是 URL 的最后一段,用于在设计中标记图片用途。

  • 标签应简短,并考虑图片实际尺寸——图小的时候长标签会显示不下。
  • 使用标签时,前景色和背景色都必须先指定,标签只能放在颜色参数之后。
/svg/100x100/888888/EEE/My Label

参数顺序速查

位置 参数 是否必填 说明
1 /svg/ 必填 固定前缀
2 WIDTHxHEIGHT 必填 单值时生成正方形
3 背景色 可选 单色或 START-STOP 渐变
4 前景色 可选 需先有背景色;单色或 TEXT-BORDER
5 标签 可选 需先有前景和背景色;简短文字

常见卡点

  • 跳级设置:想加前景色却没写背景色,URL 无效。颜色参数必须从背景开始逐级往后。
  • 标签位置:把标签写在颜色前面不会生效,标签永远是最后一段。
  • 尺寸与标签长度:小尺寸图片配长标签会溢出,标签要按图片大小取舍。
  • 颜色位数:十六进制支持 3 位或 6 位,不要混用其他长度。

按上述顺序拼接,就能用一条 URL 同时控制尺寸、背景、渐变、前景和标签。

placeholder.pics
Placeholder pics is the lightest way to include placeholder images in your designs using Scalable Vector Graphics (SVG)