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

Tevin

2025-03-18 fdeb869c386da95150a087bc22bcebc4e57d0f76

 forms/datePicker/CDatePicker.vue

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

<template>
    <view
        class="c-date-picker"
        :class="readOnly ? 'read-only':''"
        :class="readOnly?'read-only':''"
    >
        <CDateRangeAction
            v-if="mode==='dateRange'"
@@ -27,7 +30,7 @@
                    class="at-icon at-icon-chevron-right"
                />
                <view
                    v-show="showClear"
                    v-show="!readOnly && showClear"
                    class="at-icon at-icon-close"
                    @tap.stop="evt => handleClear()"
                ></view>
@@ -52,7 +55,7 @@
                    class="at-icon at-icon-chevron-right"
                />
                <view
                    v-show="showClear"
                    v-show="!readOnly && showClear"
                    class="at-icon at-icon-close"
                    @tap.stop="evt => handleClear()"
                ></view>
@@ -63,6 +66,7 @@
                mode="date"
                :start="limitStart || pickerStart"
                :end="limitEnd || pickerEnd"
                :fields="fields"
                :value="itemRes.formData[itemRes.name]"
                @change="evt=>handleChange(evt.detail.value)"
            >
@@ -79,7 +83,7 @@
                        class="at-icon at-icon-chevron-right"
                    />
                    <view
                        v-show="showClear"
                        v-show="!readOnly && showClear"
                        class="at-icon at-icon-close"
                        @tap.stop="evt => handleClear()"
                    ></view>
@@ -118,6 +122,11 @@
        limitStart: String,
        // 结束日期
        limitEnd: String,
        // 日期选择粒度 year、month、day
        fields: {
            type: String,
            default: 'day',
        },
        // 是否只读
        readOnly: {
            type: Boolean,