Appearance
DatePickerDispatcher
Element Plus 的 el-date-picker 组件分发器,添加了只读功能。
选择某一天
以”日“为基本单位,基础的日期选择控件
vue
<template>
<el-radio-group v-model="size" aria-label="size control">
<el-radio-button value="large">large</el-radio-button>
<el-radio-button value="default">default</el-radio-button>
<el-radio-button value="small">small</el-radio-button>
</el-radio-group>
<div class="mt-16px">
<el-date-picker-dispatcher
v-model="value1"
type="date"
placeholder="Pick a day"
:disabled-date="disabledDate"
:size="size"
/>
</div>
</template>
<script lang="ts" setup>
import { ref } from "vue";
const size = ref<"default" | "large" | "small">("default");
const value1 = ref("");
const disabledDate = (time: Date) => {
return time.getTime() > Date.now();
};
</script>
隐藏源码
其他日期单位
通过扩展基础的日期选择,可以选择周、月、年或多个日期
Week
Dates
Year
Years
Month
Months
vue
<template>
<div class="demo-date-picker">
<div class="container">
<div class="block">
<span class="demonstration">Week</span>
<el-date-picker-dispatcher
v-model="value1"
type="week"
placeholder="Pick a week"
/>
</div>
<div class="block">
<span class="demonstration">Dates</span>
<el-date-picker-dispatcher
v-model="value2"
type="dates"
placeholder="Pick one or more dates"
/>
</div>
</div>
<div class="container">
<div class="block">
<span class="demonstration">Year</span>
<el-date-picker-dispatcher
v-model="value3"
type="year"
placeholder="Pick a year"
/>
</div>
<div class="block">
<span class="demonstration">Years</span>
<el-date-picker-dispatcher
v-model="value4"
type="years"
placeholder="Pick one or more years"
/>
</div>
</div>
<div class="container">
<div class="block">
<span class="demonstration">Month</span>
<el-date-picker-dispatcher
v-model="value5"
type="month"
placeholder="Pick a month"
/>
</div>
<div class="block">
<span class="demonstration">Months</span>
<el-date-picker-dispatcher
v-model="value6"
type="months"
placeholder="Pick one or more months"
/>
</div>
</div>
</div>
</template>
<script lang="ts" setup>
import { ref } from "vue";
const value1 = ref("");
const value2 = ref("");
const value3 = ref("");
const value4 = ref("");
const value5 = ref("");
const value6 = ref("");
</script>
隐藏源码
选择一段时间
Date Range
-
Month Range
To
Year Range
To
vue
<template>
<div class="demo-date-picker">
<div class="block">
<span class="demonstration">Date Range</span>
<el-date-picker-dispatcher
v-model="value1"
type="daterange"
start-placeholder="Start date"
end-placeholder="End date"
/>
</div>
<div class="block">
<span class="demonstration">Month Range</span>
<el-date-picker-dispatcher
v-model="value2"
type="monthrange"
range-separator="To"
start-placeholder="Start month"
end-placeholder="End month"
/>
</div>
<div class="block">
<span class="demonstration">Year Range</span>
<el-date-picker-dispatcher
v-model="value3"
type="yearrange"
range-separator="To"
start-placeholder="Start Year"
end-placeholder="End Year"
/>
</div>
</div>
</template>
<script lang="ts" setup>
import { ref } from "vue";
const value1 = ref("");
const value2 = ref("");
const value3 = ref("");
</script>
隐藏源码
设置自定义前缀的内容
前缀内容可以被自定义。
当你从其他vue组件或由渲染函数生成的组件中导入组件时, 你可以设置 prefix-icon 属性来定制前缀内容
pre
vue
<template>
<el-date-picker-dispatcher
v-model="value1"
type="date"
placeholder="Pick a day"
:prefix-icon="customPrefix"
/>
</template>
<script lang="ts" setup>
import { h, ref, shallowRef } from "vue";
const value1 = ref("");
const customPrefix = shallowRef({
render() {
return h("p", "pre");
},
});
</script>
<style scoped>
.demo-date-picker {
display: flex;
width: 100%;
padding: 0;
flex-wrap: wrap;
}
.demo-date-picker .block {
padding: 30px 0;
text-align: center;
border-right: solid 1px var(--el-border-color);
flex: 1;
}
.demo-date-picker .block:last-child {
border-right: none;
}
.demo-date-picker .demonstration {
display: block;
color: var(--el-text-color-secondary);
font-size: 14px;
margin-bottom: 20px;
}
</style>
隐藏源码
Slots
使用 slots 中的 ${Config.namespace}Reader, ${Config.namespace}Writer 覆盖读写状态渲染函数。
writer: Mon Oct 05 2026 17:06:55 GMT+0800 (中国标准时间)
vue
<template>
<div class="mt-16px">
<el-date-picker-dispatcher
v-model="value1"
type="date"
placeholder="Pick a day"
>
<template #[`${Config.namespace}Reader`]>
<span style="color: green" key="reader">reader: {{ value1 }}</span>
</template>
<template #[`${Config.namespace}Writer`]>
<span style="color: red" key="writer">writer: {{ value1 }}</span>
</template>
</el-date-picker-dispatcher>
</div>
</template>
<script lang="ts" setup>
import { ref } from "vue";
import { Config } from "element-plus-form-dispatcher";
const value1 = ref(new Date());
</script>
隐藏源码
API
与 el-date-picker 的 props attrs slots 完全一致