跳至主要内容
版本: v8

ion-segment-button

阴影

分段按钮是 分段 内相关按钮的组。它们以水平行显示。通过将分段的 value 设置为分段按钮的 value,可以默认选择一个分段按钮。一次只能选择一个分段按钮。

基本用法

布局

默认情况下,layout 属性设置为 "icon-top"。当分段按钮同时具有图标和标签时,它将显示图标在标签之上。可以通过将 layout 属性设置为 "icon-bottom""icon-start""icon-end" 来更改此行为,这将分别显示图标在标签下方、标签的开始位置(LTR 中为左侧,RTL 中为右侧)或标签的末尾位置(LTR 中为右侧,RTL 中为左侧)。

主题

CSS 阴影部分

CSS 自定义属性

属性

contentId

描述分段内容的 id
属性content-id
类型string | undefined
默认值undefined

disabled

描述如果为 true,用户将无法与分段按钮交互。
属性disabled
类型boolean
默认值false

layout

描述设置分段中文本和图标的布局。
属性layout
类型"icon-bottom" | "icon-end" | "icon-hide" | "icon-start" | "icon-top" | "label-hide" | undefined
默认值'icon-top'

mode

描述模式决定使用哪个平台样式。
属性mode
类型"ios" | "md"
默认值undefined

type

描述按钮的类型。
属性type
类型"button" | "reset" | "submit"
默认值'button'

value

描述分段按钮的值。
属性value
类型number | string
默认值'ion-sb-' + ids++

事件

此组件没有可用事件。

方法

此组件没有公开可用方法。

CSS 阴影部分

名称描述
indicator在选中的分段按钮上显示的指示器。
indicator-background在选中的分段按钮上显示的指示器的背景元素。
native包含所有子元素的原生 HTML 按钮元素。

CSS 自定义属性

名称描述
--background分段按钮的背景
--background-checked选中的分段按钮的背景
--background-focused使用 Tab 键聚焦时分段按钮的背景
--background-focused-opacity使用 Tab 键聚焦时分段按钮背景的不透明度
--background-hover悬停时分段按钮的背景
--background-hover-opacity悬停时分段按钮背景的不透明度
--border-color分段按钮边框的颜色
--border-radius分段按钮边框的半径
--border-style分段按钮边框的样式
--border-width分段按钮边框的宽度
--color分段按钮的颜色
--color-checked选中的分段按钮的颜色
--color-focused使用 Tab 键聚焦时分段按钮的颜色
--color-hover悬停时分段按钮的颜色
--indicator-box-shadow选中分段按钮的指示器的盒子阴影
--indicator-color选中分段按钮的指示器的颜色
--indicator-height选中分段按钮的指示器的高度
--indicator-transform选中分段按钮的指示器的变换
--indicator-transition选中分段按钮的指示器的过渡
--margin-bottom分段按钮的下边距
--margin-end如果方向为从左到右,则为分段按钮的右边距,如果方向为从右到左,则为左边距
--margin-start如果方向为从左到右,则为分段按钮的左边距,如果方向为从右到左,则为右边距
--margin-top分段按钮的上边距
--padding-bottom分段按钮的下填充
--padding-end如果方向为从左到右,则为分段按钮的右填充,如果方向为从右到左,则为左填充
--padding-start如果方向为从左到右,则为分段按钮的左填充,如果方向为从右到左,则为右填充
--padding-top分段按钮的上填充
--transition分段按钮的过渡

插槽

此组件没有可用插槽。