Index Bar
fun IndexBar(modifier: Modifier = Modifier, chars: List<Char> = "ABCDEFGHIJKLMNOPQRSTUVWXYZ#".toCharArray().asList(), onSelect: (Char) -> Unit = {}, touchColor: Color = AppColor.Neutral.card, charText: @Composable (String) -> Unit = {
DefaultIndexBarCharText(text = it)
}, selectText: @Composable BoxScope.(String) -> Unit = {
DefaultIndexBarSelectText(text = it)
}, content: @Composable BoxScope.() -> Unit)
索引栏
右侧字母索引导航组件,常用于联系人列表、城市选择等需要快速定位的长列表场景。 用户通过按下并滑动右侧字母栏可快速跳转到对应分组,触摸时屏幕中央会显示当前选中的字母提示。
Parameters
modifier
Modifier 应用于最外层 Box 容器的修饰符
chars
List
on Select
(Char) -> Unit 用户滑动或点击选中某个索引字符时的回调
touch Color
Color 触摸索引栏时的背景高亮色,默认为 AppColor.Neutral.card
char Text
@Composable (String) -> Unit 每个索引字符的自定义渲染插槽,默认使用 DefaultIndexBarCharText
select Text
@Composable BoxScope.(String) -> Unit 选中字符时屏幕中央的提示文本渲染插槽,默认使用 DefaultIndexBarSelectText
content
@Composable BoxScope.() -> Unit 主体内容区域,通常放置可滚动的列表