IndexBar

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 索引字符列表,默认为 A-Z 加 # 共 27 个字符

onSelect

(Char) -> Unit 用户滑动或点击选中某个索引字符时的回调

touchColor

Color 触摸索引栏时的背景高亮色,默认为 AppColor.Neutral.card

charText

@Composable (String) -> Unit 每个索引字符的自定义渲染插槽,默认使用 DefaultIndexBarCharText

selectText

@Composable BoxScope.(String) -> Unit 选中字符时屏幕中央的提示文本渲染插槽,默认使用 DefaultIndexBarSelectText

content

@Composable BoxScope.() -> Unit 主体内容区域,通常放置可滚动的列表