@sdata/web-vue 1.11.1 → 1.13.0

package/es/anchor/anchor-link.vue_vue_type_script_lang.js

@@ -5,7 +5,15 @@ import { computed, defineComponent, inject, onMounted, ref } from "vue";
 var anchor_link_vue_vue_type_script_lang_default = defineComponent({
 	name: "AnchorLink",
 	props: {
+		/**
+		* @zh 锚点链接的文本内容
+		* @en The text content of the anchor link
+		*/
 		title: String,
+		/**
+		* @zh 锚点链接的地址
+		* @en The address of the anchor link
+		*/
 		href: String
 	},
 	setup(props) {

package/es/anchor/anchor.vue_vue_type_script_lang.js

@@ -16,6 +16,11 @@ var BOUNDARY_POSITIONS = [
 var anchor_vue_vue_type_script_lang_default = defineComponent({
 	name: "Anchor",
 	props: {
+		/**
+		* @zh 滚动边界值，设置该值为数字后，将会在距离滚动容器 `boundary` 距离时停止滚动。
+		* @en Scrolling boundary value. After setting the value to a number, it will stop scrolling when the distance is `boundary` from the scrolling container.
+		* @values 'start', 'end', 'center', 'nearest', number
+		*/
 		boundary: {
 			type: [Number, String],
 			default: "start",
@@ -23,22 +28,49 @@ var anchor_vue_vue_type_script_lang_default = defineComponent({
 				return isNumber(value) || BOUNDARY_POSITIONS.includes(value);
 			}
 		},
+		/**
+		* @zh 是否显示左侧轴线
+		* @en Whether to show the left axis
+		*/
 		lineLess: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 滚动容器
+		* @en Scroll container
+		*/
 		scrollContainer: { type: [String, Object] },
+		/**
+		* @zh 是否改变hash。设置为 `false` 时点击锚点不会改变页面的 hash
+		* @en Whether to change the hash. When set to `false`, clicking on the anchor will not change the hash of the page
+		*/
 		changeHash: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否使用平滑滚动
+		* @en Whether to use smooth scrolling
+		*/
 		smooth: {
 			type: Boolean,
 			default: true
 		}
 	},
 	emits: {
+		/**
+		* @zh 用户点击链接时触发
+		* @en Triggered when the user clicks on the link
+		* @property { string | undefined } hash
+		* @property {string} preHash
+		*/
 		select: (_hash, _preHash) => true,
+		/**
+		* @zh 链接发生改变时触发
+		* @en Triggered when the link changes
+		* @property {string} hash
+		*/
 		change: (_hash) => true
 	},
 	setup(props, { emit }) {

package/es/auto-complete/auto-complete.d.ts

@@ -93,9 +93,9 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         type: PropType<VirtualListProps>;
     };
 }>> & Readonly<{
+    onSearch?: ((_value: string) => any) | undefined;
     onChange?: ((_value: string) => any) | undefined;
     onClear?: ((_ev: Event) => any) | undefined;
-    onSearch?: ((_value: string) => any) | undefined;
     onSelect?: ((_value: string) => any) | undefined;
     "onUpdate:modelValue"?: ((_value: string) => any) | undefined;
     onDropdownScroll?: ((_ev: Event) => any) | undefined;

package/es/auto-complete/auto-complete.js

@@ -3,6 +3,7 @@ import { getPrefixCls } from "../_utils/global-config.js";
 import { isFunction, isNull, isUndefined } from "../_utils/is.js";
 import virtual_list_default from "../_components/virtual-list/index.js";
 import { useAllowClear } from "../_hooks/use-allow-clear.js";
+import { useDropdownVirtualListProps } from "../_hooks/use-dropdown-virtual-list-props.js";
 import { resolveDropdownVirtualListProps } from "../_utils/virtual-dropdown.js";
 import Input from "../input/index.js";
 import { getKeyFromValue } from "../select/utils.js";
@@ -17,47 +18,137 @@ var auto_complete_default = /* @__PURE__ */ defineComponent({
 	name: "AutoComplete",
 	inheritAttrs: false,
 	props: {
+		/**
+		* @zh 绑定值
+		* @en Value
+		* @vModel
+		*/
 		modelValue: {
 			type: String,
 			default: void 0
 		},
+		/**
+		* @zh 默认值（非受控模式）
+		* @en Default value (uncontrolled mode)
+		*/
 		defaultValue: {
 			type: String,
 			default: ""
 		},
+		/**
+		* @zh 是否禁用
+		* @en Whether to disable
+		*/
 		disabled: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 用于自动提示的数据
+		* @en Data used for auto-complete
+		*/
 		data: {
 			type: Array,
 			default: () => []
 		},
+		/**
+		* @zh 弹出框的挂载容器
+		* @en Mount container for popup
+		*/
 		popupContainer: { type: [String, Object] },
+		/**
+		* @zh 是否为严格校验模式
+		* @en Whether it is strict verification mode
+		*/
 		strict: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 自定义选项过滤方法
+		* @en Custom option filtering method
+		*/
 		filterOption: {
 			type: [Boolean, Function],
 			default: true
 		},
+		/**
+		* @zh trigger 组件属性
+		* @en trigger props
+		* @version 2.14.0
+		*/
 		triggerProps: { type: Object },
+		/**
+		* @zh 是否允许清空输入框
+		* @en Whether to allow the input to be cleared
+		* @version 2.23.0
+		*/
 		allowClear: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 传递虚拟列表属性，传入此参数以开启虚拟滚动 [VirtualListProps](#VirtualListProps)
+		* @en Pass the virtual list attribute, pass in this parameter to turn on virtual scrolling [VirtualListProps](#VirtualListProps)
+		* @type VirtualListProps
+		* @version 2.50.0
+		*/
 		virtualListProps: { type: Object }
 	},
 	emits: {
 		"update:modelValue": (_value) => true,
+		/**
+		* @zh 绑定值发生改变时触发
+		* @en Emitted when the value changes
+		* @property {string} value
+		*/
 		"change": (_value) => true,
+		/**
+		* @zh 用户搜索时触发
+		* @en Emitted when the user searches
+		* @property {string} value
+		*/
 		"search": (_value) => true,
+		/**
+		* @zh 选择选项时触发
+		* @en Emitted when an option is selected
+		* @property {string} value
+		*/
 		"select": (_value) => true,
+		/**
+		* @zh 用户点击清除按钮时触发
+		* @en Triggered when the user clicks the clear button
+		* @param {Event} ev
+		* @version 2.23.0
+		*/
 		"clear": (_ev) => true,
+		/**
+		* @zh 下拉菜单发生滚动时触发
+		* @en Triggered when the drop-down scrolls
+		* @param {Event} ev
+		* @version 2.52.0
+		*/
 		"dropdownScroll": (_ev) => true,
+		/**
+		* @zh 下拉菜单滚动到底部时触发
+		* @en Triggered when the drop-down menu is scrolled to the bottom
+		* @param {Event} ev
+		* @version 2.52.0
+		*/
 		"dropdownReachBottom": (_ev) => true
 	},
+	/**
+	* @zh 弹出框的页脚
+	* @en The footer of the popup menu box
+	* @slot footer
+	*/
+	/**
+	* @zh 选项内容
+	* @en Display content of options
+	* @slot option
+	* @binding {OptionInfo} data
+	* @version 2.13.0
+	*/
 	setup(props, { emit, attrs, slots }) {
 		const { modelValue, allowClear } = toRefs(props);
 		const prefixCls = getPrefixCls("auto-complete");
@@ -79,9 +170,10 @@ var auto_complete_default = /* @__PURE__ */ defineComponent({
 		const _popupVisible = ref(false);
 		const computedPopupVisible = computed(() => _popupVisible.value && validOptionInfos.value.length > 0);
 		const virtualListRef = ref();
-		const component = computed(() => props.virtualListProps ? "div" : "li");
+		const { mergedDropdownVirtualListProps } = useDropdownVirtualListProps(computed(() => props.virtualListProps));
+		const component = computed(() => mergedDropdownVirtualListProps.value ? "div" : "li");
 		const resolvedVirtualListProps = computed(() => {
-			return resolveDropdownVirtualListProps(props.virtualListProps, props.triggerProps, DEFAULT_AUTOCOMPLETE_VIRTUAL_ITEM_SIZE);
+			return resolveDropdownVirtualListProps(mergedDropdownVirtualListProps.value, props.triggerProps, DEFAULT_AUTOCOMPLETE_VIRTUAL_ITEM_SIZE);
 		});
 		const handlePopupVisibleChange = (popupVisible) => {
 			_popupVisible.value = popupVisible;
@@ -162,7 +254,7 @@ var auto_complete_default = /* @__PURE__ */ defineComponent({
 			return createVNode(select_dropdown_default, {
 				"ref": dropdownRef,
 				"class": `${prefixCls}-dropdown`,
-				"virtualList": Boolean(props.virtualListProps),
+				"virtualList": Boolean(resolvedVirtualListProps.value),
 				"onScroll": handleDropdownScroll,
 				"onReachBottom": handleDropdownReachBottom
 			}, {
@@ -202,10 +294,22 @@ var auto_complete_default = /* @__PURE__ */ defineComponent({
 		};
 	},
 	methods: {
+		/**
+		* @zh 使输入框获取焦点
+		* @en Make the input box focus
+		* @public
+		* @version 2.40.0
+		*/
 		focus() {
 			var _this$inputRef;
 			(_this$inputRef = this.inputRef) === null || _this$inputRef === void 0 || _this$inputRef.focus();
 		},
+		/**
+		* @zh 使输入框失去焦点
+		* @en Make the input box lose focus
+		* @public
+		* @version 2.40.0
+		*/
 		blur() {
 			var _this$inputRef2;
 			(_this$inputRef2 = this.inputRef) === null || _this$inputRef2 === void 0 || _this$inputRef2.blur();

package/es/auto-complete/index.d.ts

@@ -50,9 +50,9 @@ declare const AutoComplete: {
             type: import("vue").PropType<import("../_components/virtual-list/interface").VirtualListProps>;
         };
     }>> & Readonly<{
+        onSearch?: ((_value: string) => any) | undefined;
         onChange?: ((_value: string) => any) | undefined;
         onClear?: ((_ev: Event) => any) | undefined;
-        onSearch?: ((_value: string) => any) | undefined;
         onSelect?: ((_value: string) => any) | undefined;
         "onUpdate:modelValue"?: ((_value: string) => any) | undefined;
         onDropdownScroll?: ((_ev: Event) => any) | undefined;
@@ -125,9 +125,9 @@ declare const AutoComplete: {
             type: import("vue").PropType<import("../_components/virtual-list/interface").VirtualListProps>;
         };
     }>> & Readonly<{
+        onSearch?: ((_value: string) => any) | undefined;
         onChange?: ((_value: string) => any) | undefined;
         onClear?: ((_ev: Event) => any) | undefined;
-        onSearch?: ((_value: string) => any) | undefined;
         onSelect?: ((_value: string) => any) | undefined;
         "onUpdate:modelValue"?: ((_value: string) => any) | undefined;
         onDropdownScroll?: ((_ev: Event) => any) | undefined;
@@ -189,9 +189,9 @@ declare const AutoComplete: {
         type: import("vue").PropType<import("../_components/virtual-list/interface").VirtualListProps>;
     };
 }>> & Readonly<{
+    onSearch?: ((_value: string) => any) | undefined;
     onChange?: ((_value: string) => any) | undefined;
     onClear?: ((_ev: Event) => any) | undefined;
-    onSearch?: ((_value: string) => any) | undefined;
     onSelect?: ((_value: string) => any) | undefined;
     "onUpdate:modelValue"?: ((_value: string) => any) | undefined;
     onDropdownScroll?: ((_ev: Event) => any) | undefined;

package/es/avatar/avatar-group.js

@@ -9,24 +9,55 @@ import { computed, createTextVNode, createVNode, defineComponent, inject, provid
 var AvatarGroup = /* @__PURE__ */ defineComponent({
 	name: "AvatarGroup",
 	props: {
+		/**
+		* @zh 头像的形状，有圆形(circle)和正方形(square)两种
+		* @en The shape of the avatar in the group, there are two kinds of circle (circle) and square (square)
+		* @values 'circle', 'square'
+		*/
 		shape: {
 			type: String,
 			default: "circle"
 		},
+		/**
+		* @zh 头像的尺寸大小，单位是 `px`
+		* @en The size of the avatar in the group, the unit is `px`
+		*/
 		size: Number,
+		/**
+		* @zh 是否自动根据头像尺寸调整字体大小
+		* @en Whether to automatically adjust the font size according to the size of the avatar.
+		*/
 		autoFixFontSize: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 头像组最多显示的头像数量，多余头像将以 `+x` 的形式展示。
+		* @en The maximum number of avatars displayed in the avatar group. The excess avatars will be displayed in the form of `+x`.
+		*/
 		maxCount: {
 			type: Number,
 			default: 0
 		},
+		/**
+		* @zh 头像组内的头像 `z-index` 递增，默认是递减。
+		* @en The avatar `z-index` in the avatar group increases, and the default is decreasing.
+		*/
 		zIndexAscend: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 多余头像样式。
+		* @en Style for +x.
+		* @version 2.7.0
+		*/
 		maxStyle: { type: Object },
+		/**
+		* @zh 多余头像气泡的 `TriggerProps`
+		* @en TriggerProps for popover around +x.
+		* @version 2.7.0
+		*/
 		maxPopoverTriggerProps: { type: Object }
 	},
 	setup(props, { slots }) {

package/es/avatar/avatar.vue_vue_type_script_lang.js

@@ -1,5 +1,5 @@
 import { configProviderInjectionKey } from "../config-provider/context.js";
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { getPrefixCls } from "../_utils/global-config.js";
 import { isNumber } from "../_utils/is.js";
 import IconLoading from "../icon/icon-loading/index.js";
@@ -17,28 +17,78 @@ var avatar_vue_vue_type_script_lang_default = defineComponent({
 		IconLoading
 	},
 	props: {
+		/**
+		* @zh 头像的形状，有圆形(circle)和正方形(square)两种
+		* @en The shape of the avatar, there are two kinds of circle (circle) and square (square)
+		* @values 'circle', 'square'
+		*/
 		shape: {
 			type: String,
 			default: "circle"
 		},
+		/**
+		* @zh 自定义头像图片地址，如果传入该属性，会默认渲染img标签
+		* @en Custom avatar image address. If this attribute is passed in, the img tag will be rendered by default
+		* @version 2.40.0
+		*/
 		imageUrl: String,
+		/**
+		* @zh 头像的尺寸大小，单位是 `px`。未填写时使用样式中的大小 `40px`
+		* @en The size of the avatar, the unit is `px`. Use size `40px` in styles when not filled
+		*/
 		size: Number,
+		/**
+		* @zh 是否自动根据头像尺寸调整字体大小
+		* @en Whether to automatically adjust the font size according to the size of the avatar.
+		*/
 		autoFixFontSize: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 可点击的头像交互类型
+		* @en Clickable avatar interaction type
+		* @values 'mask', 'button'
+		*/
 		triggerType: {
 			type: String,
 			default: "button"
 		},
+		/**
+		* @zh 交互图标的样式
+		* @en Interactive icon style
+		*/
 		triggerIconStyle: { type: Object },
+		/**
+		* @zh 图片在容器内的的适应类型
+		* @en Object-fit type of the image in the container
+		* @version 2.52.0
+		*/
 		objectFit: { type: String }
 	},
 	emits: {
+		/**
+		* @zh 点击回调
+		* @en Callback when clicked
+		* @param {MouseEvent} ev
+		*/
 		click: (_ev) => true,
+		/**
+		* @zh 图片加载错误
+		* @en image load error
+		*/
 		error: () => true,
+		/**
+		* @zh 图片加载成功
+		* @en image load success
+		*/
 		load: () => true
 	},
+	/**
+	* @zh 可点击的头像交互图标
+	* @en Clickable avatar interaction icon
+	* @slot trigger-icon
+	*/
 	setup(props, { slots, emit, attrs }) {
 		const { shape, size, autoFixFontSize, triggerType, triggerIconStyle } = toRefs(props);
 		const prefixCls = getPrefixCls("avatar");

package/es/back-top/back-top.vue_vue_type_script_lang.js

@@ -10,15 +10,31 @@ var back_top_vue_vue_type_script_lang_default = defineComponent({
 	name: "BackTop",
 	components: { IconToTop },
 	props: {
+		/**
+		* @zh 显示回到顶部按钮的触发滚动高度
+		* @en Display the trigger scroll height of the back to top button
+		*/
 		visibleHeight: {
 			type: Number,
 			default: 200
 		},
+		/**
+		* @zh 滚动事件的监听容器
+		* @en Scroll event listener container
+		*/
 		targetContainer: { type: [String, Object] },
+		/**
+		* @zh 滚动动画的缓动方式，可选值参考 [BTween](https://github.com/PengJiyuan/b-tween)
+		* @en Easing mode of scrolling animation, refer to [BTween](https://github.com/PengJiyuan/b-tween) for optional values
+		*/
 		easing: {
 			type: String,
 			default: "quartOut"
 		},
+		/**
+		* @zh 滚动动画的持续时间
+		* @en Duration of scroll animation
+		*/
 		duration: {
 			type: Number,
 			default: 200

package/es/badge/badge.js

@@ -1,5 +1,5 @@
 import { configProviderInjectionKey } from "../config-provider/context.js";
-import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectSpread2.js";
+import { _objectSpread2 } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectSpread2.js";
 import { getPrefixCls } from "../_utils/global-config.js";
 import { computed, createVNode, defineComponent, inject, toRefs } from "vue";
 //#region components/badge/badge.tsx
@@ -27,24 +27,57 @@ var BADGE_STATUSES = [
 var badge_default = /* @__PURE__ */ defineComponent({
 	name: "Badge",
 	props: {
+		/**
+		* @zh 自定义提示内容
+		* @en Set the display text of the status dot
+		*/
 		text: { type: String },
+		/**
+		* @zh 显示为小红点
+		* @en Whether to display a red dot instead of `count`
+		*/
 		dot: { type: Boolean },
+		/**
+		* @zh 徽标的样式
+		* @en Customize badge dot style
+		*/
 		dotStyle: { type: Object },
+		/**
+		* @zh 徽标最大显示数值，如果count超过这个数值会显示为maxCount
+		* @en Max count to show. If count is larger than this value, it will be displayed as `${maxCount}+`
+		*/
 		maxCount: {
 			type: Number,
 			default: 99
 		},
+		/**
+		* @zh 设置徽标位置的偏移
+		* @en Set offset of the badge dot
+		*/
 		offset: {
 			type: Array,
 			default: () => []
 		},
+		/**
+		* @zh 内置的一些颜色
+		* @en Customize dot color
+		*/
 		color: { type: String },
+		/**
+		* @zh 徽标的状态类型
+		* @en Badge status
+		* @values 'normal', 'processing', 'success', 'warning', 'danger'
+		*/
 		status: {
 			type: String,
 			validator: (value) => {
 				return BADGE_STATUSES.includes(value);
 			}
 		},
+		/**
+		* @zh 徽标显示的数字
+		* @en Number to show in badge
+		*/
 		count: { type: Number }
 	},
 	setup(props, { slots }) {

package/es/breadcrumb/breadcrumb-item.js

@@ -11,14 +11,41 @@ var breadcrumb_item_default = /* @__PURE__ */ defineComponent({
 	name: "BreadcrumbItem",
 	inheritAttrs: false,
 	props: {
+		/**
+		* @zh 分隔符文字
+		* @en Delimiter text
+		* @version 2.36.0
+		*/
 		separator: { type: [String, Number] },
+		/**
+		* @zh 下拉菜单内容
+		* @en Dropdown content
+		* @version 2.36.0
+		*/
 		droplist: { type: Array },
+		/**
+		* @zh 下拉菜单属性
+		* @en Dropdown props
+		* @version 2.36.0
+		*/
 		dropdownProps: { type: Object },
 		index: {
 			type: Number,
 			default: 0
 		}
 	},
+	/**
+	* @zh 自定义分隔符
+	* @en Custom separator
+	* @slot separator
+	* @version 2.36.0
+	*/
+	/**
+	* @zh 自定义下拉菜单
+	* @en Custom droplist
+	* @slot droplist
+	* @version 2.36.0
+	*/
 	setup(props, { slots, attrs }) {
 		const prefixCls = getPrefixCls("breadcrumb-item");
 		const breadcrumbCtx = inject(breadcrumbInjectKey, void 0);

package/es/breadcrumb/breadcrumb.js

@@ -7,14 +7,53 @@ import { computed, createVNode, defineComponent, mergeProps, provide, reactive,
 var breadcrumb_default = /* @__PURE__ */ defineComponent({
 	name: "Breadcrumb",
 	props: {
+		/**
+		* @zh 最多展示的面包屑数量（0表示不限制）
+		* @en Maximum number of breadcrumbs displayed (0 means no limit)
+		*/
 		maxCount: {
 			type: Number,
 			default: 0
 		},
+		/**
+		* @zh 设置路径
+		* @en Set routes
+		* @version 2.36.0
+		*/
 		routes: { type: Array },
+		/**
+		* @zh 分隔符文字
+		* @en Delimiter text
+		* @version 2.36.0
+		*/
 		separator: { type: [String, Number] },
+		/**
+		* @zh 自定义链接地址
+		* @en Custom link address
+		* @version 2.36.0
+		*/
 		customUrl: { type: Function }
 	},
+	/**
+	* @zh 自定义分隔符
+	* @en Custom separator
+	* @slot separator
+	*/
+	/**
+	* @zh routes 设置时生效，自定义渲染面包屑
+	* @en Effective when setting routes, custom render breadcrumbs
+	* @binding {BreadcrumbRoute} route
+	* @binding {BreadcrumbRoute[]} routes
+	* @binding {string[]} paths
+	* @slot item-render
+	* @version 2.36.0
+	*/
+	/**
+	* @zh 自定义更多图标
+	* @en Custom more icon
+	* @slot more-icon
+	* @version 2.36.0
+	*/
 	setup(props, { slots }) {
 		const { maxCount, separator, routes } = toRefs(props);
 		const prefixCls = getPrefixCls("breadcrumb");

package/es/button/button-group.vue_vue_type_script_lang.js

@@ -5,10 +5,32 @@ import { defineComponent, provide, reactive, toRefs } from "vue";
 var button_group_vue_vue_type_script_lang_default = defineComponent({
 	name: "ButtonGroup",
 	props: {
+		/**
+		* @zh 按钮的类型，分为五种：次要按钮、主要按钮、虚框按钮、线性按钮、文字按钮。
+		* @en Children button types are divided into five types: secondary, primary, dashed, outline and text.
+		*/
 		type: { type: String },
+		/**
+		* @zh 按钮的状态
+		* @en Children button state
+		* @values 'normal','warning','success','danger'
+		*/
 		status: { type: String },
+		/**
+		* @zh 按钮的形状
+		* @en Button shape
+		*/
 		shape: { type: String },
+		/**
+		* @zh 按钮的尺寸
+		* @en Children button size
+		* @values 'mini','small','medium','large'
+		*/
 		size: { type: String },
+		/**
+		* @zh 全部子按钮是否禁用
+		* @en All children whether the button is disabled
+		*/
 		disabled: { type: Boolean }
 	},
 	setup(props) {