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 同时控制尺寸、背景、渐变、前景和标签。