# picker-view
基礎(chǔ)庫 1.0.0 開始支持,低版本需做兼容處理。
微信 Windows 版:支持
微信 Mac 版:支持
微信 鴻蒙 OS 版:支持
渲染框架支持情況:Skyline (使用最新 Nightly 工具調(diào)試)、WebView
# 功能描述
嵌入頁面的滾動(dòng)選擇器。其中只可放置 picker-view-column組件,其它節(jié)點(diǎn)不會(huì)顯示。
目前滾動(dòng)過程中 bindpickstart、bindpickend 會(huì)被觸發(fā)多次,后續(xù) skyline 升級(jí)會(huì)修復(fù)該問題
# 通用屬性
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 | 最低版本 | |
|---|---|---|---|---|---|---|
| value | Array.<number> | 否 | 數(shù)組中的數(shù)字依次表示 picker-view 內(nèi)的 picker-view-column 選擇的第幾項(xiàng)(下標(biāo)從 0 開始),數(shù)字大于 picker-view-column 可選項(xiàng)長(zhǎng)度時(shí),選擇最后一項(xiàng)。 | 1.0.0 | ||
| mask-class | string | 否 | 設(shè)置蒙層的類名 | 1.5.0 | ||
| indicator-style | string | 否 | 設(shè)置選擇器中間選中框的樣式 | 1.0.0 | ||
| bindchange | eventhandle | 否 | 滾動(dòng)選擇時(shí)觸發(fā)change事件,event.detail = {value};value為數(shù)組,表示 picker-view 內(nèi)的 picker-view-column 當(dāng)前選擇的是第幾項(xiàng)(下標(biāo)從 0 開始) | 1.0.0 | ||
| bindpickstart | eventhandle | 否 | 當(dāng)滾動(dòng)選擇開始時(shí)候觸發(fā)事件 | 2.3.1 | ||
| bindpickend | eventhandle | 否 | 當(dāng)滾動(dòng)選擇結(jié)束時(shí)候觸發(fā)事件 | 2.3.1 |
# WebView 特有屬性
| 屬性 | 類型 | 默認(rèn)值 | 必填 | 說明 | 最低版本 | |
|---|---|---|---|---|---|---|
| indicator-class | string | 否 | 設(shè)置選擇器中間選中框的類名 | 1.1.0 | ||
| mask-style | string | 否 | 設(shè)置蒙層的樣式 | 1.5.0 | ||
| immediate-change | boolean | false | 否 | 是否在手指松開時(shí)立即觸發(fā) change 事件。若不開啟則會(huì)在滾動(dòng)動(dòng)畫結(jié)束后觸發(fā) change 事件。 | 2.21.1 |
# Bug & Tip
tip: 滾動(dòng)時(shí)在iOS自帶振動(dòng)反饋,可在系統(tǒng)設(shè)置 -> 聲音與觸感 -> 系統(tǒng)觸感反饋中關(guān)閉tip: indicator-style 屬性 skyline 從基礎(chǔ)庫 3.3.4 開始支持,目前支持height、border、background-color