@sdata/web-vue 1.11.0 → 1.12.0

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

@@ -17,47 +17,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");
@@ -202,10 +292,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/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) {

package/es/button/button.vue_vue_type_script_lang.js

@@ -10,30 +10,87 @@ var button_vue_vue_type_script_lang_default = defineComponent({
 	name: "Button",
 	components: { IconLoading },
 	props: {
+		/**
+		* @zh 按钮的类型，分为五种：次要按钮、主要按钮、虚框按钮、线性按钮、文字按钮。
+		* @en Button types are divided into five types: secondary, primary, dashed, outline and text.
+		* @defaultValue 'secondary'
+		*/
 		type: { type: String },
+		/**
+		* @zh 按钮的形状
+		* @en Button shape
+		*/
 		shape: { type: String },
+		/**
+		* @zh 按钮的状态
+		* @en Button state
+		* @values 'normal','warning','success','danger'
+		* @defaultValue 'normal'
+		*/
 		status: { type: String },
+		/**
+		* @zh 按钮的尺寸
+		* @en Button size
+		* @values 'mini','small','medium','large'
+		* @defaultValue 'medium'
+		*/
 		size: { type: String },
+		/**
+		* @zh 按钮的宽度是否随容器自适应。
+		* @en Whether the width of the button adapts to the container.
+		*/
 		long: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 按钮是否为加载中状态
+		* @en Whether the button is in the loading state
+		*/
 		loading: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 按钮是否禁用
+		* @en Whether the button is disabled
+		* @defaultValue false
+		*/
 		disabled: { type: Boolean },
+		/**
+		* @zh 设置 `button` 的原生 `type` 属性，可选值参考 [HTML标准](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type "_blank")
+		* @en Set the native `type` attribute of `button`, optional values refer to [HTML](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type "_blank")
+		*/
 		htmlType: {
 			type: String,
 			default: "button"
 		},
+		/**
+		* @zh 设置 `button` 的原生 `autofocus` 属性，可选值参考 [HTML标准](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type "_blank")
+		* @en Set the native `autofocus` attribute of `button`, optional values refer to [HTML](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type "_blank")
+		*/
 		autofocus: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 设置跳转链接。设置此属性时，按钮渲染为a标签。
+		* @en Set up a jump link. When this property is set, the button is rendered as `<a>`
+		*/
 		href: String
 	},
-	emits: { click: (_ev) => true },
+	emits: { 
+	/**
+	* @zh 点击按钮时触发
+	* @en Emitted when the button is clicked
+	* @property {MouseEvent} ev
+	*/
+click: (_ev) => true },
+	/**
+	* @zh 图标
+	* @en Icon
+	* @slot icon
+	*/
 	setup(props, { emit }) {
 		const { size, disabled } = toRefs(props);
 		const prefixCls = getPrefixCls("btn");

package/es/calendar/calendar.js

@@ -12,16 +12,36 @@ function getFormat(mode, panel) {
 var calendar_default = /* @__PURE__ */ defineComponent({
 	name: "Calendar",
 	props: {
+		/**
+		* @zh 绑定值
+		* @en Value
+		*/
 		modelValue: {
 			type: Date,
 			default: void 0
 		},
+		/**
+		* @zh 默认值（非受控状态）
+		* @en Default value (uncontrolled state)
+		*/
 		defaultValue: { type: Date },
+		/**
+		* @zh 模式
+		* @en Mode
+		*/
 		mode: { type: String },
+		/**
+		* @zh 默认模式
+		* @en Default Mode
+		*/
 		defaultMode: {
 			type: String,
 			default: "month"
 		},
+		/**
+		* @zh 显示的模式
+		* @en Displayed mode
+		*/
 		modes: {
 			type: Array,
 			default: () => ["month", "year"]
@@ -50,9 +70,36 @@ var calendar_default = /* @__PURE__ */ defineComponent({
 	},
 	emits: {
 		"update:modelValue": (_date) => true,
+		/**
+		* @zh 选择的日期改变时触发
+		* @en Emitted when the button is clicked
+		* @property {Date} date
+		*/
 		"change": (_date) => true,
+		/**
+		* @zh 日期面板改变时触发
+		* @en Emitted when the button is clicked
+		* @property {Date} date
+		*/
 		"panelChange": (_date) => true
 	},
+	/**
+	* @zh 自定义单元格内容
+	* @en Custom cell content
+	* @slot default
+	* @binding {number} year
+	* @binding {number} month
+	* @binding {number} date
+	* @version 2.53.0
+	*/
+	/**
+	* @zh 自定义头部内容
+	* @en Custom header content
+	* @slot header
+	* @binding {number} year
+	* @binding {number} month
+	* @version 2.53.0
+	*/
 	setup(props, { emit, slots }) {
 		const { dayStartOfWeek, isWeek } = toRefs(props);
 		const prefixCls = getPrefixCls("calendar");

package/es/calendar/month.js

@@ -1,4 +1,4 @@
-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 { dayjs, methods } from "../_utils/date.js";
 import { padStart } from "../_utils/pad.js";