跳至主要內容
版本: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
類型字串 | 未定義
預設值未定義

disabled

描述如果為 true,則使用者無法與分段按鈕互動。
屬性disabled
類型布林值
預設值false

layout

描述設定分段中文字和圖示的版面配置。
屬性layout
類型"icon-bottom" | "icon-end" | "icon-hide" | "icon-start" | "icon-top" | "label-hide" | 未定義
預設值'icon-top'

mode

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

type

描述按鈕的類型。
屬性type
類型"button" | "reset" | "submit"
預設值'button'

value

描述分段按鈕的值。
屬性value
類型數字 | 字串
預設值'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區段按鈕的過渡效果

插槽

此元件沒有可用的插槽。