已知问题¶
以下问题可能导致页面效果与浏览器不同。实际表现可能因平台、显示缩放和页面布局而异;发布前请在目标平台检查界面。
Markup UI 使用 Blitz 解析 HTML。涉及 Blitz 的渲染问题需要等待上游修复,修复后还需更新并验证 Markup UI。
细边框可能缺失¶
在 Windows 显示缩放为 125% 或 150% 的部分布局中,圆角面板或输入框的 1px 边框可能缺少某一边。
.panel {
border: 1px solid #55b7ff;
border-radius: 12px;
}
检查不同显示缩放下的效果;需要时可尝试较粗的边框。相关上游问题:#837。
三维变换可能不生效¶
rotateX()、rotateY() 和透视效果可能无法按预期显示。将二维变换与三维旋转写在同一个 transform 中时,整个变换也可能失效。
.card {
transform: translate(30px, -10px) rotateY(42deg);
}
需要稳定显示时,可优先使用二维变换并在目标平台验证。该问题在 Windows 的页面中观察到,其他平台的表现尚未确认。
圆角与图片裁剪可能不一致¶
图片尺寸大于容器、并通过负外边距调整位置时,overflow: hidden 配合 border-radius 可能无法按预期裁剪图片,图片位置和右侧圆角也可能与浏览器不同。
.frame {
overflow: hidden;
border-radius: 16px;
}
.frame img {
width: 240px;
margin-left: -20px;
}
请检查实际页面中的图片位置和四个圆角。该现象在特定预览环境中观察到,平台间表现可能不同。
圆角背景模糊可能超出边界¶
同时使用 border-radius 和 backdrop-filter 时,背景模糊可能显示在圆角外侧的矩形区域。
.glass {
border-radius: 24px;
backdrop-filter: blur(12px);
}
该现象在特定预览环境中观察到;使用背景模糊时请在目标平台检查边缘效果。
渐变颜色空间可能不生效¶
使用 in oklab 或 in srgb-linear 指定渐变插值颜色空间时,结果可能与浏览器不同,两种写法也可能显示为相近效果。
.panel {
background: linear-gradient(90deg in oklab, red, blue);
}
如果颜色过渡对界面设计有重要影响,请在目标平台核对效果。该现象在特定预览环境中观察到。
SVG 显示限制¶
SVG 背景重复¶
SVG 用作 CSS 背景时,background-repeat: repeat 可能只显示一张图片,而不是平铺:
.pattern {
background-image: url("pattern.svg");
background-size: 40px 40px;
background-repeat: repeat;
}
可以考虑使用位图背景并在目标平台验证。此问题在特定预览环境中观察到;Unreal Engine 中外部 SVG 资产的使用范围另见图片与字体。
内联 SVG 描边¶
通过外部 CSS 为内联 SVG 的父元素指定 stroke 等样式时,子路径可能不显示。
.icon {
fill: none;
stroke: white;
stroke-width: 2;
}
<svg class="icon" viewBox="0 0 24 24">
<path d="M2 12H22"></path>
</svg>
如果描边内容不可见,请在目标平台检查 SVG 的显示效果。该现象在特定预览环境中观察到。
圆形粗描边¶
SVG 圆形的描边宽度超过直径时,中心可能出现小孔:
<svg viewBox="0 0 120 120">
<circle cx="60" cy="60" r="12" fill="none"
stroke="#ef8354" stroke-width="32"></circle>
</svg>
若需要实心圆,优先使用填充而非粗描边,并检查目标平台显示效果。