SepSelect 选择器组件 v1.0.0

单选/多选 · 本地搜索/远程搜索 · 选项分组 · 键盘导航 · 清除按钮 · 禁用状态 · 校验状态 · 渲染到 body 防 overflow 裁剪 · 移动端自适应

1. 单选模式(single)

HTML 声明式标签 ↕
JS API 初始化

2. 多选模式(multiple)

HTML 声明式标签 ↕
JS API 初始化

3. 可搜索(showSearch)

HTML 声明式标签 ↕
JS API 初始化

4. 选项分组(options.children)

HTML 声明式标签 ↕
JS API 初始化

5. 状态(status)

HTML 声明式标签 ↕
JS API 初始化

6. native 模式(原生 select)

HTML 声明式标签
JS API 初始化

7. 高级特性(远程搜索 / 禁用选项 / 空内容 / loading / 自定义过滤)

远程搜索(remote + onSearch)
禁用选项(option.disabled)
自定义空内容 / loading
自定义过滤 / maxTagPlaceholder
事件回调(onChange / onDropdownVisibleChange)

8. Tooltip 配合(字段帮助 / 校验错误提示)

HTML 声明式标签 ↕
校验错误提示(error 类型,可关闭)

9. 动态操作(setOptions / setValue / setDisabled / setStatus)

JS API 初始化

10. 地址联动(省 / 市 / 区县 级联)

JS API 初始化(省份变化 → 联动城市;城市变化 → 联动区县)
当前选择:未选择
声明式标签($.link 状态驱动,options 绑定 state 自动联动)
当前选择:未选择
远程拉取(模拟接口异步加载,loading 提示)
当前选择:未选择

11. 字段映射与 i18n 过滤器(valueName / labelName)

接口返回原始数据时,通过 valueName / labelName 指定字段自动映射,无需手动 map。labelName 支持 | i18n 管道过滤器做多语言。
JS API 初始化
切换语言,观察 i18n 选项 label 自动更新:

13. 自定义模板(optionRender)

下拉面板行支持自定义 HTML 模板,与 tooltip title 一致:函数 / HTML 字符串 / #id 引用 / 纯文本。优先级:option.render > optionRender。
JS API 初始化

14. 自动化断言