ASAM UI
v1.0.0

展示

骨架屏 AsamSkeleton

在内容等待期间显示可预期的布局轮廓。

使用场景 ​

在内容等待期间显示可预期的布局轮廓。

基础用法与状态 ​

下列示例只使用本入口的实际公开能力。

基础用法与状态

展开源码

使用约定 ​

loading 控制骨架与内容切换，animated、rows、count、throttle 控制呈现。template 插槽组织骨架，default 插槽组织已就绪内容。真实请求、失败和恢复由宿主维护。

完整使用场景 ​

基础用法 ​

基础的骨架效果。

基础用法

展开源码

更多参数 ​

可以配置骨架屏段落数量，以便更接近真实渲染效果。显示的数量会比传入的数量多 1，首行会被渲染一个长度 33% 的段首。

更多参数

展开源码

动画效果 ​

我们提供了一个开关标志，表明是否显示加载动画， 调用 animated 如果真是这样，所有的 el-skeleton 的子节点将显示动画。

动画效果

展开源码

自定义样式 ​

默认提供常用骨架模板；如不能满足场景需要，可通过 template 插槽自定义。

我们提供了不同的模板单元可供使用，具体可选值请看 API 详细描述。另外，在构建您自己自定义的骨架时，您应该尽可能更接近于真正的DOM。 避免DOM因高度差而发生抖动。

自定义样式

展开源码

加载状态 ​

当 Loading 结束之后，我们往往需要显示真实的 UI，可以通过 loading 属性的值来控制是否显示加载后的 DOM。也可以通过具名插槽 default 来构建 loading 结束之后需要展示的真实 DOM 元素结构。

加载状态

展开源码

渲染多条数据 ​

大多时候, 骨架屏都被用来渲染列表, 当我们需要在从服务器获取数据的时候来渲染一个假的 UI。 利用 count 这个属性就能控制渲染多少条假的数据在页面上

我们不推荐在浏览器中渲染过多的虚假 UI 元素，这样会消耗更多时间销毁骨架元素，从而引起性能问题。为了用户体验，请尽量将 count 值保持在小一点的数值。

渲染多条数据

展开源码

防止渲染抖动 ​

有的时候，API 的请求回来的特别快，往往骨架占位刚刚被渲染，真实的数据就已经回来了，用户的界面会突然一闪，此时为了避免这种情况，就需要通过 throttle 属性来避免这个问题。

2.8.8版本里， throtle 属性支持两个值： number 和 object。当通过 number时，它相当于 {leading: xxx}，控制骨架屏幕显示的节奏。当然，您也可以通过传递 {trailing: xxx} 来控制骨架屏消失的节奏。

防止渲染抖动

展开源码

初始渲染加载 2.8.8 ​

当初始值为 loading: true 时，您可以设置 throttle: {initVal: true, leading: xxx} 来控制初始骨架屏的即时显示，而无需进行节流。

初始渲染加载 2.8.8

展开源码

切换显示/隐藏时避免渲染抖动 2.8.8 ​

您可以设置 throttle: {initVal: true, leading: xxx, trailing: xxx}，以控制骨架效果的初始显示，并使切换加载状态时骨架效果的过渡更加平滑。

有时，当加载状态切换显示或隐藏时，您可能希望业务组件的渲染更加平滑。您可以设置 throttle: {leading: xxx, trailing: xxx} 来控制渲染抖动。

切换显示/隐藏时避免渲染抖动 2.8.8

展开源码

API

属性 AsamSkeletonProps

属性名说明类型默认值
animated是否使用动画boolean | undefinedfalse
count渲染多少个 template, 建议使用尽可能小的数字number | undefined1
rows骨架屏段落数量number | undefined3
loading是否显示加载结束后的 DOM 结构boolean | undefinedtrue
throttle渲染延迟，单位毫秒。(AsamSkeletonProps)["throttle"]—
key—PropertyKey | undefined—
ref—VNodeRef | undefined—
ref_for—boolean | undefined—
ref_key—string | undefined—
onVnodeBeforeMount—(AsamSkeletonProps)["onVnodeBeforeMount"]—
onVnodeMounted—(AsamSkeletonProps)["onVnodeMounted"]—
onVnodeBeforeUpdate—(AsamSkeletonProps)["onVnodeBeforeUpdate"]—
onVnodeUpdated—(AsamSkeletonProps)["onVnodeUpdated"]—
onVnodeBeforeUnmount—(AsamSkeletonProps)["onVnodeBeforeUnmount"]—
onVnodeUnmounted—(AsamSkeletonProps)["onVnodeUnmounted"]—
class—unknown—
style—unknown—

实例方法与状态 AsamSkeletonExpose

属性名说明类型默认值
$—AsamSkeletonExpose["$"]—
$data—AsamTableColumnExpose—
$props—AsamSkeletonProps—
$attrs—AsamSkeletonExpose["$attrs"]—
$refs—AsamSkeletonExpose["$refs"]—
$slots—AsamSkeletonSlots—
$root—
查看完整类型ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, ComponentProvideOptions>, {}, {}, "", {}, any> | null
—
$parent—
查看完整类型ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, ComponentProvideOptions>, {}, {}, "", {}, any> | null
—
$host—Element | null—
$emit—(event: string, ...args: any[]) => void—
$el—any—
$options—(AsamSkeletonExpose)["$options"]—
$forceUpdate—() => void—
$nextTick—(AsamSkeletonExpose)["$nextTick"]—
$watch—(AsamSkeletonExpose)["$watch"]—
loading—boolean—
rows—number—
count—number—
animated是否使用动画boolean | undefined—
throttle渲染延迟，单位毫秒。(AsamSkeletonExpose)["throttle"]—
uiLoading加载状态。boolean—
$route当前规范化路由位置，详见 RouteLocationNormalizedLoaded。AsamSkeletonExpose["$route"]—
$router应用使用的 Router 实例。AsamSkeletonExpose["$router"]—

类型 AsamSkeletonInstance

属性名说明类型默认值
$—AsamSkeletonExpose["$"]—
$data—AsamTableColumnExpose—
$props—AsamSkeletonProps—
$attrs—AsamSkeletonExpose["$attrs"]—
$refs—AsamSkeletonExpose["$refs"]—
$slots—AsamSkeletonSlots—
$root—
查看完整类型ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, ComponentProvideOptions>, {}, {}, "", {}, any> | null
—
$parent—
查看完整类型ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, ComponentProvideOptions>, {}, {}, "", {}, any> | null
—
$host—Element | null—
$emit—(event: string, ...args: any[]) => void—
$el—any—
$options—(AsamSkeletonInstance)["$options"]—
$forceUpdate—() => void—
$nextTick—(AsamSkeletonInstance)["$nextTick"]—
$watch—(AsamSkeletonInstance)["$watch"]—
loading—boolean—
rows—number—
count—number—
animated是否使用动画boolean | undefined—
throttle渲染延迟，单位毫秒。(AsamSkeletonInstance)["throttle"]—
uiLoading加载状态。boolean—
$route当前规范化路由位置，详见 RouteLocationNormalizedLoaded。AsamSkeletonExpose["$route"]—
$router应用使用的 Router 实例。AsamSkeletonExpose["$router"]—

插槽 AsamSkeletonSlots

属性名说明类型默认值
template—(AsamSkeletonSlots)["template"]—
default—(AsamSkeletonSlots)["default"]—

类型 AsamSkeletonItemPropsPublic

属性名说明类型默认值
variant—enum"text" | "button" | "circle" | "image" | "caption" | "h1" | "h3" | "p" | "rect"完整类型：(AsamSkeletonItemPropsPublic)["variant"]—

类型 AsamSkeletonPropsPublic

属性名说明类型默认值
loading—(AsamSkeletonPropsPublic)["loading"]—
animated—boolean | undefined—
count—number | undefined—
rows—number | undefined—
throttle—(AsamSkeletonPropsPublic)["throttle"]—
骨架元素 AsamSkeletonItem
参数与事件补充说明

公开绑定参数，包含具备类型的事件监听器；默认值由运行时定义提供。

参数与事件说明

animated

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

animated 参数与事件数据

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

枚举：false / true

默认值与来源
false（隐式 Boolean 默认；已安装组件）

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

count

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

默认值与来源
1（已安装运行时；已安装组件）

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

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

rows

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

默认值与来源
3（已安装运行时；已安装组件）

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

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

loading

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

loading 参数与事件数据

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

枚举：false / true

默认值与来源
true（已安装运行时；已安装组件）

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

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

throttle

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

throttle 参数与事件数据

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

  • throttle.leading: number | undefined — 上游声明
  • throttle.trailing: number | undefined — 上游声明
  • throttle.initVal: boolean | undefined — 上游声明

    枚举：false / true

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

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

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

key

必填：否；声明来源：依赖声明。

ref

必填：否；声明来源：依赖声明。

ref 参数与事件数据

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

事件参数：(ref: Element | ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, ComponentProvideOptions>, {}, {}, "", {}, any> | null, refs: Record<string, any>): void

  • ref.value: any — 依赖声明
  • ref.__@RefSymbol@8854: true — 依赖声明

    仅用于区分类型：保留在公开声明中，通过私有 Symbol 避免出现在编辑器自动补全中。

    枚举：true

ref_for

必填：否；声明来源：依赖声明。

ref_for 参数与事件数据

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

枚举：false / true

ref_key

必填：否；声明来源：依赖声明。

onVnodeBeforeMount

必填：否；声明来源：依赖声明。

onVnodeBeforeMount 参数与事件数据

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

事件参数：(vnode: VNode<RendererNode, RendererElement, { [key: string]: any; }>): void

onVnodeMounted

必填：否；声明来源：依赖声明。

onVnodeMounted 参数与事件数据

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

事件参数：(vnode: VNode<RendererNode, RendererElement, { [key: string]: any; }>): void

onVnodeBeforeUpdate

必填：否；声明来源：依赖声明。

onVnodeBeforeUpdate 参数与事件数据

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

事件参数：(vnode: VNode<RendererNode, RendererElement, { [key: string]: any; }>, oldVNode: VNode<RendererNode, RendererElement, { [key: string]: any; }>): void

onVnodeUpdated

必填：否；声明来源：依赖声明。

onVnodeUpdated 参数与事件数据

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

事件参数：(vnode: VNode<RendererNode, RendererElement, { [key: string]: any; }>, oldVNode: VNode<RendererNode, RendererElement, { [key: string]: any; }>): void

onVnodeBeforeUnmount

必填：否；声明来源：依赖声明。

onVnodeBeforeUnmount 参数与事件数据

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

事件参数：(vnode: VNode<RendererNode, RendererElement, { [key: string]: any; }>): void

onVnodeUnmounted

必填：否；声明来源：依赖声明。

onVnodeUnmounted 参数与事件数据

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

事件参数：(vnode: VNode<RendererNode, RendererElement, { [key: string]: any; }>): void

class

必填：否；声明来源：依赖声明。

style

必填：否；声明来源：依赖声明。

AsamSkeletonProps 公开类型视图
ts
import type { VNodeRef, ComponentPublicInstance, ComponentOptionsBase, ComponentProvideOptions, VNode, RendererNode, RendererElement } from 'vue';
import type { AsamSkeletonProps, AsamSkeletonExpose } from '@asam-ui/ui';

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

// AsamSkeletonProps
type PublicContract = {
	readonly "animated"?: boolean | undefined;
	readonly "count"?: number | undefined;
	readonly "rows"?: number | undefined;
	readonly "loading"?: boolean | undefined;
	readonly "throttle"?: (AsamSkeletonProps)["throttle"];
	"key"?: PropertyKey | undefined;
	"ref"?: VNodeRef | undefined;
	"ref_for"?: boolean | undefined;
	"ref_key"?: string | undefined;
	"onVnodeBeforeMount"?: (AsamSkeletonProps)["onVnodeBeforeMount"];
	"onVnodeMounted"?: (AsamSkeletonProps)["onVnodeMounted"];
	"onVnodeBeforeUpdate"?: (AsamSkeletonProps)["onVnodeBeforeUpdate"];
	"onVnodeUpdated"?: (AsamSkeletonProps)["onVnodeUpdated"];
	"onVnodeBeforeUnmount"?: (AsamSkeletonProps)["onVnodeBeforeUnmount"];
	"onVnodeUnmounted"?: (AsamSkeletonProps)["onVnodeUnmounted"];
	"class"?: unknown;
	"style"?: unknown;
};

完整的上游实例，包含全部公开方法与响应式状态。

参数与事件说明

$

必填：是；声明来源：依赖声明。

$ 参数与事件数据

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

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

$data

必填：是；声明来源：依赖声明。

$props

必填：是；声明来源：依赖声明。

$attrs

必填：是；声明来源：依赖声明。

$attrs 参数与事件数据

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

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

$refs

必填：是；声明来源：依赖声明。

$refs 参数与事件数据

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

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

$slots

必填：是；声明来源：依赖声明。

$root

必填：是；声明来源：依赖声明。

$parent

必填：是；声明来源：依赖声明。

$host

必填：是；声明来源：依赖声明。

$host 参数与事件数据

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

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

$emit

必填：是；声明来源：依赖声明。

$emit 参数与事件数据

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

事件参数：(event: string, ...args: any[]): void

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

$el

必填：是；声明来源：依赖声明。

$options

必填：是；声明来源：依赖声明。

$forceUpdate

必填：是；声明来源：依赖声明。

$forceUpdate 参数与事件数据

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

事件参数：(): void

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

$nextTick

必填：是；声明来源：依赖声明。

$nextTick 参数与事件数据

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

事件参数：(): Promise<void>

事件参数：<T, R>(this: T, fn: (this: T) => R | Promise<R>): Promise<R>

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

$watch

必填：是；声明来源：依赖声明。

$watch 参数与事件数据

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

事件参数：<T extends string | ((...args: any) => any)>(source: T, cb: Parameters<Extract<NonNullable<(AsamSkeletonExpose)["$watch"]>, (...args: never[]) => unknown>>[1], options?: WatchOptions<boolean> | undefined): WatchStopHandle

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

loading

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

loading 参数与事件数据

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

枚举：false / true

rows

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

count

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

animated

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

animated 参数与事件数据

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

枚举：false / true

throttle

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

throttle 参数与事件数据

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

  • throttle.leading: number | undefined — 上游声明
  • throttle.trailing: number | undefined — 上游声明
  • throttle.initVal: boolean | undefined — 上游声明

    枚举：false / true

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

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

uiLoading

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

uiLoading 参数与事件数据

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

枚举：false / true

$route

必填：是；声明来源：依赖声明。

$route 参数与事件数据

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

  • $route.matched: (NonNullable<AsamSkeletonExpose["$route"]>)["matched"] — 依赖声明

    仅包含普通组件的 RouteLocationMatched 数组；懒加载组件已解析并替换 components 中的值，可直接展示路由，不包含重定向记录。此属性不可枚举。

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

  • $route.name: (NonNullable<AsamSkeletonExpose["$route"]>)["name"] — 依赖声明

    匹配路由记录的名称。

  • $route.fullPath: string — 依赖声明

    包含 search 和 hash 的完整位置字符串，使用百分号编码。

  • $route.query: (NonNullable<AsamSkeletonExpose["$route"]>)["query"] — 依赖声明

    当前位置 search 属性的对象表示。

  • $route.hash: string — 依赖声明

    当前位置的哈希片段；存在时以 # 开头。

  • $route.redirectedFrom: (NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"] — 依赖声明

    最终到达当前位置之前，最初尝试访问的位置。

    • $route.redirectedFrom.matched: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "matched"> — 依赖声明

      包含添加路由时原始组件的 RouteRecord 数组，也可能包含重定向记录，不能直接用于展示。此属性不可枚举。

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

    • $route.redirectedFrom.fullPath: string — 依赖声明

      包含 search 和 hash 的完整位置字符串，使用百分号编码。

    • $route.redirectedFrom.query: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "query"> — 依赖声明

      当前位置 search 属性的对象表示。

    • $route.redirectedFrom.hash: string — 依赖声明

      当前位置的哈希片段；存在时以 # 开头。

    • $route.redirectedFrom.redirectedFrom: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "redirectedFrom"> — 依赖声明

      最终到达当前位置之前，最初尝试访问的位置。

      嵌套展开边界：递归引用；完整类型见公开类型视图。

    • $route.redirectedFrom.name: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "name"> — 依赖声明

      匹配路由记录的名称。

    • $route.redirectedFrom.meta: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "meta"> — 依赖声明

      全部匹配路由记录合并后的 meta 属性。

    • $route.redirectedFrom.params: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "params"> — 依赖声明

      从 path 提取并解码后的参数对象。

    • $route.redirectedFrom.path: string — 依赖声明

      URL 中经过百分号编码的路径部分。

    • $route.redirectedFrom.replace: boolean | undefined — 依赖声明

      替换当前历史记录，而不是添加新记录。

      枚举：false / true

    • $route.redirectedFrom.force: boolean | undefined — 依赖声明

      即使目标与当前位置相同，也触发导航；除非传入 replace: true，否则会添加一条历史记录。

      枚举：false / true

    • $route.redirectedFrom.state: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "state"> — 依赖声明

      通过 History API 保存的状态；不能包含响应式值，也不允许 Symbol 等部分值。详情参见 https://developer.mozilla.org/zh-CN/docs/Web/API/History/state。

  • $route.meta: (NonNullable<AsamSkeletonExpose["$route"]>)["meta"] — 依赖声明

    全部匹配路由记录合并后的 meta 属性。

  • $route.params: (NonNullable<AsamSkeletonExpose["$route"]>)["params"] — 依赖声明

    从 path 提取并解码后的参数对象。

  • $route.path: string — 依赖声明

    URL 中经过百分号编码的路径部分。

$router

必填：是；声明来源：依赖声明。

$router 参数与事件数据

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

  • $router.options: (NonNullable<AsamSkeletonExpose["$router"]>)["options"] — 依赖声明

    创建路由器时传入的原始配置对象。

    • $router.options.routes: (NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["routes"] — 依赖声明

      需要添加到路由器的初始路由列表。

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

    • $router.options.history: (NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"] — 依赖声明

      路由器使用的历史记录实现。通常使用 createWebHistory，并配置服务器回退；createWebHashHistory 无需服务器配置，但搜索引擎无法处理其哈希路由，影响搜索优化。

      • $router.options.history.base: string — 依赖声明

        添加到每个 URL 前的基础路径；例如 base 为 /sub-folder 时，可将单页应用部署在域名的对应子目录。

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.location: string — 依赖声明

        当前历史记录位置。

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.state: (NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["state"] — 依赖声明

        当前历史记录状态。

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.push: (NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["push"] — 依赖声明

        导航到指定位置；使用 HTML5 History 时，通过 history.pushState 实际更新 URL。

        事件参数：(to: string, data?: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["push"]>, (...args: never[]) => unknown>>[1]): void

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.replace: (NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["replace"] — 依赖声明

        与 RouterHistory.push 类似，但调用 history.replaceState，而非 history.pushState。

        事件参数：(to: string, data?: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["replace"]>, (...args: never[]) => unknown>>[1]): void

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.go: (delta: number, triggerListeners?: boolean) => void — 依赖声明

        按指定方向遍历历史记录。

        事件参数：(delta: number, triggerListeners?: boolean | undefined): void

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.listen: (NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["listen"] — 依赖声明

        为历史记录实现添加监听器；由浏览器前进、后退等外部导航，或传入 true 的 RouterHistory.back、RouterHistory.forward 触发。

        事件参数：(callback: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["listen"]>, (...args: never[]) => unknown>>[0]): () => void

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.createHref: (NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["createHref"] — 依赖声明

        生成用于链接元素的对应 href。

        事件参数：(location: string): string

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.destroy: () => void — 依赖声明

        清除历史记录实现注册的全部事件监听器。

        事件参数：(): void

        嵌套展开边界：深度上限；完整类型见公开类型视图。

    • $router.options.scrollBehavior: (NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["scrollBehavior"] — 依赖声明

      控制页面导航时滚动行为的函数；可返回 Promise 延迟滚动。

      事件参数：(to: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["scrollBehavior"]>, (...args: never[]) => unknown>>[0], from: AsamSkeletonExpose["$route"], savedPosition: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["scrollBehavior"]>, (...args: never[]) => unknown>>[2]): ReturnType<Extract<NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["scrollBehavior"]>, (...args: never[]) => unknown>>

    • $router.options.parseQuery: (NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["parseQuery"] — 依赖声明

      自定义查询参数解析函数；与 EXPERIMENTAL_RouterOptions_Base.stringifyQuery 配套。

      事件参数：(search: string): ReturnType<Extract<NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["parseQuery"]>, (...args: never[]) => unknown>>

    • $router.options.stringifyQuery: (NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["stringifyQuery"] — 依赖声明

      自定义查询对象序列化函数；不要添加开头的 ?，与 parseQuery 的解析函数配套。

      事件参数：(query: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["stringifyQuery"]>, (...args: never[]) => unknown>>[0]): string

    • $router.options.linkActiveClass: string | undefined — 依赖声明

      应用于激活 RouterLink 的默认类名；未指定时使用 router-link-active。

    • $router.options.linkExactActiveClass: string | undefined — 依赖声明

      应用于精确激活 RouterLink 的默认类名；未指定时使用 router-link-exact-active。

    • $router.options.end: boolean | undefined — 依赖声明

      是否在表达式末尾添加 $，使其匹配到路径结尾。

      声明默认：`true`（注释，实际运行默认以源码/安装包为准）

      枚举：false / true

    • $router.options.sensitive: boolean | undefined — 依赖声明

      使正则表达式区分大小写。

      声明默认：`false`（注释，实际运行默认以源码/安装包为准）

      枚举：false / true

    • $router.options.strict: boolean | undefined — 依赖声明

      是否禁止路径末尾的斜杠。

      声明默认：`false`（注释，实际运行默认以源码/安装包为准）

      枚举：false / true

  • $router.addRoute: (NonNullable<AsamSkeletonExpose["$router"]>)["addRoute"] — 依赖声明

    向已有路由添加子路由，或向路由器添加新的 RouteRecordRaw 路由记录。

    事件参数完整签名见公开类型视图。

    事件参数完整签名见公开类型视图。

  • $router.removeRoute: (NonNullable<AsamSkeletonExpose["$router"]>)["removeRoute"] — 依赖声明

    按名称移除已有路由。

    事件参数：(name: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["removeRoute"]>, (...args: never[]) => unknown>>[0]): void

  • $router.clearRoutes: () => void — 依赖声明

    从路由器中删除全部路由。

    事件参数：(): void

  • $router.currentRoute: ShallowRef<AsamSkeletonExpose["$route"]> — 依赖声明

    当前 RouteLocationNormalized。

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

  • $router.listening: boolean — 依赖声明

    允许关闭历史事件监听，这是用于微前端的底层 API。

    枚举：false / true

  • $router.hasRoute: (NonNullable<AsamSkeletonExpose["$router"]>)["hasRoute"] — 依赖声明

    检查指定名称的路由是否存在。

    事件参数：(name: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["hasRoute"]>, (...args: never[]) => unknown>>[0]): boolean

  • $router.getRoutes: (NonNullable<AsamSkeletonExpose["$router"]>)["getRoutes"] — 依赖声明

    获取全部 RouteRecord 路由记录的完整列表。

    事件参数：(): ReturnType<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["getRoutes"]>, (...args: never[]) => unknown>>

  • $router.resolve: (NonNullable<AsamSkeletonExpose["$router"]>)["resolve"] — 依赖声明

    返回 RouteLocationRaw 的规范化位置，包含带基础路径的 href；默认使用 router.currentRoute 作为 currentLocation，仅在高级场景中覆盖。

    事件参数完整签名见公开类型视图。

    事件参数完整签名见公开类型视图。

  • $router.push: (NonNullable<AsamSkeletonExpose["$router"]>)["push"] — 依赖声明

    通过向历史栈添加记录，以编程方式导航到新 URL。

    事件参数：(to: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["push"]>, (...args: never[]) => unknown>>[0]): ReturnType<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["push"]>, (...args: never[]) => unknown>>

  • $router.replace: (NonNullable<AsamSkeletonExpose["$router"]>)["replace"] — 依赖声明

    通过替换历史栈中的当前记录，以编程方式导航到新 URL。

    事件参数：(to: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["replace"]>, (...args: never[]) => unknown>>[0]): ReturnType<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["replace"]>, (...args: never[]) => unknown>>

  • $router.back: () => void — 依赖声明

    通过 history.back() 在可用时后退，等价于 router.go(-1)。

    事件参数：(): void

  • $router.forward: () => void — 依赖声明

    通过 history.forward() 在可用时前进，等价于 router.go(1)。

    事件参数：(): void

  • $router.go: (delta: number) => void — 依赖声明

    通过调用 history.go() 在历史记录中前进或后退。

    事件参数：(delta: number): void

  • $router.beforeEach: (NonNullable<AsamSkeletonExpose["$router"]>)["beforeEach"] — 依赖声明

    添加每次导航之前执行的守卫，并返回移除此守卫的函数。

    事件参数：(guard: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["beforeEach"]>, (...args: never[]) => unknown>>[0]): () => void

  • $router.beforeResolve: (NonNullable<AsamSkeletonExpose["$router"]>)["beforeResolve"] — 依赖声明

    添加导航确认之前执行的守卫，此时组件已获取且其他导航守卫已通过；返回移除此守卫的函数。

    事件参数：(guard: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["beforeResolve"]>, (...args: never[]) => unknown>>[0]): () => void

  • $router.afterEach: (NonNullable<AsamSkeletonExpose["$router"]>)["afterEach"] — 依赖声明

    添加每次导航结束后执行的钩子，并返回移除此钩子的函数。

    事件参数：(guard: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["afterEach"]>, (...args: never[]) => unknown>>[0]): () => void

  • $router.onError: (NonNullable<AsamSkeletonExpose["$router"]>)["onError"] — 依赖声明

    添加导航期间未捕获错误的处理函数，涵盖同步和异步异常、守卫返回或传给 next 的错误，以及路由异步组件解析错误。

    事件参数：(handler: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["onError"]>, (...args: never[]) => unknown>>[0]): () => void

  • $router.isReady: () => Promise<void> — 依赖声明

    返回在初次导航完成后兑现的 Promise，此时关联的异步进入钩子与异步组件均已解析；导航已完成时立即兑现。可用于保持服务端与客户端渲染一致；服务端需手动推入初始位置，客户端从 URL 自动读取。

    事件参数：(): Promise<void>

  • $router.install: (app: App) => void — 依赖声明

    由 app.use(router) 自动调用，用户不应手动调用；客户端调用时会触发初次导航。

    事件参数：(app: App<any>): void

AsamSkeletonExpose 公开类型视图
ts
import type { ComponentPublicInstance, ComponentOptionsBase, ComponentProvideOptions, Ref, ComponentOptionsMixin, GlobalComponents, GlobalDirectives, WatchOptions, WatchStopHandle, ShallowRef, App } from 'vue';
import type { AsamSkeletonExpose, AsamTableColumnExpose, AsamSkeletonProps, AsamSkeletonSlots } from '@asam-ui/ui';

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

// AsamSkeletonExpose
type PublicContract = {
	"$": AsamSkeletonExpose["$"];
	"$data": AsamTableColumnExpose;
	"$props": AsamSkeletonProps;
	"$attrs": AsamSkeletonExpose["$attrs"];
	"$refs": AsamSkeletonExpose["$refs"];
	"$slots": AsamSkeletonSlots;
	"$root": ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, ComponentProvideOptions>, {}, {}, "", {}, any> | null;
	"$parent": ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, ComponentProvideOptions>, {}, {}, "", {}, any> | null;
	"$host": Element | null;
	"$emit": (event: string, ...args: any[]) => void;
	"$el": any;
	"$options": (AsamSkeletonExpose)["$options"];
	"$forceUpdate": () => void;
	"$nextTick": (AsamSkeletonExpose)["$nextTick"];
	"$watch": (AsamSkeletonExpose)["$watch"];
	readonly "loading": boolean;
	readonly "rows": number;
	readonly "count": number;
	readonly "animated"?: boolean | undefined;
	readonly "throttle"?: (AsamSkeletonExpose)["throttle"];
	"uiLoading": boolean;
	"$route": AsamSkeletonExpose["$route"];
	"$router": AsamSkeletonExpose["$router"];
};

参数与事件说明

$

必填：是；声明来源：依赖声明。

$ 参数与事件数据

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

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

$data

必填：是；声明来源：依赖声明。

$props

必填：是；声明来源：依赖声明。

$attrs

必填：是；声明来源：依赖声明。

$attrs 参数与事件数据

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

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

$refs

必填：是；声明来源：依赖声明。

$refs 参数与事件数据

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

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

$slots

必填：是；声明来源：依赖声明。

$root

必填：是；声明来源：依赖声明。

$parent

必填：是；声明来源：依赖声明。

$host

必填：是；声明来源：依赖声明。

$host 参数与事件数据

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

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

$emit

必填：是；声明来源：依赖声明。

$emit 参数与事件数据

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

事件参数：(event: string, ...args: any[]): void

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

$el

必填：是；声明来源：依赖声明。

$options

必填：是；声明来源：依赖声明。

$forceUpdate

必填：是；声明来源：依赖声明。

$forceUpdate 参数与事件数据

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

事件参数：(): void

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

$nextTick

必填：是；声明来源：依赖声明。

$nextTick 参数与事件数据

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

事件参数：(): Promise<void>

事件参数：<T, R>(this: T, fn: (this: T) => R | Promise<R>): Promise<R>

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

$watch

必填：是；声明来源：依赖声明。

$watch 参数与事件数据

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

事件参数：<T extends string | ((...args: any) => any)>(source: T, cb: Parameters<Extract<NonNullable<(AsamSkeletonInstance)["$watch"]>, (...args: never[]) => unknown>>[1], options?: WatchOptions<boolean> | undefined): WatchStopHandle

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

loading

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

loading 参数与事件数据

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

枚举：false / true

rows

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

count

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

animated

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

animated 参数与事件数据

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

枚举：false / true

throttle

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

throttle 参数与事件数据

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

  • throttle.leading: number | undefined — 上游声明
  • throttle.trailing: number | undefined — 上游声明
  • throttle.initVal: boolean | undefined — 上游声明

    枚举：false / true

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

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

uiLoading

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

uiLoading 参数与事件数据

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

枚举：false / true

$route

必填：是；声明来源：依赖声明。

$route 参数与事件数据

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

  • $route.matched: (NonNullable<AsamSkeletonExpose["$route"]>)["matched"] — 依赖声明

    仅包含普通组件的 RouteLocationMatched 数组；懒加载组件已解析并替换 components 中的值，可直接展示路由，不包含重定向记录。此属性不可枚举。

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

  • $route.name: (NonNullable<AsamSkeletonExpose["$route"]>)["name"] — 依赖声明

    匹配路由记录的名称。

  • $route.fullPath: string — 依赖声明

    包含 search 和 hash 的完整位置字符串，使用百分号编码。

  • $route.query: (NonNullable<AsamSkeletonExpose["$route"]>)["query"] — 依赖声明

    当前位置 search 属性的对象表示。

  • $route.hash: string — 依赖声明

    当前位置的哈希片段；存在时以 # 开头。

  • $route.redirectedFrom: (NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"] — 依赖声明

    最终到达当前位置之前，最初尝试访问的位置。

    • $route.redirectedFrom.matched: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "matched"> — 依赖声明

      包含添加路由时原始组件的 RouteRecord 数组，也可能包含重定向记录，不能直接用于展示。此属性不可枚举。

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

    • $route.redirectedFrom.fullPath: string — 依赖声明

      包含 search 和 hash 的完整位置字符串，使用百分号编码。

    • $route.redirectedFrom.query: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "query"> — 依赖声明

      当前位置 search 属性的对象表示。

    • $route.redirectedFrom.hash: string — 依赖声明

      当前位置的哈希片段；存在时以 # 开头。

    • $route.redirectedFrom.redirectedFrom: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "redirectedFrom"> — 依赖声明

      最终到达当前位置之前，最初尝试访问的位置。

      嵌套展开边界：递归引用；完整类型见公开类型视图。

    • $route.redirectedFrom.name: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "name"> — 依赖声明

      匹配路由记录的名称。

    • $route.redirectedFrom.meta: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "meta"> — 依赖声明

      全部匹配路由记录合并后的 meta 属性。

    • $route.redirectedFrom.params: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "params"> — 依赖声明

      从 path 提取并解码后的参数对象。

    • $route.redirectedFrom.path: string — 依赖声明

      URL 中经过百分号编码的路径部分。

    • $route.redirectedFrom.replace: boolean | undefined — 依赖声明

      替换当前历史记录，而不是添加新记录。

      枚举：false / true

    • $route.redirectedFrom.force: boolean | undefined — 依赖声明

      即使目标与当前位置相同，也触发导航；除非传入 replace: true，否则会添加一条历史记录。

      枚举：false / true

    • $route.redirectedFrom.state: PublicMember<NonNullable<(NonNullable<AsamSkeletonExpose["$route"]>)["redirectedFrom"]>, "state"> — 依赖声明

      通过 History API 保存的状态；不能包含响应式值，也不允许 Symbol 等部分值。详情参见 https://developer.mozilla.org/zh-CN/docs/Web/API/History/state。

  • $route.meta: (NonNullable<AsamSkeletonExpose["$route"]>)["meta"] — 依赖声明

    全部匹配路由记录合并后的 meta 属性。

  • $route.params: (NonNullable<AsamSkeletonExpose["$route"]>)["params"] — 依赖声明

    从 path 提取并解码后的参数对象。

  • $route.path: string — 依赖声明

    URL 中经过百分号编码的路径部分。

$router

必填：是；声明来源：依赖声明。

$router 参数与事件数据

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

  • $router.options: (NonNullable<AsamSkeletonExpose["$router"]>)["options"] — 依赖声明

    创建路由器时传入的原始配置对象。

    • $router.options.routes: (NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["routes"] — 依赖声明

      需要添加到路由器的初始路由列表。

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

    • $router.options.history: (NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"] — 依赖声明

      路由器使用的历史记录实现。通常使用 createWebHistory，并配置服务器回退；createWebHashHistory 无需服务器配置，但搜索引擎无法处理其哈希路由，影响搜索优化。

      • $router.options.history.base: string — 依赖声明

        添加到每个 URL 前的基础路径；例如 base 为 /sub-folder 时，可将单页应用部署在域名的对应子目录。

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.location: string — 依赖声明

        当前历史记录位置。

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.state: (NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["state"] — 依赖声明

        当前历史记录状态。

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.push: (NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["push"] — 依赖声明

        导航到指定位置；使用 HTML5 History 时，通过 history.pushState 实际更新 URL。

        事件参数：(to: string, data?: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["push"]>, (...args: never[]) => unknown>>[1]): void

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.replace: (NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["replace"] — 依赖声明

        与 RouterHistory.push 类似，但调用 history.replaceState，而非 history.pushState。

        事件参数：(to: string, data?: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["replace"]>, (...args: never[]) => unknown>>[1]): void

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.go: (delta: number, triggerListeners?: boolean) => void — 依赖声明

        按指定方向遍历历史记录。

        事件参数：(delta: number, triggerListeners?: boolean | undefined): void

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.listen: (NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["listen"] — 依赖声明

        为历史记录实现添加监听器；由浏览器前进、后退等外部导航，或传入 true 的 RouterHistory.back、RouterHistory.forward 触发。

        事件参数：(callback: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["listen"]>, (...args: never[]) => unknown>>[0]): () => void

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.createHref: (NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["history"]>)["createHref"] — 依赖声明

        生成用于链接元素的对应 href。

        事件参数：(location: string): string

        嵌套展开边界：深度上限；完整类型见公开类型视图。

      • $router.options.history.destroy: () => void — 依赖声明

        清除历史记录实现注册的全部事件监听器。

        事件参数：(): void

        嵌套展开边界：深度上限；完整类型见公开类型视图。

    • $router.options.scrollBehavior: (NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["scrollBehavior"] — 依赖声明

      控制页面导航时滚动行为的函数；可返回 Promise 延迟滚动。

      事件参数：(to: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["scrollBehavior"]>, (...args: never[]) => unknown>>[0], from: AsamSkeletonExpose["$route"], savedPosition: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["scrollBehavior"]>, (...args: never[]) => unknown>>[2]): ReturnType<Extract<NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["scrollBehavior"]>, (...args: never[]) => unknown>>

    • $router.options.parseQuery: (NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["parseQuery"] — 依赖声明

      自定义查询参数解析函数；与 EXPERIMENTAL_RouterOptions_Base.stringifyQuery 配套。

      事件参数：(search: string): ReturnType<Extract<NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["parseQuery"]>, (...args: never[]) => unknown>>

    • $router.options.stringifyQuery: (NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["stringifyQuery"] — 依赖声明

      自定义查询对象序列化函数；不要添加开头的 ?，与 parseQuery 的解析函数配套。

      事件参数：(query: Parameters<Extract<NonNullable<(NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["options"]>)["stringifyQuery"]>, (...args: never[]) => unknown>>[0]): string

    • $router.options.linkActiveClass: string | undefined — 依赖声明

      应用于激活 RouterLink 的默认类名；未指定时使用 router-link-active。

    • $router.options.linkExactActiveClass: string | undefined — 依赖声明

      应用于精确激活 RouterLink 的默认类名；未指定时使用 router-link-exact-active。

    • $router.options.end: boolean | undefined — 依赖声明

      是否在表达式末尾添加 $，使其匹配到路径结尾。

      声明默认：`true`（注释，实际运行默认以源码/安装包为准）

      枚举：false / true

    • $router.options.sensitive: boolean | undefined — 依赖声明

      使正则表达式区分大小写。

      声明默认：`false`（注释，实际运行默认以源码/安装包为准）

      枚举：false / true

    • $router.options.strict: boolean | undefined — 依赖声明

      是否禁止路径末尾的斜杠。

      声明默认：`false`（注释，实际运行默认以源码/安装包为准）

      枚举：false / true

  • $router.addRoute: (NonNullable<AsamSkeletonExpose["$router"]>)["addRoute"] — 依赖声明

    向已有路由添加子路由，或向路由器添加新的 RouteRecordRaw 路由记录。

    事件参数完整签名见公开类型视图。

    事件参数完整签名见公开类型视图。

  • $router.removeRoute: (NonNullable<AsamSkeletonExpose["$router"]>)["removeRoute"] — 依赖声明

    按名称移除已有路由。

    事件参数：(name: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["removeRoute"]>, (...args: never[]) => unknown>>[0]): void

  • $router.clearRoutes: () => void — 依赖声明

    从路由器中删除全部路由。

    事件参数：(): void

  • $router.currentRoute: ShallowRef<AsamSkeletonExpose["$route"]> — 依赖声明

    当前 RouteLocationNormalized。

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

  • $router.listening: boolean — 依赖声明

    允许关闭历史事件监听，这是用于微前端的底层 API。

    枚举：false / true

  • $router.hasRoute: (NonNullable<AsamSkeletonExpose["$router"]>)["hasRoute"] — 依赖声明

    检查指定名称的路由是否存在。

    事件参数：(name: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["hasRoute"]>, (...args: never[]) => unknown>>[0]): boolean

  • $router.getRoutes: (NonNullable<AsamSkeletonExpose["$router"]>)["getRoutes"] — 依赖声明

    获取全部 RouteRecord 路由记录的完整列表。

    事件参数：(): ReturnType<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["getRoutes"]>, (...args: never[]) => unknown>>

  • $router.resolve: (NonNullable<AsamSkeletonExpose["$router"]>)["resolve"] — 依赖声明

    返回 RouteLocationRaw 的规范化位置，包含带基础路径的 href；默认使用 router.currentRoute 作为 currentLocation，仅在高级场景中覆盖。

    事件参数完整签名见公开类型视图。

    事件参数完整签名见公开类型视图。

  • $router.push: (NonNullable<AsamSkeletonExpose["$router"]>)["push"] — 依赖声明

    通过向历史栈添加记录，以编程方式导航到新 URL。

    事件参数：(to: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["push"]>, (...args: never[]) => unknown>>[0]): ReturnType<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["push"]>, (...args: never[]) => unknown>>

  • $router.replace: (NonNullable<AsamSkeletonExpose["$router"]>)["replace"] — 依赖声明

    通过替换历史栈中的当前记录，以编程方式导航到新 URL。

    事件参数：(to: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["replace"]>, (...args: never[]) => unknown>>[0]): ReturnType<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["replace"]>, (...args: never[]) => unknown>>

  • $router.back: () => void — 依赖声明

    通过 history.back() 在可用时后退，等价于 router.go(-1)。

    事件参数：(): void

  • $router.forward: () => void — 依赖声明

    通过 history.forward() 在可用时前进，等价于 router.go(1)。

    事件参数：(): void

  • $router.go: (delta: number) => void — 依赖声明

    通过调用 history.go() 在历史记录中前进或后退。

    事件参数：(delta: number): void

  • $router.beforeEach: (NonNullable<AsamSkeletonExpose["$router"]>)["beforeEach"] — 依赖声明

    添加每次导航之前执行的守卫，并返回移除此守卫的函数。

    事件参数：(guard: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["beforeEach"]>, (...args: never[]) => unknown>>[0]): () => void

  • $router.beforeResolve: (NonNullable<AsamSkeletonExpose["$router"]>)["beforeResolve"] — 依赖声明

    添加导航确认之前执行的守卫，此时组件已获取且其他导航守卫已通过；返回移除此守卫的函数。

    事件参数：(guard: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["beforeResolve"]>, (...args: never[]) => unknown>>[0]): () => void

  • $router.afterEach: (NonNullable<AsamSkeletonExpose["$router"]>)["afterEach"] — 依赖声明

    添加每次导航结束后执行的钩子，并返回移除此钩子的函数。

    事件参数：(guard: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["afterEach"]>, (...args: never[]) => unknown>>[0]): () => void

  • $router.onError: (NonNullable<AsamSkeletonExpose["$router"]>)["onError"] — 依赖声明

    添加导航期间未捕获错误的处理函数，涵盖同步和异步异常、守卫返回或传给 next 的错误，以及路由异步组件解析错误。

    事件参数：(handler: Parameters<Extract<NonNullable<(NonNullable<AsamSkeletonExpose["$router"]>)["onError"]>, (...args: never[]) => unknown>>[0]): () => void

  • $router.isReady: () => Promise<void> — 依赖声明

    返回在初次导航完成后兑现的 Promise，此时关联的异步进入钩子与异步组件均已解析；导航已完成时立即兑现。可用于保持服务端与客户端渲染一致；服务端需手动推入初始位置，客户端从 URL 自动读取。

    事件参数：(): Promise<void>

  • $router.install: (app: App) => void — 依赖声明

    由 app.use(router) 自动调用，用户不应手动调用；客户端调用时会触发初次导航。

    事件参数：(app: App<any>): void

AsamSkeletonInstance 公开类型视图
ts
import type { ComponentPublicInstance, ComponentOptionsBase, ComponentProvideOptions, Ref, ComponentOptionsMixin, GlobalComponents, GlobalDirectives, WatchOptions, WatchStopHandle, ShallowRef, App } from 'vue';
import type { AsamSkeletonInstance, AsamSkeletonExpose, AsamTableColumnExpose, AsamSkeletonProps, AsamSkeletonSlots } from '@asam-ui/ui';

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

// AsamSkeletonInstance
type PublicContract = {
	"$": AsamSkeletonExpose["$"];
	"$data": AsamTableColumnExpose;
	"$props": AsamSkeletonProps;
	"$attrs": AsamSkeletonExpose["$attrs"];
	"$refs": AsamSkeletonExpose["$refs"];
	"$slots": AsamSkeletonSlots;
	"$root": ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, ComponentProvideOptions>, {}, {}, "", {}, any> | null;
	"$parent": ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, ComponentProvideOptions>, {}, {}, "", {}, any> | null;
	"$host": Element | null;
	"$emit": (event: string, ...args: any[]) => void;
	"$el": any;
	"$options": (AsamSkeletonInstance)["$options"];
	"$forceUpdate": () => void;
	"$nextTick": (AsamSkeletonInstance)["$nextTick"];
	"$watch": (AsamSkeletonInstance)["$watch"];
	readonly "loading": boolean;
	readonly "rows": number;
	readonly "count": number;
	readonly "animated"?: boolean | undefined;
	readonly "throttle"?: (AsamSkeletonInstance)["throttle"];
	"uiLoading": boolean;
	"$route": AsamSkeletonExpose["$route"];
	"$router": AsamSkeletonExpose["$router"];
};

作用域插槽保留上游实例契约。

参数与事件说明

template

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

template 参数与事件数据

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

事件参数：(props: { key: number; }): any

default

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

default 参数与事件数据

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

事件参数：(props: AsamTableColumnExpose): any

AsamSkeletonSlots 公开类型视图
ts
import type { AsamSkeletonSlots, AsamSkeletonExpose, AsamTableColumnExpose } from '@asam-ui/ui';

// AsamSkeletonSlots
type PublicContract = {
	"template"?: (AsamSkeletonSlots)["template"];
	"default"?: (AsamSkeletonSlots)["default"];
	readonly [key: string]: import("vue").Slot<any> | undefined;
};

参数与事件说明

variant

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

variant 参数与事件数据

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

枚举："text" / "button" / "circle" / "image" / "caption" / "h1" / "h3" / "p" / "rect"

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

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

AsamSkeletonItemPropsPublic 公开类型视图
ts
import type { AsamSkeletonItemPropsPublic } from '@asam-ui/ui';

// AsamSkeletonItemPropsPublic
type PublicContract = {
	readonly "variant"?: (AsamSkeletonItemPropsPublic)["variant"];
};

参数与事件说明

loading

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

loading 参数与事件数据

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

枚举：false / true

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

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

animated

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

animated 参数与事件数据

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

枚举：false / true

count

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

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

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

rows

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

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

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

throttle

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

throttle 参数与事件数据

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

  • throttle.leading: number | undefined — 上游声明
  • throttle.trailing: number | undefined — 上游声明
  • throttle.initVal: boolean | undefined — 上游声明

    枚举：false / true

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

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

AsamSkeletonPropsPublic 公开类型视图
ts
import type { AsamSkeletonPropsPublic, AsamSkeletonProps } from '@asam-ui/ui';

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

// AsamSkeletonPropsPublic
type PublicContract = {
	readonly "loading"?: (AsamSkeletonPropsPublic)["loading"];
	readonly "animated"?: boolean | undefined;
	readonly "count"?: number | undefined;
	readonly "rows"?: number | undefined;
	readonly "throttle"?: (AsamSkeletonPropsPublic)["throttle"];
};

搜索文档

Tab 选择结果 Enter 打开 Esc 关闭