跳到主要内容
版本:v8

ion-picker

shadow

Picker 显示一个或多个列,其中包含供用户选择的选项。

前缀和后缀内容

使用 prefixsuffix 插槽向选择器添加额外内容。

主题

CSS 变量

选择器的高亮和淡入淡出效果可以使用 ion-picker 上的 CSS 变量进行自定义。开发者可以通过直接定位 ion-picker-column-options 并使用宿主级别样式来自定义其单独外观。

在 Modal 中使用 Picker

Picker 可以显示在覆盖层(如 ion-modal)内部,以创建带有确认或取消按钮的选择器体验。

控制台
控制台消息将在上方示例中调用 console.log 时显示在此处。

无障碍

屏幕阅读器

Picker 通过在每个 Picker Column 上实现 slider 角色来支持使用屏幕阅读器进行导航。以下手势可用于导航 Picker。

手势功能
向左滑动将焦点移动到上一个 Picker Column。
向右滑动将焦点移动到下一个 Picker Column。
向上滑动在 Picker Column 中选择下一个选项。
向下滑动在 Picker Column 中选择上一个选项。
双击并上下滑动调整 Picker Column 中所选选项。可替代上下滑动使用。
警告

向上滑动和向下滑动手势依赖于如 slider 文档所述的正确合成按键事件。基于 Chromium 的浏览器无法正确合成键盘事件,但在 Chromium 浏览器实现此功能之前,可以使用"双击并上下滑动"手势作为替代方案。

键盘交互

每个 Picker Column 在聚焦时可以使用键盘进行导航。

描述
ArrowUp滚动到上一个选项。
ArrowDown滚动到下一个选项。
PageUp向上滚动多个选项。
PageDown向下滚动多个选项。
Home滚动到第一个选项。
End滚动到最后一个选项。

属性

mode

说明The mode determines which platform styles to use.

这是一个虚拟属性,在初始化时设置一次,之后更改其值不会更新组件。
属性mode
类型"ios" | "md"
默认值undefined

事件

该组件没有可用的事件。

方法

该组件没有可用的公共方法。

CSS Shadow Parts

该组件没有可用的 CSS 阴影部分。

CSS 自定义属性

Name说明
--fade-background-rgbBackground of the gradient covering non-selected items in rgb format
--highlight-backgroundBackground of the picker highlight for the selected item
--highlight-border-radiusBorder radius of the picker highlight for the selected item

插槽

该组件没有可用的插槽。