Safari 15.4前不支持mask-image,仅支持url(#svg-mask)形式;需用内联SVG设maskUnits="userSpaceOnUse"、避免luminance、注意fill/opacity影响及ID引用失效。
mask-image 在 Chrome/Firefox 里正常,Safari 15.4 之前不支持
Safari 对
的支持长期滞后,尤其在 iOS 15.4 之前的系统中完全不识别该属性,即使写了也会静默失效。这不是写法问题,是引擎限制 —— WebKit 直到 Safari 15.4 才开始部分支持 CSS Masking Level 1,且仅限于
这种引用 SVG 的形式,纯 CSS 渐变或图片路径(如
)仍被忽略。
验证是否生效:检查 Safari 开发者工具的「Computed」面板,看
是否显示为
或灰色禁用状态
绕过方式:必须用内联 SVG 定义
,再通过
引用,不能用外部 SVG 文件或 base64
注意 ID 作用域:SVG
必须和目标元素在同一个 HTML 文档内(或同个 Shadow DOM),跨 iframe 或 CSS 模块加载会断开引用
用 SVG
实现圆角遮罩时,是关键默认情况下 SVG使用坐标系(0–1 范围),但 CSS 元素尺寸不确定时,这种相对坐标会导致遮罩错位或缩放异常。比如想给一个宽高不定的卡片加圆角遮罩,直接写在下会被压缩成极小区域。强制使用像素坐标:在标签上显式声明配套设置/:值需覆盖目标元素最大可能尺寸(例如设为),避免裁剪示例片段:mask-mode: alpha 和 luminance 在 Safari 中行为不一致Safari 对的解析和 Chrome/Firefox 不同:它只认(默认值),而把当作无效值降级处理,导致灰度图遮罩在 Safari 里变成全白或全黑 —— 尤其影响用 PNG 灰度图做遮罩的场景。使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更下载安全做法:统一用,并确保遮罩图像本身是带透明通道的 PNG(而非靠灰度值控制透明度)如果必须依赖亮度(比如用 JPG 做遮罩),改用 SVG预处理:在 SVG内嵌滤镜,把亮度转为 alpha避免在 CSS 里写,Safari 会忽略整条声明,连带后面的也可能失效SVG 遮罩元素的和会影响最终透明度很多人以为 SVG里只看形状,其实颜色的 alpha 值、、甚至父容器的都会参与计算 —— 这不是 bug,是规范定义的叠加逻辑,但容易被忽略。立即学习“前端免费学习笔记(深入)”;表示完全遮挡(alpha=0),表示完全显示(alpha=1),则产生半透效果如果设置了,即使,最终遮罩强度也只有 80%,内容会轻微“漏光”调试技巧:临时把 SVG提到页面可视区域,加上,直接观察遮罩图形是否按预期渲染实际项目里最常卡住的,是 Safari 中 SVG的 ID 引用失效 —— 看似代码没错,但因为 SVG 在里、或者用了包裹、又或者被 JS 动态插入后未触发重绘,都会让找不到目标。这种情况没有错误提示,只能靠手动把 SVG 放到底部并确保初始可见来排查。
mask-imagemask-image: url(#svg-mask)mask-image: linear-gradient(...)mask-imagenonemask-image: url(#my-mask)maskUnits="userSpaceOnUse"objectBoundingBoxobjectBoundingBoxmaskUnits="userSpaceOnUse"widthheightwidth="2000" height="2000"mask-modemask-mode: alphaluminancemask-mode: alphamask-mode: luminancemask-imagefillopacityfillopacityopacityfill="black"fill="white"fill="gray"opacity="0.8"fill="white"style="border:1px solid red"display: noneurl(#xxx)