ASAM UI
v1.0.0

数据组件

字典选择器 AsamDictSelect

在选择器上管理字典选项、重载和请求取消。

字典选择器 ​

在选择器上管理字典选项、重载和请求取消。

基础用法 ​

示例通过本地 provider 获取字典，支持模型更新、暂停与重载。所有请求都留在演示内部。

点击“读取当前标签”读取实例的只读 selectedLabel：空模型返回空字符串，选择后返回当前标签。 完整说明。

本地字典与生命周期

展开源码

本地创建与字典规范项 ​

allow-create 与 filterable 开启后，createOption(text) 同步返回完整 AsamOption<V, I>。 默认创建值为字符串；数字、布尔值或自定义 raw 必须提供类型一致的同步工厂。 示例包含独立 provider 初始化、完整实体工厂和来源接受同值项的对照。

本地创建、规范项与来源重置

展开源码

本地创建集合只属于当前组件，不写入字典 provider/cache，success 只含来源项。 同类型同值去重，字典同值规范项优先；已传给父组件的对象模型不会因刷新自动替换。

clearCreatedOptions() 只清空本地集合及基础文本 memo，不清空模型。相同字典刷新、 一般 epoch 更新与错误重试保留本地项；dictType、dictValueType、真实 dataSource 或 provider/scope 变化自动清空。清空模型仍由调用方另行更新 v-model。

数据来源与覆盖 ​

dictType 与 dataSource 只选一种；dataSource 使用 defineAsamDictSource 创建，不能再传 dictValueType。 完整说明。

单选值模式使用标量或 null；对象模式使用规范化 AsamOption。多选的数组与分隔字符串模式由 multiple、valueMode、multipleValueMode 联合约束；对象模式不能使用字符串存储。切换值策略时同时调整模型类型。

来源接管 options、loading 和远端查询；数据组件不开放基础选择器的 native 值模式。基础页中只使用与本组件公开分支兼容的能力。

生命周期、事件与实例 ​

active=false 暂停请求并保留上次成功数据；reload({ force: true }) 请求新数据，cancel() 取消当前请求。 完整说明。

immediate 控制初始化是否请求，active 控制请求是否启用。初始化和默认值以本页自动 API 的原始来源为准。

插槽与基础能力 ​

prefix、header、footer、empty、loading、tag、label 等插槽保留各自基础作用域；selectedLabel 为只读标签结果，focus/blur 用于焦点控制。虚拟选择器 default 插槽使用基础虚拟选项作用域。

本站继承关系 ​

  • 选择器：适用的基础展示、交互与公开 API。

本页数据来源、模型、事件和实例的覆盖规则优先；本站链接不扩大本组件公开契约。尺寸使用基础组件的 ASAM 尺寸规则，示例使用 default。

字典刷新与示例 Provider ​

强制重载会先调用 provider.dict.refresh，再重新读取字典。示例 provider 同时提供 get 和 refresh，并检查请求取消信号；使用固定字典数据，不连接真实后端。宿主接入时应在 refresh 中实现实际缓存更新。

选项和标签的完整展示 ​

完整示例在两个独立实例中演示按来源 raw.team 分组的 OptionGroup/Option 插槽、prefix/header/footer/loading/empty/label 和可删除 tag。 完整说明。

示例按钮可关闭或恢复标签折叠，将可见标签数量在 1 与 3 之间切换，并将多选数量上限在 3 与 0（不限数量）之间切换。展示设置不改变来源和已选模型；取消上限后可以选择第四项。恢复初始多选由调用方将模型设回 [1, 3, 4]，随后恢复上限，区别于用户删除标签触发的 remove-tag。

展示示例还逐次记录单选原始数字、多选原始数组的 update:modelValue/change，以及完整规范化选项的 success。可制造一次刷新失败，观察 error 的 kind/message 与旧选中值保留，再恢复；持有请求的取消不产生额外成功事件。每条记录保存独立载荷快照。

选项模板、标签折叠与加载插槽

展开源码

折叠标签提示可独立关闭和恢复；关闭提示仍保留折叠数量及模型。 完整说明。

芋道宿主桥接与生命周期 ​

完整示例从 @asam-ui/ui-yudao 导入实际 createYudaoProvider，并在独立子应用安装。 完整说明。

实际芋道桥接、共享确保与可选刷新

展开源码

点击“展示未提供 refresh 的桥接”会创建另一个独立子应用与本地宿主缓存。 完整说明。

完整芋道桥协议 ​

createYudaoProvider(bridge) 返回 AsamDataProvider；构造时只校验配置与保存宿主回调，不执行传输、字典读取或通知。 完整说明。

桥成员 约定
request 接收 AsamRequestConfig 和原 AsamRequestContext，返回 Promise 中的未知响应。
upload 原样转交上传配置、输入 File/附加表单数据及含 reportProgress 的上下文，返回 Promise 中的未知响应。
dict ensure 返回 Promise，get 同步读取宿主字典，refresh 可选并返回 Promise；读取与刷新按 scope/epoch/世代协调。
isErrorNotified 同步判断原始 cause 是否已由宿主通知，返回 boolean。
onError 接收 AsamDataError，通知归属由运行时协调；已通知的错误不重复提示。

adapter 不配置 Axios、凭据、端点、Pinia 或宿主缓存。 完整说明。

默认适配只展开一层自有 data。 完整说明。

yudao-bridge 完整 TS/JS 示例的“检查完整宿主桥”按钮实际验证构造无副作用、原请求上下文与载荷、上传 File/进度转交、一层响应与失败、分页歧义、宿主通知去重、13 种无效桥以及空桥。 完整说明。

上传数据协议与完整消费者 ​

yudao-bridge 的“展示上传数据协议”按钮在独立子应用中挂载两个真实资源上传入口，分别消费完整资源处理器和未知响应传输。File、Blob、传输响应、资源地址和进度均在本地示例中构造，示例 URL 不发网络请求。原字典与桥的运行时、缓存和检查按钮独立保留。

公开类型 数据约定
AsamUploadFormData 只读字段记录，每个字段为 string 或 Blob；File 是 Blob 的子类型。
AsamUploadInput 只读 file: File、fieldName: string、可选 data。字段名和附加表单数据由调用方提供。
AsamUploadedResource 只读 id、name、url、mimeType 字符串和 size 数字；处理器返回完整资源。
AsamUploadProgress 只读 loaded 数字和可选 total 数字。
AsamUploadContext 继承请求的 signal/requestId/scope/epoch，并提供 reportProgress(progress) 方法；该方法签名本身不是 readonly 回调属性。
AsamUploadHandler 接收输入和上传上下文，返回 Promise 中的完整资源。
AsamUploadRequestConfig 只读 URL、可选 post/put 方法及 params、必填同步 transform(response, input)；原响应为 unknown。
AsamUploadTransport 接收去掉 transform 的请求配置、输入及上传上下文，返回 Promise 中的 unknown，由调用方转换和校验。

类型只描述结构，不保证字符串非空、数值有限、地址安全或 Blob 的内容满足业务规则。 完整说明。

reportProgress 不直接提交模型。 完整说明。

取消会中止该上传上下文，已经取消或卸载的操作不能用迟到资源覆盖模型，也不能再发成功、错误或进度。示例可以持有两个来源的操作，取消后再完成，观察 signal 中止、模型保持为空和进度计数不增加。这里消费上传数据协议，不定义或验收上传入口的原生 file-list API。

完整 provider 数据能力 ​

provider 按需提供请求、上传、字典和数据适配能力；实际使用时必须配置对应能力。 完整说明。

provider 的静态只读引用不等于冻结宿主缓存、原始响应或方法内部状态；dict 的 get/refresh 方法签名也不是 readonly 方法引用。 完整说明。

局部请求错误插槽 ​

可选 error 插槽仅在当前请求错误存在时调用，接收只读 { error, stale, retry }。 完整说明。

retry 不接收参数，返回强制 reload 的 Promise，并遵守取消和卸载规则。 完整说明。

提供该插槽时，自有内容替换整个默认局部错误区；返回空内容也表示主动替换。 未提供时继续显示原错误文字、过期提示和默认重试按钮。无 error 的单独 stale 状态 不调用此插槽；empty、loading 和其他基础插槽继续使用原作用域。

以下完整 TS/JS 示例先制造失败，再等待插槽 retry 的返回结果；成功后可再次制造 更新失败，观察旧结果与模型保留。每次挂载使用独立子 app 和本地 provider。

局部错误定制、等待重试与过期恢复

展开源码

局部与全局浮层 ​

基础示例使用默认的全局挂载；局部挂载示例展示显式配置的 teleported 或 appendTo。先打开控件浮层，再观察其所在容器。挂载位置与控件值、请求协议互相独立。

API

属性 AsamDictSelectProps

属性名说明类型默认值
ariaLabel—string | undefined—
id—string | undefined—
effect—enum"light" | "dark"完整类型：(AsamDictSelectProps<V, I>)["effect"]—
popperClass—AsamSelectRuntimeProps["popperClass"]—
popperStyle—(AsamDictSelectProps<V, I>)["popperStyle"]—
fallbackPlacements—(AsamDictSelectProps<V, I>)["fallbackPlacements"]—
offset—number | undefined—
placement—enum"auto" | "auto-start" | "auto-end" | "top" | "bottom" | "right" | "left" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "right-start" | "right-end" | "left-start" | "left-end"完整类型：(AsamDictSelectProps<V, I>)["placement"]—
popperOptions—(AsamDictSelectProps<V, I>)["popperOptions"]—
showArrow—(AsamDictSelectProps<V, I>)["showArrow"]—
appendTo—(AsamDictSelectProps<V, I>)["appendTo"]—
persistent—(AsamDictSelectProps<V, I>)["persistent"]—
teleported—boolean | undefined—
disabled—boolean | undefined—
tabindex—(AsamDictSelectProps<V, I>)["tabindex"]—
size—enum"large" | "big" | "default" | "small"完整类型：AsamControlSize | undefined—
props—(AsamDictSelectProps<V, I>)["props"]—
name—string | undefined—
separator—string | undefined—
modelValue—V | null | undefined | AsamSelectOption<V, I> | null | undefined | readonly V[] | undefined | string | undefined | readonly AsamSelectOption<V, I>[] | undefined—
filterMethod—((query: string) => void) | undefined—
multiple—false | undefined | true—
valueMode—enum"value" | "object"完整类型："value" | undefined | "object"—
multipleValueMode—enum"array" | "string"完整类型：undefined | "array" | undefined | "string"—
emptyValues—unknown[] | undefined—
valueOnClear—(AsamDictSelectProps<V, I>)["valueOnClear"]—
validateEvent—(AsamDictSelectProps<V, I>)["validateEvent"]—
clearable—boolean | undefined—
automaticDropdown—boolean | undefined—
clearIcon—(AsamDictSelectProps<V, I>)["clearIcon"]—
placeholder—string | undefined—
autocomplete—string | undefined—
filterable—boolean | undefined—
allowCreate—boolean | undefined | false | undefined | true—
debounce—number | undefined—
loadingText—string | undefined—
noMatchText—string | undefined—
noDataText—string | undefined—
multipleLimit—number | undefined—
defaultFirstOption—boolean | undefined—
reserveKeyword—(AsamDictSelectProps<V, I>)["reserveKeyword"]—
valueKey—string | undefined—
collapseTags—boolean | undefined—
collapseTagsTooltip—boolean | undefined—
tagTooltip—(AsamDictSelectProps<V, I>)["tagTooltip"]—
maxCollapseTags—number | undefined—
fitInputWidth—boolean | undefined—
suffixIcon—(AsamDictSelectProps<V, I>)["suffixIcon"]—
tagType—enum"primary" | "success" | "danger" | "warning" | "info"完整类型：(AsamDictSelectProps<V, I>)["tagType"]—
tagEffect—enum"light" | "dark" | "plain"完整类型：(AsamDictSelectProps<V, I>)["tagEffect"]—
remoteShowSuffix—boolean | undefined—
immediate—boolean | undefined—
active—boolean | undefinedtrue
dataSource—AsamOptionsSource<V, I, "dict"> | undefinedundefined
dictType—undefined | stringundefined
dictValueType—enum"string" | "number" | "boolean"完整类型：AsamDictValueType | undefinedundefined
createOption—AsamCreateOption<V, I> | undefined—

事件 AsamSelectDataEmits

属性名说明类型默认值
clear—(AsamSelectDataEmits<V, I>)["clear"]—
focus—[event: FocusEvent]—
end-reached—[direction: AsamScrollbarDirection]—
error—[error: AsamDataError]—
blur—[event: FocusEvent]—
visible-change—[visible: boolean]—
remove-tag—[value: unknown]—
popup-scroll—[event: { scrollTop: number; scrollLeft: number; }]—
update:modelValue—[value: string | V | AsamOption<V, I> | readonly V[] | readonly AsamOption<V, I>[] | null]—
change—[value: string | V | AsamOption<V, I> | readonly V[] | readonly AsamOption<V, I>[] | null]—
success—[data: readonly AsamOption<V, I>[]]—

插槽 AsamAsyncSelectSlots

属性名说明类型默认值
default—(() => unknown) | undefined—
prefix—(() => unknown) | undefined—
header—(() => unknown) | undefined—
footer—(() => unknown) | undefined—
empty—(() => unknown) | undefined—
loading—(() => unknown) | undefined—
tag—
查看完整类型((scope: { data: AsamTreeSelectTagOption[]; selectDisabled: boolean; deleteTag: (event: MouseEvent, option: AsamTreeSelectTagOption) => void; }) => unknown) | undefined
—
label—((scope: { index: number; label: any; value: any; }) => unknown) | undefined—
error替换本地错误区域；重试返回现有强制重新加载的 Promise。(AsamAsyncSelectSlots<V, I>)["error"]—

实例方法与状态 AsamAsyncSelectExpose

属性名说明类型默认值
selectedLabel—string | string[]—
reload—(options?: { readonly force?: boolean; }) => Promise<AsamReloadResult<readonly AsamOption<V, I>[]>>—
cancel—() => void—
focus聚焦原生输入控件。() => void—
blur—() => void—
clearCreatedOptions仅在逻辑数据来源或作用域变化时重置本地创建项，不因搜索、刷新或错误重置。() => void—

用法与契约补充说明 ​

基础用法 ​

点击“读取当前标签”读取实例的只读 selectedLabel：空模型返回空字符串，选择后返回当前标签。focus() 与 blur() 为无参数方法，仅控制输入焦点，不改写模型；失焦按钮阻止鼠标按下时抢走焦点，以便观察 blur() 的实际作用。勾选“启用多选”切换到独立数组模型；空选择读取空数组，选择多个选项后返回标签数组，输入焦点方法仍不改写模型。

数据来源与覆盖 ​

dictType 与 dataSource 只选一种；dataSource 使用 defineAsamDictSource 创建，不能再传 dictValueType。短来源的 dictValueType 可将字典值转换为 string、number 或 boolean。应用通过 provideAsamData 注入 dict.get，演示在独立子应用中使用本地字典，切换语言或离开时卸载。

生命周期、事件与实例 ​

active=false 暂停请求并保留上次成功数据；reload({ force: true }) 请求新数据，cancel() 取消当前请求。success 返回规范化选项数组，error 返回 AsamDataError；旧成功数据更新失败时组件显示过期状态。reload 的 status 为 success、error 或 cancelled；不能把取消当作成功。

选项和标签的完整展示 ​

完整示例在两个独立实例中演示按来源 raw.team 分组的 OptionGroup/Option 插槽、prefix/header/footer/loading/empty/label 和可删除 tag。来源仍返回规范化的平面实体；分组仅组织 default 插槽中的原生选项，不改变来源与模型。多选使用原始数值数组，保留折叠标签提示、maxCollapseTags、multipleLimit 和 disabled；自定义 tag 通过原生 deleteTag 删除并触发 remove-tag，不直接改内部标签。完成请求按钮释放本地等待操作，便于观察真实 loading 与 empty 插槽；卸载时请求随独立子应用取消。普通选择器通过 popperStyle.minWidth=320px 设置弹层最小宽度。

选项和标签的完整展示 ​

折叠标签提示可独立关闭和恢复；关闭提示仍保留折叠数量及模型。弹层样式按钮演示 StyleValue 的对象、字符串、嵌套数组和 false/null/undefined 清空形式。示例最小宽度分别为 320、360、400px，清空后恢复原生宽度，切换展示设置不重新读取来源。数组样式恢复为对象时会清除之前的 maxWidth。

芋道宿主桥接与生命周期 ​

完整示例从 @asam-ui/ui-yudao 导入实际 createYudaoProvider，并在独立子应用安装。宿主拥有 ensure/get/refresh 与字典缓存，ASAM 只协调同 scope/epoch 的操作。两个数字值字典共享 ensure，保留各自 v-model；取消一个消费者不会中止另一个消费者的宿主操作。失败保持上次结果，恢复后重载；reload({ force: true }) 更新宿主世代并等待当前 ensure；普通 reload() 重读宿主字典缓存而不调用 refresh，没有额外 refreshDict 公共标志。示例所有宿主操作都在本地完成，不访问服务器。宿主真实 Axios/Pinia 接入见独立 adapter 包的 README，业务实现通过 bridge 注入，不由通用包引用。

芋道宿主桥接与生命周期 ​

点击“展示未提供 refresh 的桥接”会创建另一个独立子应用与本地宿主缓存。bridge.dict.ensure 和同步 get 仍然必需，refresh 可以省略；省略后普通 reload() 可以重新确保并读取缓存，reload({ force: true }) 则返回 config 错误并保留已选模型和上次成功数据，不会静默退回普通读取。使用普通重载可以恢复成功状态。这两个子应用的 scope、运行时和模型互相独立，卸载时分别回收；示例按钮不会替换已经安装的 provider。

完整芋道桥协议 ​

createYudaoProvider(bridge) 返回 AsamDataProvider；构造时只校验配置与保存宿主回调，不执行传输、字典读取或通知。AsamYudaoBridge 的 request、upload、dict、isErrorNotified、onError 均可省略且引用只读。空桥仍提供响应适配和 pageNo/pageSize 分页键，但没有请求、上传或字典能力；需要这些能力时由宿主注入。

完整芋道桥协议 ​

adapter 不配置 Axios、凭据、端点、Pinia 或宿主缓存。request/upload/通知回调保持构造时的函数身份；provider 及分页键对象冻结，不冻结宿主 bridge，也不通过事后替换 bridge 成员更新 provider。TypeScript 的 void 回调类型不会拒绝所有异步函数，运行时对通知回调另外要求同步完成。

完整芋道桥协议 ​

默认适配只展开一层自有 data。存在自有 code 时只接受数值 0 或 200，字符串 "0"、其他码、null 和显式 undefined 都失败；不存在 code 不等同于显式 undefined。选项和分页的最终形状由核心规范化校验，不能递归猜测多层 data。页响应同时含合法 list/total 和 data 页路径时判为歧义。业务自定义 transform 的优先关系沿用数据来源协议。

完整芋道桥协议 ​

yudao-bridge 完整 TS/JS 示例的“检查完整宿主桥”按钮实际验证构造无副作用、原请求上下文与载荷、上传 File/进度转交、一层响应与失败、分页歧义、宿主通知去重、13 种无效桥以及空桥。传输和文件均在示例内部构造，不访问按钮中的示例 URL。原字典的共享、取消、刷新、恢复与缺省 refresh 示例仍可独立操作；上传在这里只验证桥转交协议，不代替上传组件的文件校验与资源模型。

上传数据协议与完整消费者 ​

类型只描述结构，不保证字符串非空、数值有限、地址安全或 Blob 的内容满足业务规则。资源消费者在发送前检查字段名、来源配置与附加数据；完成后要求资源字段有效、size 为非负安全整数、URL 为无凭据的 HTTP(S) 或站内绝对路径，并满足可序列化结构。空 id、javascript 地址和 NaN size 不会进入资源模型。上传请求默认 POST，支持 PUT，不能沿用普通数据请求的 GET/DELETE；同步 transform 保留传输输入，Promise/thenable 转换结果被拒绝。

上传数据协议与完整消费者 ​

reportProgress 不直接提交模型。没有 total 的有效 loaded 可以报告不确定进度；有 total 时仅接受有限、非负 loaded 和大于零的 total，且 loaded 不超过 total。无效进度被忽略，不发新的 progress 事件。完成资源会触发 success 和模型更新；处理器/传输失败归入 upload 阶段，转换和请求模式资源校验失败归入 transform 阶段，均保留原失败信息。

完整 provider 数据能力 ​

provider 的静态只读引用不等于冻结宿主缓存、原始响应或方法内部状态；dict 的 get/refresh 方法签名也不是 readonly 方法引用。运行时校验可调用成员、分页键和当前上下文，通知钩子另有同步与去重约束。TS/JS 示例通过独立 provider 实际传输 File/Blob 和进度，原数据来源、分页与错误归属示例展示其他成员；无需给核心包引入业务 API 或全局 store。

局部请求错误插槽 ​

可选 error 插槽仅在当前请求错误存在时调用，接收只读 { error, stale, retry }。 error 与本实例 error 事件中的 AsamDataError 为同一对象，保留 cause、kind、 message 与 notified；渲染插槽不会再次通知 provider。stale 表示保留的数据已过期。

更多参数与事件说明 ​

完整 provider 数据能力 ​

AsamDataProvider 的 request、upload、adaptOptions、adaptPage、dict、isErrorNotified、onError、pagination 都是可选的只读引用；空对象可以安装，但具体来源缺少对应传输或字典能力时会报 config 错误。request 返回未知响应的 Promise，upload 使用上表的上传传输；adaptOptions 和 adaptPage 同步返回选项原记录或分页，来源的显式 transform 优先。dict.get 必填，dict.refresh 可选。pagination 的两个只读字段须为非空且不同的参数名。

局部请求错误插槽 ​

retry() 不接收参数，直接返回现有 reload({ force: true }) 的 Promise，结果为 AsamReloadResult<readonly AsamOption<V, I>[]> 的 success、error 或 cancelled 分支。 重试遵守 active、当前来源、取消和卸载规则，不改写模型。字典强刷沿用 provider 的 refresh 后 get；缺少 refresh 仍是原配置错误。

继承能力

本入口的独有 API 见上表，基础能力见本站对应页面。

选择器 AsamSelect
远端选择器 AsamRemoteSelect
参数与事件补充说明

组合契约按分支生效；请同时查看公开类型。

参数与事件说明

ariaLabel

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

id

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

effect

必填：否；声明来源：上游声明。

effect 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举："light" / "dark"

默认值与来源
未知 / 未声明

固定上游文档默认：light（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：'light'（2.14.7；源码事实，未作为 ASAM 运行实测）

popperClass

必填：否；声明来源：上游声明。

popperClass 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false

默认值与来源
未知 / 未声明

固定上游文档默认：''（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：''（2.14.7；源码事实，未作为 ASAM 运行实测）

popperStyle

必填：否；声明来源：上游声明。

popperStyle 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false

嵌套展开边界：框架 / 平台类型；完整类型见公开类型视图。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：undefined（2.14.7；源码事实，未作为 ASAM 运行实测）

fallbackPlacements

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：['bottom-start', 'top-start', 'right', 'left']（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：['bottom-start', 'top-start', 'right', 'left']（2.14.7；源码事实，未作为 ASAM 运行实测）

offset

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：12（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：12（2.14.7；源码事实，未作为 ASAM 运行实测）

placement

必填：否；声明来源：上游声明。

placement 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举："auto" / "auto-start" / "auto-end" / "top" / "bottom" / "right" / "left" / "top-start" / "top-end" / "bottom-start" / "bottom-end" / "right-start" / "right-end" / "left-start" / "left-end"

默认值与来源
未知 / 未声明

固定上游文档默认：bottom-start（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：'bottom-start'（2.14.7；源码事实，未作为 ASAM 运行实测）

popperOptions

必填：否；声明来源：上游声明。

popperOptions 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

  • popperOptions.placement: PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["popperOptions"]>, "placement"> — 依赖声明

    枚举："auto" / "auto-start" / "auto-end" / "top" / "bottom" / "right" / "left" / "top-start" / "top-end" / "bottom-start" / "bottom-end" / "right-start" / "right-end" / "left-start" / "left-end"

  • popperOptions.modifiers: PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["popperOptions"]>, "modifiers"> — 依赖声明
  • popperOptions.strategy: PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["popperOptions"]>, "strategy"> — 依赖声明

    枚举："fixed" / "absolute"

  • popperOptions.onFirstUpdate: PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["popperOptions"]>, "onFirstUpdate"> — 依赖声明

    事件参数：(arg0: Parameters<Extract<NonNullable<PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["popperOptions"]>, "onFirstUpdate">>, (...args: never[]) => unknown>>[0]): void

默认值与来源
未知 / 未声明

固定上游文档默认：{}（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码工厂（未执行）：() => ({}) as Partial<Options>（2.14.7；源码事实，未作为 ASAM 运行实测）

showArrow

必填：否；声明来源：上游声明。

showArrow 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

默认值与来源
未知 / 未声明

固定上游文档默认：true（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：true（2.14.7；源码事实，未作为 ASAM 运行实测）

appendTo

必填：否；声明来源：上游声明。

appendTo 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

嵌套展开边界：大型实例类型；完整类型见公开类型视图。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

persistent

必填：否；声明来源：上游声明。

persistent 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

默认值与来源
未知 / 未声明

固定上游文档默认：true（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：true（2.14.7；源码事实，未作为 ASAM 运行实测）

teleported

必填：否；声明来源：ASAM 声明。

teleported 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

disabled

必填：否；声明来源：ASAM 声明。

disabled 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

tabindex

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：0（2.14.7；源码事实，未作为 ASAM 运行实测）

size

必填：否；声明来源：ASAM 声明。

size 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举："large" / "big" / "default" / "small"

props

必填：否；声明来源：上游声明。

props 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

  • props.label: string | undefined — 上游声明

    指定节点标签为节点对象的某个属性值

    固定上游文档默认：label（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

  • props.value: string | undefined — 上游声明

    指定选项的值为选项对象的某个属性值

    固定上游文档默认：value（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

  • props.disabled: string | undefined — 上游声明

    指定选项的禁用为选项对象的某个属性值

    固定上游文档默认：disabled（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

  • props.options: string | undefined — 上游声明

    指定选项的子选项为选项对象的某个属性值

    固定上游文档默认：options（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码工厂（未执行）：() => defaultProps（2.14.7；源码事实，未作为 ASAM 运行实测）

name

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

separator

必填：否；声明来源：ASAM 声明。

modelValue

必填：否；声明来源：ASAM 声明。

modelValue 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

  • modelValue.label: string — 数据 / provider 协议
  • modelValue.value: V — 数据 / provider 协议
  • modelValue.disabled: boolean | undefined — 数据 / provider 协议

    枚举：false / true

  • modelValue.raw: I — 数据 / provider 协议
  • modelValue.children: readonly AsamOption<V, I>[] | undefined — 数据 / provider 协议
filterMethod

必填：否；声明来源：上游声明。

filterMethod 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(query: string): void

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码未声明 default（2.14.7；源码事实，未作为 ASAM 运行实测）

multiple

必填：否；声明来源：ASAM 声明。

multiple 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false

枚举：true

valueMode

必填：否；声明来源：ASAM 声明。

valueMode 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举："value"

枚举："object"

multipleValueMode

必填：否；声明来源：ASAM 声明。

multipleValueMode 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举："array"

枚举："string"

emptyValues

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

valueOnClear

必填：否；声明来源：上游声明。

valueOnClear 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

  • valueOnClear.apply: (this: Function, thisArg: any, argArray?: any) => any — 依赖声明

    调用函数，以指定对象作为 this，并使用指定数组作为函数参数。

    事件参数：(this: Function, thisArg: any, argArray?: any): any

    嵌套展开边界：框架 / 平台类型；完整类型见公开类型视图。

  • valueOnClear.call: (this: Function, thisArg: any, ...argArray: any[]) => any — 依赖声明

    调用对象方法，并以另一个对象作为当前 this。

    事件参数：(this: Function, thisArg: any, ...argArray: any[]): any

    嵌套展开边界：框架 / 平台类型；完整类型见公开类型视图。

  • valueOnClear.bind: (this: Function, thisArg: any, ...argArray: any[]) => any — 依赖声明

    创建具有相同函数体的绑定函数，将 this 绑定到指定对象，并设置初始参数。

    事件参数：(this: Function, thisArg: any, ...argArray: any[]): any

    嵌套展开边界：框架 / 平台类型；完整类型见公开类型视图。

  • valueOnClear.toString: () => string — 依赖声明

    返回函数的字符串表示。

    事件参数：(): string

    嵌套展开边界：框架 / 平台类型；完整类型见公开类型视图。

  • valueOnClear.prototype: any — 依赖声明
  • valueOnClear.length: number — 依赖声明
  • valueOnClear.arguments: any — 依赖声明
  • valueOnClear.caller: Function — 依赖声明

    嵌套展开边界：框架 / 平台类型；完整类型见公开类型视图。

  • valueOnClear.name: string — 依赖声明

    返回函数名称；函数名称只读，不能修改。

  • valueOnClear.__@hasInstance@8888: (value: any) => boolean — 依赖声明

    当函数用作构造函数时，判断指定值是否继承自该函数；构造函数可以覆盖此方法，控制 instanceof 对实例的识别。

    事件参数：(value: any): boolean

    嵌套展开边界：框架 / 平台类型；完整类型见公开类型视图。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

validateEvent

必填：否；声明来源：上游声明。

validateEvent 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

默认值与来源
未知 / 未声明

固定上游文档默认：true（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：true（2.14.7；源码事实，未作为 ASAM 运行实测）

clearable

必填：否；声明来源：ASAM 声明。

clearable 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

automaticDropdown

必填：否；声明来源：上游声明。

automaticDropdown 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

默认值与来源
未知 / 未声明

固定上游文档默认：false（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

clearIcon

必填：否；声明来源：上游声明。

clearIcon 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(props: any, ctx: Parameters<Extract<NonNullable<(AsamDictSelectProps<V, I>)["clearIcon"]>, (...args: never[]) => unknown>>[1]): any

  • clearIcon.__isFragment: undefined — 依赖声明
  • clearIcon.__isTeleport: undefined — 依赖声明
  • clearIcon.__isSuspense: undefined — 依赖声明
默认值与来源
未知 / 未声明

固定上游文档默认：CircleClose（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：CircleClose（2.14.7；源码事实，未作为 ASAM 运行实测）

placeholder

必填：否；声明来源：ASAM 声明。

autocomplete

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：off（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：'off'（2.14.7；源码事实，未作为 ASAM 运行实测）

filterable

必填：否；声明来源：ASAM 声明。

filterable 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

allowCreate

必填：否；声明来源：ASAM 声明。

allowCreate 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

枚举：false

枚举：true

debounce

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：300（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：300（2.14.7；源码事实，未作为 ASAM 运行实测）

loadingText

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

noMatchText

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

noDataText

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

multipleLimit

必填：否；声明来源：ASAM 声明。

defaultFirstOption

必填：否；声明来源：上游声明。

defaultFirstOption 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

默认值与来源
未知 / 未声明

固定上游文档默认：false（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

reserveKeyword

必填：否；声明来源：上游声明。

reserveKeyword 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

默认值与来源
未知 / 未声明

固定上游文档默认：true（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：true（2.14.7；源码事实，未作为 ASAM 运行实测）

valueKey

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：value（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：'value'（2.14.7；源码事实，未作为 ASAM 运行实测）

collapseTags

必填：否；声明来源：ASAM 声明。

collapseTags 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

collapseTagsTooltip

必填：否；声明来源：ASAM 声明。

collapseTagsTooltip 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

tagTooltip

必填：否；声明来源：上游声明。

tagTooltip 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

  • tagTooltip.appendTo: string | HTMLElement | undefined — 上游声明

    指示 Tooltip 的内容将附加在哪一个网页元素上

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

    嵌套展开边界：大型实例类型；完整类型见公开类型视图。

  • tagTooltip.placement: PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["tagTooltip"]>, "placement"> — 上游声明

    Tooltip 组件出现的位置

    固定上游文档默认：bottom（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

    枚举："auto" / "auto-start" / "auto-end" / "top" / "bottom" / "right" / "left" / "top-start" / "top-end" / "bottom-start" / "bottom-end" / "right-start" / "right-end" / "left-start" / "left-end"

  • tagTooltip.fallbackPlacements: AsamSelectRuntimeProps["fallbackPlacements"] — 上游声明

    提示浮层可采用的位置列表，参阅 Popper 的 fallbackPlacements。

    固定上游文档默认：['bottom', 'top', 'right', 'left']（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

  • tagTooltip.effect: PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["tagTooltip"]>, "effect"> — 上游声明

    Tooltip 主题，内置了 dark / light 两种

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

    枚举："light" / "dark"

  • tagTooltip.popperClass: AsamSelectRuntimeProps["popperClass"] — 上游声明

    为 Tooltip 的 popper 添加自定义类名

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

    枚举：false

  • tagTooltip.popperStyle: AsamSelectRuntimeProps["popperStyle"] — 上游声明

    为 Tooltip 的 popper 添加自定义样式

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

    枚举：false

    嵌套展开边界：框架 / 平台类型；完整类型见公开类型视图。

  • tagTooltip.transition: string | undefined — 上游声明

    动画名称

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

  • tagTooltip.teleported: boolean | undefined — 上游声明

    是否使用 teleport。设置成 true则会被追加到 append-to 的位置

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

    枚举：false / true

  • tagTooltip.popperOptions: AsamSelectRuntimeProps["popperOptions"] — 上游声明

    Popper 配置参数。

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

    • tagTooltip.popperOptions.placement: PublicMember<NonNullable<PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["tagTooltip"]>, "popperOptions">>, "placement"> — 依赖声明

      枚举："auto" / "auto-start" / "auto-end" / "top" / "bottom" / "right" / "left" / "top-start" / "top-end" / "bottom-start" / "bottom-end" / "right-start" / "right-end" / "left-start" / "left-end"

    • tagTooltip.popperOptions.modifiers: PublicMember<NonNullable<PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["tagTooltip"]>, "popperOptions">>, "modifiers"> — 依赖声明
    • tagTooltip.popperOptions.strategy: PublicMember<NonNullable<PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["tagTooltip"]>, "popperOptions">>, "strategy"> — 依赖声明

      枚举："fixed" / "absolute"

    • tagTooltip.popperOptions.onFirstUpdate: PublicMember<NonNullable<PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["tagTooltip"]>, "popperOptions">>, "onFirstUpdate"> — 依赖声明

      事件参数：(arg0: Parameters<Extract<NonNullable<PublicMember<NonNullable<PublicMember<NonNullable<(AsamDictSelectProps<V, I>)["tagTooltip"]>, "popperOptions">>, "onFirstUpdate">>, (...args: never[]) => unknown>>[0]): void

  • tagTooltip.showAfter: number | undefined — 上游声明

    在触发后多久显示内容，单位毫秒

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

  • tagTooltip.hideAfter: number | undefined — 上游声明

    关闭时的延迟

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

  • tagTooltip.autoClose: number | undefined — 上游声明

    tooltip 出现后自动隐藏延时，单位毫秒

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

  • tagTooltip.offset: number | undefined — 上游声明

    Tooltip 出现位置的偏移量

    固定上游文档默认：未声明（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

默认值与来源
未知 / 未声明

固定上游文档默认：{}（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码工厂（未执行）：() => ({})（2.14.7；源码事实，未作为 ASAM 运行实测）

maxCollapseTags

必填：否；声明来源：上游声明。

默认值与来源
未知 / 未声明

固定上游文档默认：1（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：1（2.14.7；源码事实，未作为 ASAM 运行实测）

fitInputWidth

必填：否；声明来源：上游声明。

fitInputWidth 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

默认值与来源
未知 / 未声明

固定上游文档默认：false（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

suffixIcon

必填：否；声明来源：上游声明。

suffixIcon 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(props: any, ctx: Parameters<Extract<NonNullable<(AsamDictSelectProps<V, I>)["suffixIcon"]>, (...args: never[]) => unknown>>[1]): any

  • suffixIcon.__isFragment: undefined — 依赖声明
  • suffixIcon.__isTeleport: undefined — 依赖声明
  • suffixIcon.__isSuspense: undefined — 依赖声明
默认值与来源
未知 / 未声明

固定上游文档默认：ArrowDown（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

固定上游源码默认表达式：ArrowDown（2.14.7；源码事实，未作为 ASAM 运行实测）

tagType

必填：否；声明来源：上游声明。

tagType 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举："primary" / "success" / "danger" / "warning" / "info"

默认值与来源
未知 / 未声明

固定上游文档默认：info（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

tagEffect

必填：否；声明来源：上游声明。

tagEffect 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举："light" / "dark" / "plain"

默认值与来源
未知 / 未声明

固定上游文档默认：light（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

remoteShowSuffix

必填：否；声明来源：上游声明。

remoteShowSuffix 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

默认值与来源
未知 / 未声明

固定上游文档默认：false（2.14.7；文档事实，实际默认以 ASAM 源码 / 安装包为准）

immediate

必填：否；声明来源：数据 / provider 协议。

immediate 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

active

必填：否；声明来源：数据 / provider 协议。

active 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

枚举：false / true

默认值与来源
true（源码表达式；ASAM 声明）
dataSource

必填：否；声明来源：数据 / provider 协议。

dataSource 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

  • dataSource.kind: "dict" — 数据 / provider 协议

    枚举："dict"

  • dataSource.__@sourceBrand@58165: { readonly value: V; readonly raw: I; } — 数据 / provider 协议
    • dataSource.__@sourceBrand@58165.value: V — 数据 / provider 协议
    • dataSource.__@sourceBrand@58165.raw: I — 数据 / provider 协议
默认值与来源
undefined（源码表达式；ASAM 声明）
dictType

必填：否；声明来源：数据 / provider 协议。

默认值与来源
undefined（源码表达式；ASAM 声明）
dictValueType

必填：按分支；声明来源：数据 / provider 协议。

dictValueType 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

契约分支 2

枚举："string" / "number" / "boolean"

默认值与来源
undefined（源码表达式；ASAM 声明）
createOption

必填：按分支；声明来源：ASAM 声明。

createOption 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

契约分支 3

事件参数：(text: string): AsamOption<V, I>

AsamDictSelectProps 公开类型视图
ts
import type { Attrs } from 'vue';
import type { AsamDictSelectProps, AsamValue, AsamRecord, AsamSelectRuntimeProps, AsamControlSize, AsamSelectNativeProps, AsamSelectV2NativeProps, AsamSelectValueMode, AsamOptionsSource, AsamDictValueType, AsamSelectOption, AsamOption, AsamCreateOption } from '@asam-ui/ui';

type PublicMember<T, K extends PropertyKey> = T extends unknown ? K extends keyof T ? T[K] : never : never;

// AsamDictSelectProps
type PublicContract<V extends AsamValue = AsamValue, I extends object = AsamRecord> = AsamDictSelectProps<V, I>;

参数与事件说明

clear

必填：是；声明来源：数据 / provider 协议。

focus

必填：是；声明来源：数据 / provider 协议。

end-reached

必填：是；声明来源：数据 / provider 协议。

error

必填：是；声明来源：数据 / provider 协议。

blur

必填：是；声明来源：数据 / provider 协议。

visible-change

必填：是；声明来源：数据 / provider 协议。

remove-tag

必填：是；声明来源：数据 / provider 协议。

popup-scroll

必填：是；声明来源：数据 / provider 协议。

update:modelValue

必填：是；声明来源：数据 / provider 协议。

change

必填：是；声明来源：数据 / provider 协议。

success

必填：是；声明来源：数据 / provider 协议。

AsamSelectDataEmits 公开类型视图
ts
import type { AsamSelectDataEmits, AsamValue, AsamSelectEmits, AsamScrollbarDirection, AsamDataError, AsamOption } from '@asam-ui/ui';

// AsamSelectDataEmits
type PublicContract<V extends AsamValue = AsamValue, I extends object = object> = {
	"clear": (AsamSelectDataEmits<V, I>)["clear"];
	"focus": [event: FocusEvent];
	"end-reached": [direction: AsamScrollbarDirection];
	"error": [error: AsamDataError];
	"blur": [event: FocusEvent];
	"visible-change": [visible: boolean];
	"remove-tag": [value: unknown];
	"popup-scroll": [event: { scrollTop: number; scrollLeft: number; }];
	"update:modelValue": [value: string | V | AsamOption<V, I> | readonly V[] | readonly AsamOption<V, I>[] | null];
	"change": [value: string | V | AsamOption<V, I> | readonly V[] | readonly AsamOption<V, I>[] | null];
	"success": [data: readonly AsamOption<V, I>[]];
};

参数与事件说明

default

必填：否；声明来源：数据 / provider 协议。

default 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(): unknown

prefix

必填：否；声明来源：数据 / provider 协议。

prefix 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(): unknown

header

必填：否；声明来源：数据 / provider 协议。

header 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(): unknown

footer

必填：否；声明来源：数据 / provider 协议。

footer 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(): unknown

empty

必填：否；声明来源：数据 / provider 协议。

empty 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(): unknown

loading

必填：否；声明来源：数据 / provider 协议。

loading 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(): unknown

tag

必填：否；声明来源：数据 / provider 协议。

tag 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(scope: { data: AsamTreeSelectTagOption[]; selectDisabled: boolean; deleteTag: (event: MouseEvent, option: AsamTreeSelectTagOption) => void; }): unknown

label

必填：否；声明来源：数据 / provider 协议。

label 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(scope: { index: number; label: AsamSelectV2NativeProps["modelValue"]["label"]; value: AsamSelectV2NativeProps["modelValue"]["value"]; }): unknown

error

必填：否；声明来源：数据 / provider 协议。

error 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(scope: Parameters<Extract<NonNullable<(AsamAsyncSelectSlots<V, I>)["error"]>, (...args: never[]) => unknown>>[0]): unknown

AsamAsyncSelectSlots 公开类型视图
ts
import type { AsamAsyncSelectSlots, AsamValue, AsamTreeSelectTagOption, AsamSelectSlots, AsamSelectV2NativeProps, AsamDataError, AsamOption, AsamReloadResult } from '@asam-ui/ui';

// AsamAsyncSelectSlots
type PublicContract<V extends AsamValue = AsamValue, I extends object = object> = {
	"default"?: (() => unknown) | undefined;
	"prefix"?: (() => unknown) | undefined;
	"header"?: (() => unknown) | undefined;
	"footer"?: (() => unknown) | undefined;
	"empty"?: (() => unknown) | undefined;
	"loading"?: (() => unknown) | undefined;
	"tag"?: ((scope: { data: AsamTreeSelectTagOption[]; selectDisabled: boolean; deleteTag: (event: MouseEvent, option: AsamTreeSelectTagOption) => void; }) => unknown) | undefined;
	"label"?: ((scope: { index: number; label: any; value: any; }) => unknown) | undefined;
	"error"?: (AsamAsyncSelectSlots<V, I>)["error"];
};

数据选择实例继承基础选择入口的 clearCreatedOptions()：仅清空组件本地创建集合 和文本 memo，不写回 modelValue，也不修改 provider/cache。真实来源或 scope 改变时自动调用；搜索、同来源 reload、epoch 更新与失败重试保留本地项。

参数与事件说明

selectedLabel

必填：是；声明来源：数据 / provider 协议。

reload

必填：是；声明来源：数据 / provider 协议。

reload 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(options?: { readonly force?: boolean; } | undefined): Promise<AsamReloadResult<readonly AsamOption<V, I>[]>>

cancel

必填：是；声明来源：数据 / provider 协议。

cancel 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(): void

focus

必填：是；声明来源：ASAM 声明。

focus 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(): void

blur

必填：是；声明来源：ASAM 声明。

blur 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(): void

clearCreatedOptions

必填：是；声明来源：ASAM 声明。

clearCreatedOptions 参数与事件数据

下列为声明可读视图；可导入类型以公开类型视图为准。分支条件与父属性一致。

事件参数：(): void

AsamAsyncSelectExpose 公开类型视图
ts
import type { AsamAsyncSelectExpose, AsamValue, AsamRecord, AsamSelectExpose, AsamOption, AsamReloadResult } from '@asam-ui/ui';

// AsamAsyncSelectExpose
type PublicContract<V extends AsamValue = AsamValue, I extends object = AsamRecord> = {
	readonly "selectedLabel": string | string[];
	"reload": (options?: { readonly force?: boolean; }) => Promise<AsamReloadResult<readonly AsamOption<V, I>[]>>;
	"cancel": () => void;
	"focus": () => void;
	"blur": () => void;
	"clearCreatedOptions": () => void;
};

搜索文档

Tab 选择结果 Enter 打开 Esc 关闭