跳到主要內容
版本:v8

ion-picker

陰影

Picker 會顯示一個或多個包含選項的欄,供使用者選擇。

前綴和後綴內容

使用 prefixsuffix 插槽將其他內容新增至選擇器。

主題

CSS 變數

可以使用 ion-picker 上的 CSS 變數自訂選擇器醒目提示和淡化。開發人員可以藉由直接設定 ion-picker-column-options 的樣式並使用主機層級樣式來自訂其個別外觀。

模式視窗中的選擇器

選擇器可以顯示在覆蓋層內,例如 ion-modal,以建立具有確認或取消按鈕的選擇器體驗。

主控台
從以上範例記錄時,主控台訊息會顯示在這裡。

協助工具

螢幕閱讀器

選擇器透過在每個 Picker 欄 上實作 slider 角色來支援使用螢幕閱讀器進行導覽。下列手勢可用來導覽選擇器。

手勢功能
向左滑動將焦點移至上一個選擇器欄。
向右滑動將焦點移至下一個選擇器欄。
向上滑動選取選擇器欄中的下一個選項。
向下滑動選取選擇器欄中的上一個選項。
點擊兩下並向上/向下滑動調整選擇器欄中選取的選項。可以做為向上和向下滑動的替代方式。
注意

向上滑動和向下滑動手勢依賴於正確的鍵盤事件合成,如 slider 文件中所述。以 Chromium 為基礎的瀏覽器無法正確合成鍵盤事件,但在以 Chromium 為基礎的瀏覽器中實作之前,「點擊兩下並向上/向下滑動」手勢可以用作替代方式。

鍵盤互動

當有焦點時,可以使用鍵盤導覽每個 Picker 欄

按鍵描述
ArrowUp捲動至上一個選項。
ArrowDown捲動至下一個選項。
PageUp向上捲動超過一個選項。
PageDown向下捲動超過一個選項。
Home捲動至第一個選項。
End捲動至最後一個選項。

屬性

模式

描述模式決定要使用哪個平台樣式。
屬性模式
類型"ios" | "md"
預設值未定義

事件

此元件沒有可用的事件。

方法

此元件沒有可用的公用方法。

CSS 陰影部分

此元件沒有可用的 CSS 陰影部分。

CSS 自訂屬性

名稱描述
--fade-background-rgb以 rgb 格式顯示涵蓋非選取項目的漸層背景
--highlight-background選取項目之選擇器醒目提示的背景
--highlight-border-radius選取項目之選擇器醒目提示的邊框半徑

插槽

此元件沒有可用的插槽。