iOSSegmentedControl(iOS分段控件)

大约 1 分钟

iOSSegmentedControl(iOS分段控件)

系统和版本要求

  • 系统版本：iOS 26.0+ 自动支持液态玻璃效果，低版本系统上使用标准UISegmentedControl外观。

  • Kuikly版本：2.5.0+

iOSSegmentedControl 是基于 iOS 原生 UISegmentedControl 实现的分段控件组件，在 iOS 26+ 系统上自动具备液态玻璃视觉效果。该组件提供了完整的原生分段选择功能，支持多选项切换、自定义标题和选择事件处理。

组件使用示例open in new window

基础用法

import com.tencent.kuikly.core.views.ios.SegmentedControlIOS

private var selectedIndex by observable(0)

SegmentedControlIOS {
    attr {
        height(40f)
        width(200f)
        titles(listOf("选项1", "选项2", "选项3"))
        selectedIndex(selectedIndex)
    }
    event {
        onValueChanged { params ->
            selectedIndex = params.index
            println("选中选项: ${params.index + 1}")
        }
    }
}

属性

iOSSegmentedControl 支持所有基础属性，还支持以下专有属性：

titles

设置分段控制器的标题数组。

参数描述类型默认值
titles分段标题列表List<String>空列表

示例

SegmentedControlIOS {
    attr {
        titles(listOf("全部", "进行中", "已完成"))
    }
}

selectedIndex

设置当前选中的分段索引。

参数描述类型默认值
index选中索引（0-based）Int0

示例

SegmentedControlIOS {
    attr {
        selectedIndex(1) // 选中第二个选项
    }
}

事件

onValueChanged

分段选择变化时触发的事件。

ValueChangedParams

参数描述类型
index当前选中索引Int

相关组件