基于 Vue 3 + Element Plus自定義時(shí)間范圍選擇組件使用教程
?? 自定義時(shí)間范圍選擇組件使用教程(基于 Vue 3 + Element Plus)
? 一個(gè)靈活實(shí)用的時(shí)間范圍選擇器,支持開始時(shí)間、結(jié)束時(shí)間、快捷時(shí)間選項(xiàng)、本地雙向綁定、插槽擴(kuò)展等功能。


?? 一、功能介紹
該組件基于 Element Plus 的 <el-date-picker> 和 <el-select> 封裝,支持以下特性:
v-model:startTime和v-model:endTime雙向綁定;- 常用時(shí)間快捷選項(xiàng):今天、昨天、本月、上月等;
- 自定義插槽
before,可拓展前置內(nèi)容; - 自動(dòng)識(shí)別當(dāng)前選擇是否為快捷項(xiàng)并高亮;
- 支持國(guó)際化
$t(); - 可自定義初始選中項(xiàng);
- 樣式美觀、可無(wú)縫集成至查詢表單。
?? 二、組件源碼
?? components/TimeSeparation.vue
<template>
<template>
<slot name="before" />
<el-date-picker
class="timeSeparationClassStart"
style="width:160px"
v-model="startTime"
type="datetime"
format="YYYY-MM-DD HH:mm:ss"
value-format="YYYY-MM-DD HH:mm:ss"
:default-time="new Date(2000, 1, 1, 0, 0, 0)" />
<span class="timeSeparationClassCenter">-</span>
<el-date-picker
class="timeSeparationClassEnd"
style="width:160px"
v-model="endTime"
type="datetime"
format="YYYY-MM-DD HH:mm:ss"
value-format="YYYY-MM-DD HH:mm:ss"
:default-time="new Date(2000, 1, 1, 23, 59, 59)" />
<el-select v-model="dateRangeType" class="timeSeparationClass_after" style="width:100px" @change="changeDateRange">
<el-option
v-for="dict in dateList"
:key="dict.value"
:label="$t(dict.label)"
:value="dict.value" />
</el-select>
</template><script setup>
<script setup>
import { useVModel } from '@vueuse/core'
import i18n from '@/i18n'
import { parseTime } from '@/utils/ruoyi'
const emit = defineEmits(['update:startTime', 'update:endTime', 'change'])
const props = defineProps({
startTime: String,
endTime: String,
defaultTime: Number, // 默認(rèn)快捷選中類型
showAfter: { type: Boolean, default: true }
})
// 雙向綁定
const startTime = useVModel(props, 'startTime', emit)
const endTime = useVModel(props, 'endTime', emit)
const dateRangeType = ref(props.defaultTime)
function changeDateRange(e) {
switch (e) {
case 1: setDaysAgo(7); break;
case 2: setThisMonth(); break;
case 4: setToday(); break;
case 5: setYesterday(); break;
case 6: setLastMonth(); break;
}
}
// 日期處理
function setDaysAgo(days) {
const now = new Date();
const start = new Date(now)
start.setDate(start.getDate() - (days - 1))
start.setHours(0, 0, 0, 0)
now.setHours(23, 59, 59, 999)
startTime.value = parseTime(start)
endTime.value = parseTime(now)
}
function setToday() {
const now = new Date();
const start = new Date(now)
start.setHours(0, 0, 0, 0)
now.setHours(23, 59, 59, 999)
startTime.value = parseTime(start)
endTime.value = parseTime(now)
}
function setYesterday() {
const start = new Date()
const end = new Date()
start.setDate(start.getDate() - 1)
end.setDate(end.getDate() - 1)
start.setHours(0, 0, 0, 0)
end.setHours(23, 59, 59, 999)
startTime.value = parseTime(start)
endTime.value = parseTime(end)
}
function setThisMonth() {
const now = new Date()
const start = new Date(now.getFullYear(), now.getMonth(), 1)
const end = new Date(now.getFullYear(), now.getMonth() + 1, 0)
end.setHours(23, 59, 59, 999)
startTime.value = parseTime(start)
endTime.value = parseTime(end)
}
function setLastMonth() {
const now = new Date()
const start = new Date(now.getFullYear(), now.getMonth() - 1, 1)
const end = new Date(now.getFullYear(), now.getMonth(), 0)
end.setHours(23, 59, 59, 999)
startTime.value = parseTime(start)
endTime.value = parseTime(end)
}
watch([() => startTime.value, () => endTime.value], ([newStart, newEnd]) => {
const ranges = [
{ num: 2, range: getTimeRange('本月') },
{ num: 4, range: getTimeRange('今天') },
{ num: 5, range: getTimeRange('昨天') },
{ num: 6, range: getTimeRange('上月') },
]
const nowRange = [newStart, newEnd]
const matched = ranges.find(i => JSON.stringify(i.range) === JSON.stringify(nowRange))
dateRangeType.value = matched ? matched.num : undefined
emit('change')
})
function getTimeRange(type) {
const now = new Date()
let start = new Date(), end = new Date()
switch (type) {
case '上月':
start = new Date(now.getFullYear(), now.getMonth() - 1, 1)
end = new Date(now.getFullYear(), now.getMonth(), 0)
break
case '本月':
start = new Date(now.getFullYear(), now.getMonth(), 1)
end = new Date(now.getFullYear(), now.getMonth() + 1, 0)
break
case '今天':
start.setHours(0, 0, 0, 0)
end.setHours(23, 59, 59, 999)
break
case '昨天':
start.setDate(start.getDate() - 1)
end.setDate(end.getDate() - 1)
start.setHours(0, 0, 0, 0)
end.setHours(23, 59, 59, 999)
break
}
return [parseTime(start), parseTime(end)]
}
const { t } = i18n.global
const dateList = [
{ label: t('this_month'), value: 2 },
{ label: t('today'), value: 4 },
{ label: t('yesterday'), value: 5 },
{ label: t('last_month'), value: 6 }
]
</script><style scoped lang="scss">
.timeSeparationClassCenter {
display: flex;
align-items: center;
background-color: #fff;
box-shadow:
inset 0 1px 0 0 var(--el-input-border-color),
inset 0 -1px 0 0 var(--el-input-border-color);
}
.timeSeparationClassStart .el-input__wrapper {
border-radius: var(--el-border-radius-base) 0 0 var(--el-border-radius-base);
box-shadow: inset 1px 0 0 0 var(--el-input-border-color);
}
.timeSeparationClassEnd .el-input__wrapper {
border-radius: 0;
box-shadow: inset -1px 0 0 0 var(--el-input-border-color);
}
.timeSeparationClass_after .el-select__wrapper {
border-radius: 0 var(--el-border-radius-base) var(--el-border-radius-base) 0;
background-color: var(--el-fill-color-light);
}?? 三、使用示例
<template>
<TimeSeparation
v-model:startTime="queryParams.startTime"
v-model:endTime="queryParams.endTime"
:default-time="2"
@change="onDateChange"
/>
</template>
<script setup>
import TimeSeparation from '@/components/TimeSeparation.vue'
const queryParams = reactive({
startTime: '',
endTime: ''
})
function onDateChange() {
console.log('時(shí)間范圍變化:', queryParams)
}
</script>?? 四、Props & Emits API 文檔
Props
| 參數(shù)名 | 類型 | 默認(rèn)值 | 說明 |
|---|---|---|---|
startTime | string | '' | 外部綁定開始時(shí)間 |
endTime | string | '' | 外部綁定結(jié)束時(shí)間 |
defaultTime | number | 無(wú) | 初始選中快捷選項(xiàng)(如 2:本月) |
showAfter | boolean | true | 是否顯示快捷時(shí)間選擇 |
Emits
| 事件名 | 參數(shù) | 說明 |
|---|---|---|
update:startTime | string | 綁定用 v-model:startTime |
update:endTime | string | 綁定用 v-model:endTime |
change | 無(wú) | 時(shí)間范圍變更回調(diào) |
?? 五、拓展建議(可選)
| 拓展方向 | 建議實(shí)現(xiàn)方法 |
|---|---|
| 動(dòng)態(tài)傳入快捷項(xiàng) | 增加 shortcuts: Array prop |
| 時(shí)間范圍校驗(yàn) | 內(nèi)置日期合法性校驗(yàn) + disabledDate |
| 表單集成支持 | 接入 <el-form-item> + rules |
| 可讀性文本輸出 | 增加 displayRange: computed 返回“xx 至 yy” |
到此這篇關(guān)于基于 Vue 3 + Element Plus自定義時(shí)間范圍選擇組件使用教程的文章就介紹到這了,更多相關(guān)vue elementplus時(shí)間范圍選擇組件內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
vue-cli 默認(rèn)路由再子路由選中下的選中狀態(tài)問題及解決代碼
這篇文章主要介紹了vue-cli 默認(rèn)路由再子路由選中下的選中狀態(tài)問題及解決代碼,非常不錯(cuò),具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2018-09-09
vue項(xiàng)目及axios請(qǐng)求獲取數(shù)據(jù)方式
這篇文章主要介紹了vue項(xiàng)目及axios請(qǐng)求獲取數(shù)據(jù)方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2022-08-08
淺談vue中使用編輯器vue-quill-editor踩過的坑
這篇文章主要介紹了淺談vue中使用編輯器vue-quill-editor踩過的坑,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2020-08-08
ElementUI的this.$notify.close()調(diào)用不起作用的解決
本文主要介紹了ElementUI的this.$notify.close()調(diào)用不起作用的解決,文中通過示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2021-08-08
vue報(bào)錯(cuò)之exports is not defined問題的解決
這篇文章主要介紹了vue報(bào)錯(cuò)之exports is not defined問題的解決方案,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2023-07-07
前端單獨(dú)實(shí)現(xiàn)vue動(dòng)態(tài)路由的示例代碼
Vue動(dòng)態(tài)路由權(quán)限涉及根據(jù)用戶權(quán)限動(dòng)態(tài)生成路由配置,實(shí)現(xiàn)此功能可增強(qiáng)應(yīng)用安全性、靈活性,提升用戶體驗(yàn)和開發(fā)效率,本文就來介紹一下前端單獨(dú)實(shí)現(xiàn)vue動(dòng)態(tài)路由的示例代碼,感興趣的可以了解一下2024-09-09

