本页目录

背景、裁剪与滤镜

需要给卡片加背景、裁剪头像或迁移网页上的遮罩图标时,可按用途查阅下表。裁剪、滤镜和遮罩的效果应使用实际素材在目标 App 中验证。

想做什么Nova 写法需要注意
卡片背景、圆角和静态阴影background-color、border、border-radius、box-shadow需要裁剪子内容时给容器设置 overflow: hidden。地图、视频等原生组件的边框和裁剪效果请在目标 App 验证。
背景图与渐变background-image: url(...) 或 linear-gradient(...),按需配合 background-size、background-position图片加载失败时检查资源路径。如果用渐变表达进度,确保标签或数字也能表达状态。
图片等比缩放在小程序 image 上用 mode="aspectFit" 或 mode="aspectFill"浏览器的 object-fit 写法不适用。前者完整显示,后者铺满容器并可能裁掉边缘。
按形状裁剪clip-path 可使用 circle()、ellipse()、inset() 或 path()polygon() 不支持。固定形状可用 SVG 或预裁剪素材替代。
给单色位图着色在支持遮罩的目标 App 中用 mask-image: url(...) 配合背景色遮罩用 PNG、WebP 或渐变。页面样式表会移除可识别的 SVG 遮罩声明和 mask-composite。单独显示 SVG 可以用 svg-render,普通的 SVG 背景图不受这条遮罩规则影响。
模糊或调色filter 支持单个 blur()、grayscale()、brightness()、contrast() 或 saturate()blur() 用长度,其他滤镜用数字或百分比。每个节点用一种滤镜。drop-shadow() 和 backdrop-filter 不适用。

头像裁剪

头像容器有固定尺寸时,可以用圆角裁剪,再让图片通过 aspectFill 填满容器。

Ray

import { Image, View } from '@ray-js/ray';

export function Avatar({ avatarUrl }: { avatarUrl: string }) {
  return (
    <View className="avatar">
      <Image className="avatar-image" src={avatarUrl} mode="aspectFill" />
    </View>
  );
}

原生小程序

<view class="avatar">
  <image class="avatar-image" src="{{avatarUrl}}" mode="aspectFill" />
</view>
.avatar {
  width: 88rpx;
  height: 88rpx;
  border-radius: 50%;
  overflow: hidden;
}

.avatar-image {
  width: 100%;
  height: 100%;
}

如需在弹层背景实现毛玻璃,可以先使用半透明背景色,确保文字和操作按钮有足够的对比度。

从 WebView 迁移旧遮罩样式时,可以保留受支持的 -webkit-mask-image、-webkit-mask-size、-webkit-mask-position 和 -webkit-mask-repeat 声明。Nova 页面样式表会按对应的无前缀属性处理,取值仍需符合 Nova 的支持范围。