HyperList

• 包名：hyper_ui
• 源码：library/src/main/java/hyper_ui/components/list/HyperList.kt
• 状态归属：调用方提供列表数据
• Preview ID：hyper_list

基于 Column 与 verticalScroll 的非懒加载列表，一次组合全部项目，适合数量较少的静态数据。

公开签名

@Composable
fun <T> HyperList(
    items: List<T>,
    modifier: Modifier = Modifier,
    contentPadding: PaddingValues = PaddingValues(0.dp),
    verticalArrangement: Arrangement.Vertical = Arrangement.spacedBy(0.dp),
    itemContent: @Composable (item: T) -> Unit
)

参数

参数	类型	默认值	说明
items	List<T>	必填	一次性渲染的数据
modifier	Modifier	Modifier	根 Column 修饰符
contentPadding	PaddingValues	PaddingValues(0.dp)	滚动内容内边距
verticalArrangement	Arrangement.Vertical	间距 0.dp	条目纵向排列
itemContent	@Composable (T) -> Unit	必填	每项内容

最小用法

@Composable
fun StaticOptions(options: List<String>) {
    HyperList(items = options) { option ->
        HyperListItem(
            title = option,
            onClick = { /* 由调用方处理 */ }
        )
    }
}

约束

• 组件内部自带纵向滚动；放入另一个同方向无界滚动容器前，应明确尺寸约束。
• 项目较多时改用 HyperLazyList，避免一次组合所有内容。
• 与 HyperLazyList 一样，首尾圆角和卡片背景由列表处理。

交互预览

HyperList 交互预览 在新窗口打开