# cover-view
基礎(chǔ)庫 1.4.0 開始支持,低版本需做兼容處理。
微信 Windows 版:支持
微信 Mac 版:支持
微信 鴻蒙 OS 版:支持
渲染框架支持情況:Skyline (使用最新 Nightly 工具調(diào)試)、WebView
# 功能描述
覆蓋在原生組件之上的文本視圖。
可覆蓋的原生組件包括 map、video、canvas、camera、live-player、live-pusher
只支持嵌套 cover-view、cover-image,可在 cover-view 中使用 button。組件屬性的長度單位默認(rèn)為px,2.4.0起支持傳入單位(rpx/px)。
# 屬性說明
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 | 最低版本 |
|---|---|---|---|---|---|
| scroll-top | number/string | 否 | 設(shè)置頂部滾動偏移量,僅在設(shè)置了 overflow-y: scroll 成為滾動元素后生效 | 2.1.0 |
# Bug & Tip
tip: cover-view和cover-image的aria-role僅可設(shè)置為button,讀屏模式下才可以點(diǎn)擊,并朗讀出“按鈕”;為空時可以聚焦,但不可點(diǎn)擊tip: 基礎(chǔ)庫 2.2.4 起支持 touch 相關(guān)事件,也可使用 hover-class 設(shè)置點(diǎn)擊態(tài)tip: 基礎(chǔ)庫 2.1.0 起支持設(shè)置scalerotate的 css 樣式,包括 transition 動畫tip: 基礎(chǔ)庫 1.9.90 起cover-view支持overflow: scroll,但不支持動態(tài)更新overflowtip: 基礎(chǔ)庫 1.9.90 起最外層cover-view支持position: fixedtip: 基礎(chǔ)庫 1.9.0 起支持插在view等標(biāo)簽下。在此之前只可嵌套在原生組件map、video、canvas、camera內(nèi),避免嵌套在其他組件內(nèi)。tip: 基礎(chǔ)庫 1.6.0 起支持css transition動畫,transition-property只支持transform (translateX, translateY)與opacity。tip: 基礎(chǔ)庫 1.6.0 起支持css opacity。tip: 事件模型遵循冒泡模型,但不會冒泡到原生組件。tip: 文本建議都套上cover-view標(biāo)簽,避免排版錯誤。tip: 只支持基本的定位、布局、文本樣式。不支持設(shè)置單邊的border、background-image、shadow、overflow: visible等。tip: 建議子節(jié)點(diǎn)不要溢出父節(jié)點(diǎn)tip: 支持使用 z-index 控制層級tip: 默認(rèn)設(shè)置的樣式有:white-space: nowrap;line-height: 1.2;display: block;bug: 自定義組件嵌套cover-view時,自定義組件的 slot 及其父節(jié)點(diǎn)暫不支持通過 wx:if 控制顯隱,否則會導(dǎo)致cover-view不顯示