更新所有表单组件文档和头注释

Tevin

2025-03-18 fdeb869c386da95150a087bc22bcebc4e57d0f76

 forms/datePicker/CDatePicker.vue

@@ -1,10 +1,16 @@
/**
 * CDatePicker - 选择日期范围操作
 * 日期选择组件，用于在表单中选择日期或日期范围
 * 支持三种选择模式：日期选择、日期时间选择和日期范围选择
 * 可限制日期选择范围，支持清除功能和只读模式
 * @author Tevin
 */

<template>
    <view class="c-date-picker">
    <view
        class="c-date-picker"
        :class="readOnly?'read-only':''"
    >
        <CDateRangeAction
            v-if="mode==='dateRange'"
            :value="itemRes.formData[itemRes.name]"
@@ -19,7 +25,15 @@
                :value="itemRes.formData[itemRes.name]"
                :placeholder="placeholder"
            >
                <view class="at-icon at-icon-chevron-right" />
                <view
                    v-show="!readOnly && !showClear"
                    class="at-icon at-icon-chevron-right"
                />
                <view
                    v-show="!readOnly && showClear"
                    class="at-icon at-icon-close"
                    @tap.stop="evt => handleClear()"
                ></view>
            </AtInput>
        </CDateRangeAction>
        <CDateTimeAction
@@ -36,14 +50,23 @@
                :value="itemRes.formData[itemRes.name]"
                :placeholder="placeholder"
            >
                <view class="at-icon at-icon-chevron-right" />
                <view
                    v-show="!readOnly && !showClear"
                    class="at-icon at-icon-chevron-right"
                />
                <view
                    v-show="!readOnly && showClear"
                    class="at-icon at-icon-close"
                    @tap.stop="evt => handleClear()"
                ></view>
            </AtInput>
        </CDateTimeAction>
        <view v-else-if="mode==='date'">
            <picker
                mode="date"
                :start="pickerStart"
                :end="pickerEnd"
                :start="limitStart || pickerStart"
                :end="limitEnd || pickerEnd"
                :fields="fields"
                :value="itemRes.formData[itemRes.name]"
                @change="evt=>handleChange(evt.detail.value)"
            >
@@ -55,7 +78,15 @@
                    :value="itemRes.formData[itemRes.name]"
                    :placeholder="placeholder"
                >
                    <view class="at-icon at-icon-chevron-right" />
                    <view
                        v-show="!readOnly && !showClear"
                        class="at-icon at-icon-chevron-right"
                    />
                    <view
                        v-show="!readOnly && showClear"
                        class="at-icon at-icon-close"
                        @tap.stop="evt => handleClear()"
                    ></view>
                </AtInput>
            </picker>
        </view>
@@ -87,6 +118,25 @@
        },
        // 占位提示
        placeholder: String,
        // 开始日期
        limitStart: String,
        // 结束日期
        limitEnd: String,
        // 日期选择粒度 year、month、day
        fields: {
            type: String,
            default: 'day',
        },
        // 是否只读
        readOnly: {
            type: Boolean,
            default: false,
        },
        // 允许清除
        allowClear: {
            type: Boolean,
            default: false,
        },
    },
    data() {
        const year = new Date().getFullYear();
@@ -95,11 +145,21 @@
            pickerEnd: year + 30 + '-12-31',
        };
    },
    computed: {},
    computed: {
        showClear() {
            if (!this.allowClear) {
                return false;
            }
            return !!this.itemRes.formData[this.itemRes.name];
        },
    },
    methods: {
        handleChange(val) {
            this.itemRes.onChange(val);
        },
        handleClear() {
            this.itemRes.onChange('');
        },
    },
    mounted() {},
};