@sdata/web-vue 1.11.1 → 1.12.0

package/es/upload/upload.js

@@ -1,8 +1,8 @@
 import { useFormItem } from "../_hooks/use-form-item.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 { isBoolean, isFunction, isObject } from "../_utils/is.js";
-import { _asyncToGenerator } from "../_virtual/_@oxc-project_runtime@0.124.0/helpers/asyncToGenerator.js";
+import { _asyncToGenerator } from "../_virtual/_@oxc-project_runtime@0.130.0/helpers/asyncToGenerator.js";
 import preview_group_default from "../image/preview-group.js";
 import { uploadInjectionKey } from "./context.js";
 import { isImage, uploadRequest } from "./utils.js";
@@ -13,105 +13,356 @@ import { computed, createVNode, defineComponent, provide, reactive, ref, toRefs,
 var upload_default = /* @__PURE__ */ defineComponent({
 	name: "Upload",
 	props: {
+		/**
+		* @zh 文件列表
+		* @en File List
+		* @vModel
+		*/
 		fileList: {
 			type: Array,
 			default: void 0
 		},
+		/**
+		* @zh 默认的文件列表（非受控状态）
+		* @en Default file list (uncontrolled state)
+		*/
 		defaultFileList: {
 			type: Array,
 			default: () => []
 		},
+		/**
+		* @zh 接收的上传文件类型，具体参考 [HTML标准](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#htmlattrdefaccept "_blank")
+		* @en For the received upload file type, please refer to [HTML standard](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#htmlattrdefaccept "_blank")
+		*/
 		accept: String,
+		/**
+		* @zh 上传的URL
+		* @en Uploaded URL
+		*/
 		action: String,
+		/**
+		* @zh 是否禁用
+		* @en Whether to disable
+		*/
 		disabled: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 是否支持多文件上传
+		* @en Whether to support multiple file upload
+		*/
 		multiple: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 是否支持文件夹上传（需要浏览器支持）
+		* @en Whether to support folder upload (requires browser support)
+		*/
 		directory: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 是否支持拖拽上传
+		* @en Whether to support drag and drop upload
+		*/
 		draggable: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 提示文字
+		* @en Prompt text
+		*/
 		tip: String,
+		/**
+		* @zh 上传请求附加的头信息
+		* @en Additional header information for upload request
+		*/
 		headers: { type: Object },
+		/**
+		* @zh 上传请求附加的数据
+		* @en Upload request additional data
+		*/
 		data: { type: [Object, Function] },
+		/**
+		* @zh 上传的文件名
+		* @en Uploaded file name
+		*/
 		name: { type: [String, Function] },
+		/**
+		* @zh 上传请求是否携带 cookie
+		* @en Whether the upload request carries cookies
+		*/
 		withCredentials: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 自定义上传行为
+		* @en Custom upload behavior
+		*/
 		customRequest: { type: Function },
+		/**
+		* @zh 限制上传文件的数量。`0`表示不限制
+		* @en Limit the number of uploaded files. `0` means no limit
+		*/
 		limit: {
 			type: Number,
 			default: 0
 		},
+		/**
+		* @zh 是否自动上传文件
+		* @en Whether to upload files automatically
+		*/
 		autoUpload: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否显示文件列表
+		* @en Whether to display the file list
+		*/
 		showFileList: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否显示删除按钮
+		* @en Whether to display the remove button
+		* @version 2.11.0
+		*/
 		showRemoveButton: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否显示重试按钮
+		* @en Whether to display the retry button
+		* @version 2.11.0
+		*/
 		showRetryButton: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否显示取消按钮
+		* @en Whether to display the cancel button
+		* @version 2.11.0
+		*/
 		showCancelButton: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否显示上传按钮。2.14.0 版本新增 `showOnExceedLimit` 支持
+		* @en Whether to display the retry button. Added `showOnExceedLimit` support in version 2.14.0
+		* @version 2.11.0
+		*/
 		showUploadButton: {
 			type: [Boolean, Object],
 			default: true
 		},
+		/**
+		* @zh 照片墙是否显示预览按钮
+		* @en Whether to display the preview button in picture-card
+		* @version 2.42.0
+		*/
 		showPreviewButton: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否在 `<a>` 链接上添加 download 属性
+		* @en Whether to add download attribute to `<a>` link
+		* @version 2.11.0
+		*/
 		download: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 在列表模式下，如果上传的文件存在 URL 则展示链接。如果关闭仅展示文字并且点击可以触发 `preview` 事件。
+		* @en In the list mode, if the uploaded file has a URL, the link will be displayed. If you turn off only display text and click to trigger the `preview` event.
+		* @version 2.13.0
+		*/
 		showLink: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh `<img>` 的原生 HTML 属性，需要浏览器支持
+		* @en Native HTML attributes of `<img>`, browser support is required
+		* @version 2.11.0
+		*/
 		imageLoading: { type: String },
+		/**
+		* @zh 图片列表类型
+		* @en Picture list type
+		* @values 'text','picture','picture-card'
+		*/
 		listType: {
 			type: String,
 			default: "text"
 		},
+		/**
+		* @zh Response中获取图片URL的key，开启后会用上传的图片替换预加载的图片
+		* @en Get the key of the image URL in the Response. After opening, it will replace the pre-load image with the uploaded image
+		*/
 		responseUrlKey: { type: [String, Function] },
+		/**
+		* @zh 自定义图标
+		* @en Custom icon
+		*/
 		customIcon: { type: Object },
+		/**
+		* @zh 是否使用 ImagePreview 组件进行预览
+		* @version 2.14.0
+		*/
 		imagePreview: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 上传文件前触发
+		* @en Trigger before uploading a file
+		*/
 		onBeforeUpload: { type: Function },
+		/**
+		* @zh 移除文件前触发
+		* @en Triggered before removing the file
+		*/
 		onBeforeRemove: { type: Function },
+		/**
+		* @zh 点击上传按钮触发（如果返回 Promise 则会关闭默认 input 上传）
+		* @en Click the upload button to trigger (if the Promise is returned, the default input upload will be closed)
+		*/
 		onButtonClick: { type: Function }
 	},
 	emits: {
 		"update:fileList": (_fileList) => true,
+		/**
+		* @zh 上传的文件超出限制后触发
+		* @en Triggered when the uploaded file exceeds the limit
+		* @param {FileItem[]} fileList
+		* @param {File[]} files
+		*/
 		"exceedLimit": (_fileList, _files) => true,
+		/**
+		* @zh 上传的文件状态发生改变时触发
+		* @en Triggered when the status of the uploaded file changes
+		* @param {FileItem[]} fileList
+		* @param {fileItem} fileItem
+		*/
 		"change": (_fileList, _fileItem) => true,
+		/**
+		* @zh 上传中的文件进度改变时触发
+		* @en Triggered when the uploading file progress changes
+		* @param {fileItem} fileItem
+		* @param {ProgressEvent} ev
+		*/
 		"progress": (_fileItem, _ev) => true,
+		/**
+		* @zh 点击图片预览时的触发
+		* @en Trigger when the image preview is clicked
+		* @param {FileItem} fileItem
+		*/
 		"preview": (_fileItem) => true,
+		/**
+		* @zh 上传成功时触发
+		* @en Triggered when upload is successful
+		* @param {FileItem} fileItem
+		*/
 		"success": (_fileItem) => true,
+		/**
+		* @zh 上传失败时触发
+		* @en Triggered when upload fails
+		* @param {FileItem} fileItem
+		*/
 		"error": (_fileItem) => true
 	},
+	/**
+	* @zh 上传列表的项目
+	* @en Upload list item
+	* @slot upload-item
+	* @binding {FileItem} fileItem
+	* @binding {number} index
+	*/
+	/**
+	* @zh 上传按钮
+	* @en Upload button
+	* @slot upload-button
+	*/
+	/**
+	* @zh 重试图标
+	* @en Retry icon
+	* @slot retry-icon
+	* @version 2.23.0
+	*/
+	/**
+	* @zh 成功图标
+	* @en Success icon
+	* @slot success-icon
+	* @version 2.23.0
+	*/
+	/**
+	* @zh 失败图标
+	* @en Error icon
+	* @slot error-icon
+	* @version 2.23.0
+	*/
+	/**
+	* @zh 开始图标
+	* @en Start icon
+	* @slot start-icon
+	* @version 2.23.0
+	*/
+	/**
+	* @zh 取消图标
+	* @en Cancel icon
+	* @slot cancel-icon
+	* @version 2.23.0
+	*/
+	/**
+	* @zh 预览图标
+	* @en Preview icon
+	* @slot preview-icon
+	* @version 2.23.0
+	*/
+	/**
+	* @zh 删除图标
+	* @en Remove icon
+	* @slot remove-icon
+	* @version 2.23.0
+	*/
+	/**
+	* @zh 文件图标
+	* @en File icon
+	* @slot file-icon
+	* @version 2.23.0
+	*/
+	/**
+	* @zh 文件名称
+	* @en File name
+	* @slot file-name
+	* @version 2.23.0
+	*/
+	/**
+	* @zh 自定义图片
+	* @en Image
+	* @slot image
+	* @binding {FileItem} fileItem
+	* @version 2.23.0
+	*/
+	/**
+	* @zh 上传列表额外按钮
+	* @en Extra button
+	* @slot extra-button
+	* @binding {FileItem} fileItem
+	* @version 2.43.0
+	*/
 	setup(props, { emit, slots }) {
 		const { fileList, disabled, listType, customIcon, showRetryButton, showCancelButton, showRemoveButton, showPreviewButton, imageLoading, download, showLink } = toRefs(props);
 		const prefixCls = getPrefixCls("upload");
@@ -367,15 +618,41 @@ var upload_default = /* @__PURE__ */ defineComponent({
 		};
 	},
 	methods: {
+		/**
+		* @zh 上传文件（已经初始化完成的文件）
+		* @en Upload file (file that has been initialized)
+		* @public
+		* @param {FileItem} fileItem
+		*/
 		submit(fileItem) {
 			return this.innerSubmit(fileItem);
 		},
+		/**
+		* @zh 中止上传
+		* @en Abort upload
+		* @public
+		* @param {FileItem} fileItem
+		*/
 		abort(fileItem) {
 			return this.innerAbort(fileItem);
 		},
+		/**
+		* @zh 更新文件
+		* @en Update file
+		* @public
+		* @param {string} id
+		* @param {File} file
+		*/
 		updateFile(id, file) {
 			return this.innerUpdateFile(id, file);
 		},
+		/**
+		* @zh 上传文件
+		* @en Upload file
+		* @public
+		* @param {File[]} files
+		* @version 2.41.0
+		*/
 		upload(files) {
 			return this.innerUpload(files);
 		}

package/es/verification-code/verification-code.js

@@ -7,30 +7,89 @@ import { Fragment, computed, createVNode, defineComponent, ref, watch } from "vu
 var verification_code_default = /* @__PURE__ */ defineComponent({
 	name: "VerificationCode",
 	props: {
+		/**
+		* @zh 绑定值
+		* @en Value
+		*/
 		modelValue: String,
+		/**
+		* @zh 默认值（非受控状态）
+		* @en Default value (uncontrolled state)
+		*/
 		defaultValue: {
 			type: String,
 			default: ""
 		},
+		/**
+		* @zh 验证码的长度，根据长度渲染对应个数的输入框
+		* @en The length of the verification code, rendering the corresponding number of input boxes according to the length.
+		*/
 		length: {
 			type: Number,
 			default: 6
 		},
+		/**
+		* @zh 输入框大小
+		* @en Input size
+		* @values 'mini','small','medium','large'
+		* @defaultValue 'medium'
+		*/
 		size: { type: String },
+		/**
+		* @zh 是否禁用
+		* @en Whether to disable
+		*/
 		disabled: Boolean,
+		/**
+		* @zh 是否密码模式
+		* @en Password mode
+		*/
 		masked: Boolean,
+		/**
+		* @zh 只读
+		* @en Readonly
+		*/
 		readonly: Boolean,
+		/**
+		* @zh 是否为错误状态
+		* @en Whether it is an error state
+		*/
 		error: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 分隔符。可在不同索引的输入框后自定义渲染分隔符
+		* @en Separator. Customizable rendering separators after input boxes with different indexes
+		*/
 		separator: { type: Function },
+		/**
+		* @zh 格式化函数，当用户输入值改变时触发
+		* @en Formatter function, triggered when the user input value changes
+		*/
 		formatter: { type: Function }
 	},
 	emits: {
 		"update:modelValue": (_value) => true,
+		/**
+		* @zh 值发生改变时触发
+		* @en Triggered when the value changes
+		* @param { string } value
+		*/
 		"change": (_value) => true,
+		/**
+		* @zh 填充完成时触发
+		* @en Triggered when the filling is complete
+		* @param { string } value
+		*/
 		"finish": (_value) => true,
+		/**
+		* @zh 输入时触发
+		* @en Triggered on input
+		* @param { string } inputValue
+		* @param { number } index
+		* @param {Event} ev
+		*/
 		"input": (_inputValue, _index, _ev) => true
 	},
 	setup(props, { emit }) {

package/es/watermark/hooks/use-mutation-observer.js

@@ -1,4 +1,4 @@
-import { _objectWithoutProperties } from "../../_virtual/_@oxc-project_runtime@0.124.0/helpers/objectWithoutProperties.js";
+import { _objectWithoutProperties } from "../../_virtual/_@oxc-project_runtime@0.130.0/helpers/objectWithoutProperties.js";
 import { getCurrentScope, onScopeDispose, unref, watch } from "vue";
 //#region components/watermark/hooks/use-mutation-observer.ts
 var _excluded = ["window"];

package/es/watermark/watermark.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 { isArray } from "../_utils/is.js";
 import { useMutationObserver } from "./hooks/use-mutation-observer.js";
@@ -9,40 +9,97 @@ import { computed, createVNode, defineComponent, mergeProps, onMounted, ref, sha
 var watermark_default = /* @__PURE__ */ defineComponent({
 	name: "Watermark",
 	props: {
+		/**
+		* @zh 水印文字内容
+		* @en Watermark text content
+		*/
 		content: { type: [String, Array] },
+		/**
+		* @zh 图片源，建议使用 2 倍或 3 倍图
+		* @en Image watermark address
+		*/
 		image: { type: String },
+		/**
+		* @zh 水印宽度（默认为内容宽度）
+		* @en Watermark width
+		*/
 		width: { type: Number },
+		/**
+		* @zh 水印高度（默认为内容高度）
+		* @en Watermark height
+		*/
 		height: { type: Number },
+		/**
+		* @zh 水印间的间距
+		* @en Watermark spacing
+		*/
 		gap: {
 			type: Array,
 			default: () => [90, 90]
 		},
+		/**
+		* @zh 距离容器左上角的偏移量，默认为水印间距的一半
+		* @en The offset from the upper left corner of the container, the default is half the watermark spacing
+		* @defaultValue [gap[0]/2, gap[1]/2]
+		*/
 		offset: { type: Array },
+		/**
+		* @zh 旋转角度
+		* @en Watermark rotation angle
+		*/
 		rotate: {
 			type: Number,
 			default: -22
 		},
+		/**
+		* @zh 水印字体样式，具体参数配置看 [WatermarkFont](#WatermarkFont)
+		* @en Watermark font style, specific parameter configuration see [WatermarkFont](#WatermarkFont)
+		*/
 		font: { type: Object },
+		/**
+		* @zh 水印层级
+		* @en Watermark z-index
+		*/
 		zIndex: {
 			type: Number,
 			default: 6
 		},
+		/**
+		* @zh 透明度
+		* @en Watermark opacity
+		*/
 		alpha: {
 			type: Number,
 			default: 1
 		},
+		/**
+		* @zh 水印防篡改
+		* @en Watermark anti-tampering
+		*/
 		antiTamper: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 灰阶水印
+		* @en Grayscale watermark
+		*/
 		grayscale: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 是否重复水印
+		* @en Whether to repeat the watermark
+		*/
 		repeat: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否错开排列
+		* @en Whether to stagger the arrangement layout
+		*/
 		staggered: {
 			type: Boolean,
 			default: true

package/es/web-vue.css

@@ -1,6 +1,6 @@
 /*! 
  * OverlayScrollbars
- * Version: 2.15.1
+ * Version: 2.16.0
  * 
  * Copyright (c) Rene Haas | KingSora.
  * https://github.com/KingSora
@@ -142,29 +142,6 @@
  * hide native scrollbars
  * changes to this styles need to be reflected in the environment styles to correctly detect scrollbar hiding
  */
-[data-overlayscrollbars-initialize]:not([data-overlayscrollbars-viewport]),
-[data-overlayscrollbars-viewport~=scrollbarHidden],
-html[data-overlayscrollbars-viewport~=scrollbarHidden] > body {
-  scrollbar-width: none !important;
-}
-
-[data-overlayscrollbars-initialize]:not([data-overlayscrollbars-viewport])::-webkit-scrollbar,
-[data-overlayscrollbars-initialize]:not([data-overlayscrollbars-viewport])::-webkit-scrollbar-corner,
-[data-overlayscrollbars-viewport~=scrollbarHidden]::-webkit-scrollbar,
-[data-overlayscrollbars-viewport~=scrollbarHidden]::-webkit-scrollbar-corner,
-html[data-overlayscrollbars-viewport~=scrollbarHidden] > body::-webkit-scrollbar,
-html[data-overlayscrollbars-viewport~=scrollbarHidden] > body::-webkit-scrollbar-corner {
-  -webkit-appearance: none !important;
-          appearance: none !important;
-  display: none !important;
-  width: 0 !important;
-  height: 0 !important;
-}
-
-[data-overlayscrollbars-initialize]:not([data-overlayscrollbars]):not(html):not(body) {
-  overflow: auto;
-}
-
 /**
  * body element
  */
@@ -667,4 +644,27 @@ body > .os-scrollbar {
   --os-handle-bg: rgba(255, 255, 255, 0.44);
   --os-handle-bg-hover: rgba(255, 255, 255, 0.55);
   --os-handle-bg-active: rgba(255, 255, 255, 0.66);
+}
+
+[data-overlayscrollbars-initialize]:not([data-overlayscrollbars-viewport]),
+[data-overlayscrollbars-viewport~=scrollbarHidden],
+html[data-overlayscrollbars-viewport~=scrollbarHidden] > body {
+  scrollbar-width: none !important;
+}
+
+[data-overlayscrollbars-initialize]:not([data-overlayscrollbars-viewport])::-webkit-scrollbar,
+[data-overlayscrollbars-initialize]:not([data-overlayscrollbars-viewport])::-webkit-scrollbar-corner,
+[data-overlayscrollbars-viewport~=scrollbarHidden]::-webkit-scrollbar,
+[data-overlayscrollbars-viewport~=scrollbarHidden]::-webkit-scrollbar-corner,
+html[data-overlayscrollbars-viewport~=scrollbarHidden] > body::-webkit-scrollbar,
+html[data-overlayscrollbars-viewport~=scrollbarHidden] > body::-webkit-scrollbar-corner {
+  -webkit-appearance: none !important;
+          appearance: none !important;
+  display: none !important;
+  width: 0 !important;
+  height: 0 !important;
+}
+
+[data-overlayscrollbars-initialize]:not([data-overlayscrollbars]):not(html):not(body) {
+  overflow: auto;
 }/*$vite$:1*/