@sdata/web-vue 1.11.1 → 1.12.0

package/es/date-picker/picker.vue_vue_type_script_lang.js

@@ -1,5 +1,5 @@
 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 } from "../_utils/is.js";
 import { useAllowClear } from "../_hooks/use-allow-clear.js";
@@ -38,62 +38,160 @@ var picker_vue_vue_type_script_lang_default = defineComponent({
 	},
 	inheritAttrs: false,
 	props: {
+		/**
+		* @zh 国际化配置，用于覆盖locale中的 `datePicker` 字段
+		* @en Internationalization configuration, used to cover the locale file in the `datePicker` field
+		*/
 		locale: { type: Object },
+		/**
+		* @zh 没有触发元素，只显示选择面板
+		* @en There is no trigger element, only the selection panel is displayed
+		* */
 		hideTrigger: { type: Boolean },
+		/**
+		* @zh 是否允许清除
+		* @en Whether to allow clear
+		* */
 		allowClear: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否为只读
+		* @en Whether it is read-only
+		* */
 		readonly: { type: Boolean },
+		/**
+		* @zh 是否为错误状态
+		* @en Whether it is an error state
+		*/
 		error: { type: Boolean },
+		/**
+		* @zh 日期选择器的尺寸
+		* @en The size of the date picker
+		* @values 'mini','small','medium','large'
+		* @defaultValue 'medium'
+		* */
 		size: { type: String },
+		/**
+		* @zh 预设时间范围快捷选择
+		* @en Quick selection of preset time range
+		*/
 		shortcuts: {
 			type: Array,
 			default: () => []
 		},
+		/**
+		* @zh 预设范围在面板上的位置，默认放在下方，侧边一般用于大量预设时间的场景
+		* @en The position of the preset range on the panel, which is placed at the bottom by default, and the side is generally used for scenes with a large number of preset times
+		* */
 		shortcutsPosition: {
 			type: String,
 			default: "bottom"
 		},
+		/**
+		* @zh 弹出的框的位置
+		* @en The position of the pop-up box
+		*/
 		position: {
 			type: String,
 			default: "bl"
 		},
+		/**
+		* @zh 控制弹出框的打开或者关闭状态
+		* @en Control the open or closed state of the pop-up box
+		*/
 		popupVisible: {
 			type: Boolean,
 			default: void 0
 		},
+		/**
+		* @zh 默认弹出框是打开或者关闭
+		* @en The default pop-up box is open or closed
+		*/
 		defaultPopupVisible: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 可以传入 `Trigger` 组件的参数
+		* @en You can pass in the parameters of the `Trigger` component
+		*/
 		triggerProps: { type: Object },
+		/**
+		* @zh 是否在隐藏的时候销毁DOM结构
+		* @en Whether to destroy the DOM structure when hiding
+		*/
 		unmountOnClose: { type: Boolean },
+		/**
+		* @zh 提示文案
+		* @en Prompt copy
+		*/
 		placeholder: { type: String },
+		/**
+		* @zh 是否禁用
+		* @en Whether to disable
+		*/
 		disabled: { type: Boolean },
+		/**
+		* @zh 不可选取的日期
+		* @en Unselectable date
+		*/
 		disabledDate: { type: Function },
+		/**
+		* @zh 不可选取的时间
+		* @en Unselectable time
+		*/
 		disabledTime: { type: Function },
+		/**
+		* @zh 面板显示的日期
+		* @en Date displayed on the panel
+		* @vModel
+		*/
 		pickerValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 面板默认显示的日期
+		* @en The date displayed on the panel by default
+		*/
 		defaultPickerValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 弹出框的挂载容器
+		* @en Mount container for pop-up box
+		*/
 		popupContainer: { type: [String, Object] },
 		mode: {
 			type: String,
 			default: "date"
 		},
 		format: { type: [String, Function] },
+		/**
+		* @zh 值的格式，对 `value` `defaultValue` `pickerValue` `defaultPickerValue` 以及事件中的返回值生效，支持设置为时间戳，Date 和字符串（参考[字符串解析格式](#字符串解析格式)）。如果没有指定，将格式化为字符串，格式同 `format`。
+		* @en The format of the value, valid for `value` `defaultValue` `pickerValue` `defaultPickerValue` and the return value in the event, supports setting as timestamp, Date and string (refer to [String parsing format](#string-parsing-format) ). If not specified, it will be formatted as a string, in the same format as `format`.
+		* @version 2.16.0
+		*/
 		valueFormat: { type: String },
+		/**
+		* @zh 是否要预览快捷选择的结果
+		* @en Whether to preview the result of the shortcut
+		* @version 2.28.0
+		*/
 		previewShortcut: {
 			type: Boolean,
 			default: true
 		},
+		/**
+		* @zh 是否显示确认按钮，`showTime = true` 的时候始终显示。
+		* @en Whether to show the confirm button, always show when `showTime = true`.
+		* @version 2.29.0
+		*/
 		showConfirmBtn: { type: Boolean },
 		showTime: { type: Boolean },
 		timePickerProps: { type: Object },
@@ -115,27 +213,121 @@ var picker_vue_vue_type_script_lang_default = defineComponent({
 			String,
 			Number
 		] },
+		/**
+		* @zh 是否禁止键盘输入日期
+		* @en Whether input is disabled with the keyboard.
+		* @version 2.43.0
+		*/
 		disabledInput: {
 			type: Boolean,
 			default: false
 		},
+		/**
+		* @zh 是否启用缩写
+		* @en Whether to enable abbreviation
+		* @version 2.45.0
+		*/
 		abbreviation: {
 			type: Boolean,
 			default: true
 		}
 	},
 	emits: {
+		/**
+		* @zh 组件值发生改变
+		* @en The component value changes
+		* @param {Date | string | number | undefined} value
+		* @param {Date | undefined} date
+		* @param {string | undefined} dateString
+		*/
 		"change": (_value, _date, _dateString) => true,
 		"update:modelValue": (_value) => true,
+		/**
+		* @zh 选中日期发生改变但组件值未改变
+		* @en The selected date has changed but the component value has not changed
+		* @param {Date | string | number} value
+		* @param {Date} date
+		* @param {string} dateString
+		*/
 		"select": (_value, _date, _dateString) => true,
+		/**
+		* @zh 打开或关闭弹出框
+		* @en Open or close the pop-up box
+		* @param {boolean} visible
+		*/
 		"popup-visible-change": (_visible) => true,
 		"update:popupVisible": (_visible) => true,
+		/**
+		* @zh 点击确认按钮
+		* @en Click the confirm button
+		* @param {Date | string | number} value
+		* @param {Date} date
+		* @param {string} dateString
+		*/
 		"ok": (_value, _date, _dateString) => true,
+		/**
+		* @zh 点击清除按钮
+		* @en Click the clear button
+		*/
 		"clear": () => true,
+		/**
+		* @zh 点击快捷选项
+		* @en Click on the shortcut option
+		* @param {ShortcutType} shortcut
+		*/
 		"select-shortcut": (_shortcut) => true,
+		/**
+		* @zh 面板日期改变
+		* @en Panel date change
+		* @param {Date | string | number} value
+		* @param {Date} date
+		* @param {string} dateString
+		*/
 		"picker-value-change": (_value, _date, _dateString) => true,
 		"update:pickerValue": (_value) => true
 	},
+	/**
+	* @zh 输入框前缀
+	* @en Input box prefix
+	* @slot prefix
+	* @version 2.41.0
+	*/
+	/**
+	* @zh 输入框后缀图标
+	* @en Input box suffix icon
+	* @slot suffix-icon
+	*/
+	/**
+	* @zh 额外的页脚
+	* @en Extra footer
+	* @slot extra
+	*/
+	/**
+	* @zh 自定义日期单元格的内容
+	* @en Customize the contents of the date cell
+	* @slot cell
+	* @binding {Date} date
+	*/
+	/**
+	* @zh 单箭头往前翻页图标
+	* @en Single arrow page forward icon
+	* @slot icon-prev
+	*/
+	/**
+	* @zh 单箭头往后翻页图标
+	* @en Single arrow page backward icon
+	* @slot icon-next
+	*/
+	/**
+	* @zh 双箭头往前翻页图标
+	* @en Double arrow page forward icon
+	* @slot icon-prev-double
+	*/
+	/**
+	* @zh 双箭头往后翻页图标
+	* @en Double arrow page backward icon
+	* @slot icon-next-double
+	*/
 	setup(props, { emit, slots }) {
 		const { mode, modelValue, defaultValue, format, valueFormat, placeholder, popupVisible, defaultPopupVisible, disabled, showTime, timePickerProps, disabledDate, disabledTime, readonly, allowClear, locale, pickerValue, defaultPickerValue, dayStartOfWeek, previewShortcut, showConfirmBtn } = toRefs(props);
 		const { locale: globalLocal } = useI18n();

package/es/date-picker/pickers/date-picker.js

@@ -4,26 +4,68 @@ import { createVNode, defineComponent, mergeProps } from "vue";
 var date_picker_default = /* @__PURE__ */ defineComponent({
 	name: "DatePicker",
 	props: {
+		/**
+		* @zh 绑定值
+		* @en Value
+		*/
 		modelValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 默认值
+		* @en Default value
+		*/
 		defaultValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 展示日期的格式，参考[字符串解析格式](#字符串解析格式)
+		* @en Display the format of the date, refer to [String Parsing Format](#string-parsing-format)
+		*/
 		format: { type: [String, Function] },
+		/**
+		* @zh 每周的第一天开始于周几，0 - 周日，1 - 周一，以此类推。
+		* @en The first day of the week starts on the day of the week, 0-Sunday, 1-Monday, and so on.
+		* @type 0 | 1 | 2 | 3 | 4 | 5 | 6
+		* @version 2-6 from 2.21.0
+		*/
 		dayStartOfWeek: {
 			type: Number,
 			default: 0
 		},
+		/**
+		* @zh 是否增加时间选择
+		* @en Whether to increase time selection
+		* */
 		showTime: { type: Boolean },
+		/**
+		* @zh 时间显示的参数，参考 [TimePickerProps](/vue/component/time-picker)
+		* @en Time display parameters, refer to [TimePickerProps](/vue/component/time-picker)
+		* */
 		timePickerProps: { type: Object },
+		/**
+		* @zh 是否禁用
+		* @en Whether to disable
+		*/
 		disabled: { type: Boolean },
+		/**
+		* @zh 不可选取的日期
+		* @en Unselectable date
+		*/
 		disabledDate: { type: Function },
+		/**
+		* @zh 不可选取的时间
+		* @en Unselectable time
+		* */
 		disabledTime: { type: Function },
+		/**
+		* @zh 是否显示 `showTime` 时，选择当前时间的按钮
+		* @en Whether to display `showTime`, select the button of the current time
+		* */
 		showNowBtn: {
 			type: Boolean,
 			default: true

package/es/date-picker/pickers/month-picker.js

@@ -4,16 +4,28 @@ import { createVNode, defineComponent, mergeProps } from "vue";
 var month_picker_default = /* @__PURE__ */ defineComponent({
 	name: "MonthPicker",
 	props: {
+		/**
+		* @zh 绑定值
+		* @en Value
+		*/
 		modelValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 默认值
+		* @en Default value
+		*/
 		defaultValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 展示日期的格式，参考[字符串解析格式](#字符串解析格式)
+		* @en Display the format of the date, refer to [String Parsing Format](#String Parsing Format)
+		*/
 		format: {
 			type: String,
 			default: "YYYY-MM"

package/es/date-picker/pickers/quarter-picker.js

@@ -4,20 +4,37 @@ import { createVNode, defineComponent, mergeProps } from "vue";
 var quarter_picker_default = /* @__PURE__ */ defineComponent({
 	name: "QuarterPicker",
 	props: {
+		/**
+		* @zh 绑定值
+		* @en Value
+		*/
 		modelValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 默认值
+		* @en Default value
+		*/
 		defaultValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 展示日期的格式，参考[字符串解析格式](#字符串解析格式)
+		* @en Display the format of the date, refer to [String Parsing Format](#String Parsing Format)
+		*/
 		format: {
 			type: String,
 			default: "YYYY-[Q]Q"
 		},
+		/**
+		* @zh 值的格式，对 `value` `defaultValue` `pickerValue` `defaultPickerValue` 以及事件中的返回值生效，支持设置为时间戳，Date 和字符串（参考[字符串解析格式](#字符串解析格式)）。
+		* @en The format of the value, valid for `value` `defaultValue` `pickerValue` `defaultPickerValue` and the return value in the event, supports setting as timestamp, Date and string (refer to [String parsing format](#string-parsing-format) ).
+		* @version 2.16.0
+		*/
 		valueFormat: {
 			type: String,
 			default: "YYYY-MM"

package/es/date-picker/pickers/week-picker.js

@@ -4,24 +4,47 @@ import { createVNode, defineComponent, mergeProps } from "vue";
 var week_picker_default = /* @__PURE__ */ defineComponent({
 	name: "WeekPicker",
 	props: {
+		/**
+		* @zh 绑定值
+		* @en Value
+		*/
 		modelValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 默认值
+		* @en Default value
+		*/
 		defaultValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 展示日期的格式，参考[字符串解析格式](#字符串解析格式)
+		* @en Display the format of the date, refer to [String Parsing Format](#String Parsing Format)
+		*/
 		format: {
 			type: String,
 			default: "gggg-wo"
 		},
+		/**
+		* @zh 值的格式，对 `value` `defaultValue` `pickerValue` `defaultPickerValue` 以及事件中的返回值生效，支持设置为时间戳，Date 和字符串（参考[字符串解析格式](#字符串解析格式)）。
+		* @en The format of the value, valid for `value` `defaultValue` `pickerValue` `defaultPickerValue` and the return value in the event, supports setting as timestamp, Date and string (refer to [String parsing format](#string-parsing-format) ).
+		* @version 2.16.0
+		*/
 		valueFormat: {
 			type: String,
 			default: "YYYY-MM-DD"
 		},
+		/**
+		* @zh 每周的第一天开始于周几，0 - 周日，1 - 周一，以此类推。
+		* @en The first day of the week starts on the day of the week, 0-Sunday, 1-Monday, and so on.
+		* @type 0 | 1 | 2 | 3 | 4 | 5 | 6
+		* @version 2-6 from 2.21.0
+		*/
 		dayStartOfWeek: {
 			type: Number,
 			default: 0

package/es/date-picker/pickers/year-picker.js

@@ -4,16 +4,28 @@ import { createVNode, defineComponent, mergeProps } from "vue";
 var year_picker_default = /* @__PURE__ */ defineComponent({
 	name: "YearPicker",
 	props: {
+		/**
+		* @zh 绑定值
+		* @en Value
+		*/
 		modelValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 默认值
+		* @en Default value
+		*/
 		defaultValue: { type: [
 			Object,
 			String,
 			Number
 		] },
+		/**
+		* @zh 展示日期的格式，参考[字符串解析格式](#字符串解析格式)
+		* @en Display the format of the date, refer to [String Parsing Format](#String Parsing Format)
+		*/
 		format: {
 			type: String,
 			default: "YYYY"