cover-image

覆盖在原生组件之上的图片视图，可覆盖的原生组件同cover-view，支持嵌套在cover-view里。

cover-image 在uni-app x的app、web、微信小程序上，已废弃，使用 image 即可。

在其他小程序平台，某些原生组件（如map、canvas、video）不支持同层渲染，仍需要 cover-image 来覆盖。

兼容性

Web	微信小程序	Android	iOS
4.0	4.41	4.53	4.53

注意

app 端并不是在运行时实现了 cover-image 组件，仅仅是编译器把 cover-image 编译为了 image。运行时获取到的Dom仍然是UniImageElement。

属性

名称	类型	默认值	兼容性	描述
src	string(string.ImageURIString)	-	Web 微信小程序 Android iOS 4.0 4.41 4.53 4.53	图标路径，支持临时路径、网络地址（1.6.0起支持）。暂不支持base64格式。
referrer-policy	string	-	Web 微信小程序 Android iOS x 4.41 x x	(string) 格式固定为 https://servicewechat.com/{appid}/{version}/page-frame.html，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版、体验版以及审核版本，版本号为 devtools 表示为开发者工具，其余为正式版本；
合法值 兼容性 描述 origin Web 微信小程序 Android iOS x 4.41 x x no-referrer Web 微信小程序 Android iOS x 4.41 x x
@load	eventhandle	-	Web 微信小程序 Android iOS 4,0 4.41 4.53 4.53	-
@error	eventhandle	-	Web 微信小程序 Android iOS 4,0 4.41 4.53 4.53	-

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档