SoybeanUI 已更名为 VeanUI迁移指南包名迁移至 @vean/aria 与 @vean/ui，文档站迁至 veanui.com。本站将于 2026 年 11 月重定向，@soybeanjs 系列包将于 2027 年 4 月标记废弃。

SoybeanUI

v0.50.0

返回目录

组件详情入口

组件

@soybeanjs/ui

SListbox

Listbox

Listbox 属于组件分类。建议先看演示与用法，再对照 API 表格完成接入和样式调整。

先用快捷跳转面板找到概述、用法、演示和 API，再往下细读完整文档内容。

快速跳转

概述用法演示 API 更新日志

同分类组件

如果你在同一类交互里做组合，这些组件通常会一起出现。

更新日志

版本记录按发布版本分组，便于快速查看这个组件在不同版本里的实际变更。

v0.15.0

2026-04-26

对比版本

新功能

添加可清除的道具并加强模型值更改处理

范围: listbox作者: soybeanfe查看提交a686c

新功能

添加可清除的道具并加强模型值更改处理

范围: listbox作者: soybeanfe查看提交a686c

v0.8.0

2026-02-10

对比版本

修复

从按键事件处理程序中移除阻止默认设置

范围: listbox作者: soybeanjs查看提交cb095

修复

支持 ListboxVirtualizerProps 中的动态 estimateSize 函数

范围: listbox作者: soybeanjs查看提交751b6

v0.0.2

2025-11-18

对比版本

新功能

新增支持上下文、项目和虚拟化器的 Listbox 组件

范围: listbox作者: soybeanjs查看提交7ca24

新功能

增强 ListboxFilter 及其上下文功能，实现与 Input 的集成并改进主题样式

范围: listbox作者: soybeanjs查看提交a6634

修复

更新 tabindex 处理方式，并改进纵向和横向屏幕方向下的键盘导航

范围: listbox作者: soybeanjs查看提交15716

优化

将 DefinedValue 类型替换为字符串，以提高各列表框组件间的类型一致性

范围: listbox作者: soybeanjs查看提交221af

新功能

新增支持上下文、项目和虚拟化器的 Listbox 组件

范围: listbox作者: soybeanjs查看提交7ca24

新功能

增强 ListboxFilter 及其上下文功能，实现与 Input 的集成并改进主题样式

范围: listbox作者: soybeanjs查看提交a6634

修复

更新 tabindex 处理方式，并改进纵向和横向屏幕方向下的键盘导航

范围: listbox作者: soybeanjs查看提交15716

优化

将 DefinedValue 类型替换为字符串，以提高各列表框组件间的类型一致性

范围: listbox作者: soybeanjs查看提交221af