Figma 渐变透明遮罩(Alpha Mask)、滚动边缘羽化(Edge Feathering)与 CSS mask-image 工程化交付实战:告别深色模式假渐变色块、非破坏性图片融合与滚动态渐隐避坑指南
在横向滚动的标签栏、长列表底部、品牌 Logo 跑马灯或背景氛围插画边缘,设计师经常希望内容能向四周“平滑消隐”。很多新手在 Figma 图层填充 中顺手拉一个“从 100% #FFFFFF 到 0% #FFFFFF”的线性渐变矩形叠在内容最上方——视觉上在纯白画布里确实看不出破绽。
然而这种**“假渐变遮罩(Fake Solid Overlay)”一旦进入工程化落地就会立刻暴雷:当页面切换到 Dark Mode 深色模式、容器背景改为毛玻璃材质或渐变色底纹时,那个写死纯白颜色的遮罩层就会变成一块刺眼的“白色雾霾补丁”,更糟糕的是它还会拦截下层按钮与卡片的鼠标点击事件。要做到真正透明穿透、背景无关且适配双端暗黑模式**,必须回归 Figma 原生的 Alpha 透明蒙版(Alpha Mask) 与前端标准的 CSS mask-image 工程体系。
一、Figma 三大边缘渐隐与蒙版方案对比 #
在动手改造组件前,先对照下表区分三种常见遮罩机制的底层原理与工程适用性(基础操作见 蒙版工具指南):
| 遮罩方案 | 遮罩判定通道 | 是否依赖底色(深浅色兼容) | 原型滚动容器兼容度 | 前端对应实现与工程评价 |
|---|---|---|---|---|
| 1. 同色实底渐变叠加(Fake Overlay) | 无(仅视觉覆盖) | 极差(换底色/暗黑模式即现白块,需维护多套变量) | 高(可 Fixed 盖在滚动容器上方) | 对应覆盖伪元素 ::after + pointer-events: none;仅限纯色固定背景临时兜底 |
| 2. Alpha 透明蒙版(Alpha Mask) | 读取蒙版图层的 Opacity 不透明度通道 | 极佳(真实挖空像素,透出任意动态背景) | 需搭配外层 Mask 组嵌套内部滚动 Frame | 最推荐 UI 工程化方案;直接对应原生 CSS mask-image: linear-gradient(...) |
| 3. Luminance 亮度蒙版(Luminance Mask) | 读取蒙版图层的 RGB 明度值(白显黑隐) | 极佳(适合导入灰度图/黑白噪点贴图做纹理融图) | 同上,且无需提前抠去白底像素 | 对应 CSS mask-mode: luminance(部分老旧浏览器或 SVG 导出兼容不如 Alpha 稳健) |
选型原则:凡是横向标签栏、跑马灯、弹窗长列表、头像叠层等 UI 组件的边缘羽化,一律使用 Alpha Mask;仅当需要使用黑白灰度摄影贴图或笔刷噪点图融合照片时,才选用 Luminance Mask(更多几何与矢量遮罩算法对比见 Figma 蒙版与布尔运算深度实战)。
二、实操一:在 Figma 中搭建真正的 Alpha 边缘羽化蒙版 #
以最常用的“横向滚动标签栏左右双侧渐隐”或“Hero 大图底部融入任意背景”为例,在 Figma 中按以下四步构建零背景依赖的真透明渐隐:
- 绘制蒙版形状并显式切换为 Alpha 模式:
- 在目标内容图层正下方绘制一个与显示区域等宽高的矩形(
Mask_Gradient)。 - 选中该矩形和需要被遮罩的内容,点击顶部工具栏 Use as mask(快捷键
Ctrl + ⌘ + M/Ctrl + Alt + M)生成 Mask Group。 - 关键一步:选中左侧图层树中的蒙版图层(带向上箭头标记),在右侧属性面板
Mask区域将默认的Vector切换为Alpha。若保持在Vector模式,Figma 只看轮廓外框,渐变透明停点会完全失效!
- 在目标内容图层正下方绘制一个与显示区域等宽高的矩形(
- 配置两端透明停点(Alpha Stops):
- 选中
Mask_Gradient的填充,将类型改为 Linear Gradient(线性渐变),色值统一设为纯黑#000000(Alpha 模式下 RGB 颜色无任何影响,只读取透明度)。 - 若做“双侧边缘渐隐”(如左右各
32px羽化):将渐变方向拉为水平,设置 4 个停点——0%处透明度0%、8%处透明度100%、92%处透明度100%、100%处透明度0%。
- 选中
- 验证深浅色背景与纹理穿透:
- 将整个 Mask Group 拖放到浅灰卡片、深黑夜览画布或弥散渐变背景上,观察边缘是否自然消融且没有任何白边/黑边杂色。若出现轻微灰边,检查被遮罩图层是否多加了
Drop Shadow(阴影建议加在 Mask Group 外层而非内部被裁切)。
- 将整个 Mask Group 拖放到浅灰卡片、深黑夜览画布或弥散渐变背景上,观察边缘是否自然消融且没有任何白边/黑边杂色。若出现轻微灰边,检查被遮罩图层是否多加了
- 解决 Mask Group 无法直接开启 Auto Layout 的结构限制:
- Figma 的 Mask Group 本身不支持直接开启自动布局。工程化组件中,应当在 Mask Group 外层再套一层 Auto Layout Frame,并将内部
Mask_Gradient与内容区同时设为Constraints: Left and Right / Top and Bottom(或放进普通非 Auto Layout 容器中居中自适应),确保父容器拉伸时羽化比例同步跟随。
- Figma 的 Mask Group 本身不支持直接开启自动布局。工程化组件中,应当在 Mask Group 外层再套一层 Auto Layout Frame,并将内部
三、实操二:滚动列表动态渐隐原型与点击防劫持 #
如果在 原型溢出滚动 中直接给内部滚动列表加静态 Alpha Mask,就会发生“蒙版跟着列表一起滚走”的尴尬。想让列表内容在原地滚动、而边缘羽化窗口稳如泰山,正确层级结构如下:
Scroll_Fade_Viewport (Ordinary Frame, Fixed Width)
├── Mask_Window (Alpha Mask, Constraints: Left & Right + Top & Bottom)
└── Scroll_Track (Auto Layout Frame, Overflow: Vertical/Horizontal Scrolling)
├── Item_01
├── Item_02
└── ...
- 外框负责“固定窗口羽化”,内框负责“内容滚动”:务必把
Overflow scrolling开启在 Mask Group 内部 的Scroll_Track上,而不是外层Scroll_Fade_Viewport;同时将Mask_Window置于Scroll_Track下方并设为Alpha Mask。 - 老方案“实色覆盖”的原型点击修复:若某些历史项目临时仍使用顶部叠层做过渡提示,务必在对应图层命名中标注
pointer-events: none并避免把交互热区完全盖死(底层点击劫持排查详见 原型点击无反应深度排障)。
四、工程化交付:CSS mask-image 与多向羽化生产代码 #
在 Dev Mode 开发模式 交付时,切勿让前端按照普通 background: linear-gradient(...) 去拼一个遮挡层!设计师应在 Annotation 批注中明确标注渐隐起止像素(例如 fade-edge: 32px),由前端直接采用原生 mask-image 一步到位:
/* 1. 横向滚动标签栏:左右各 32px 真透明羽化(完美兼容任意背景与 Dark Mode) */
.scroll-tabs-mask {
overflow-x: auto;
/* 使用像素精确锁死羽化宽度,不随列表总宽变形 */
-webkit-mask-image: linear-gradient(
to right,
transparent 0,
#000 32px,
#000 calc(100% - 32px),
transparent 100%
);
mask-image: linear-gradient(
to right,
transparent 0,
#000 32px,
#000 calc(100% - 32px),
transparent 100%
);
}
/* 2. 双向(上下 + 左右)同时羽化:基于 mask-composite 交集合成 */
.card-media-vignette {
-webkit-mask-image:
linear-gradient(to right, transparent, #000 12%, #000 88%, transparent),
linear-gradient(to bottom, transparent, #000 10%, #000 85%, transparent);
-webkit-mask-composite: source-in; /* Safari/WebKit 旧语法交集 */
mask-image:
linear-gradient(to right, transparent, #000 12%, #000 88%, transparent),
linear-gradient(to bottom, transparent, #000 10%, #000 85%, transparent);
mask-composite: intersect; /* 标准语法交集,保留同时不透明的区域 */
}
性能与可访问性提醒:CSS
mask-image本质上完全不阻挡元素内部的子节点点击、文本选中与无障碍聚焦,比伪元素叠加更加干净;若列表滚动到最左端或最右端需要动态取消对应侧的渐隐,只需配合scrollLeft切换.is-at-start/.is-at-end类名动态调整首个停点为#000 0即可。
五、Alpha Mask 导出与线上还原高频避坑表 #
如果图片或图标的透明羽化需要通过 资产导出 直接出图交付,遇到边缘黑边、SVG 体积暴涨或 Safari 不生效时,可对照下表快速定位修复(更多综合导出排查参见 Figma 常见报错与疑难故障诊断手册):
| 异常表现 | 底层成因剖析 | 标准化解决步骤 |
|---|---|---|
Figma 设了渐变矩形 Use as mask,但画面还是硬切一刀没有羽化 | 蒙版模式停留在默认的 Vector(矢量轮廓),忽略了填充中的透明度通道 | 选中带箭头标记的蒙版图层,在右侧属性面板将蒙版类型由 Vector 显式切换为 Alpha |
| 带 Alpha Mask 的插画导出 SVG 后,文件暴涨几百 KB 或在部分软件不透明 | 原生 SVG <mask> 对复杂透明渐变或嵌套高斯模糊支持极不稳定,Figma 会触发光栅化降级或生成复杂滤镜 | 渐变羽化位图请直接导出 PNG / WebP;纯网页装饰大图则只导出原图,羽化效果交给前端 mask-image |
| 导出带有边缘渐隐的 PNG 贴图后,暗部半透明边缘出现一圈微弱白边(Fringe) | 导出前画布内蒙版或底层图使用了纯白底色图层进行预合成(Premultiplied Alpha 杂边) | 确保被遮罩元素自身背景透明无底板,并在导出前关闭最外层容器的填充色再导出 32-bit 透明 PNG |
前端按 Figma 标注写了双向 mask-image,但在 iOS Safari 里整个元素直接消失 | mask-composite 在标准浏览器用 intersect,而带 -webkit- 前缀的旧版 WebKit 需要写为 source-in | 如上文代码所示,同时声明 -webkit-mask-composite: source-in; 与标准 mask-composite: intersect; |
| 深色模式下局部渐变遮罩失效,依然透出白色雾感 | 设计稿混用了同色渐变叠加(Fake Overlay)且未绑定 Variables 变量,或前端用错了硬编码色值 | 彻底废弃实底渐变矩形覆盖法,设计稿统一改用 Alpha Mask,前端统一切换为 mask-image 真透明裁剪 |
核心手册与速查工具
高频手册与实用设计生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南完全不需要。绝大多数核心功能在免费 Starter 计划中均可完整体验与实操练习,无需额外付费购买付费团队版。