date week range

date-week-range（週範圍選擇器）

v1 版本基於element-ui 2.x 開發，可依賴element-ui 2.x 使用；也可獨立使用，但要引入對應的樣式

v2 版本是基於element-plus 開發。可依賴element-plus 使用；也可獨立使用，但要引入對應的樣式。

v1 版本傳送門

範例

v1 版本、v2 版本

目的

• 專案需求，需要用到週選擇器這功能，但沒找到對應的元件庫，故自己基於element-ui/element-plus 改造了個。

相容

• v1 版本，對應v1分支，僅支援vue2
• v2 版本，對應v2分支，僅支援vue3

計劃

• 1.x 版本，支援vue2（已完成）
• 2.x 版本，將進行支援vue3，計畫透過date-week-range@next 方式升級使用。
• 等待vue3穩定，將會把主版本從v1 切換至v2 ，master 分支也將同步成v2 分支。

注意

• 不會自動注入css，需手動引入，以避免出現樣式覆蓋情況；如果全局引入了element-plus 樣式，則不需額外引入！

• 本機開發模式，預設使用esm模組，如需轉義成es5，請參考：

  // 在 vue-cli 将指定的 node_modules 模块转义成es5：
  // vue.config.js
  module . exports = {
    // 省略代码
    transpileDependencies : [ 'date-week-range' , 'element-plus' ]
  }

安裝&& 引入

• 安裝

npm install date-week-range@next --save
yarn add date-week-range@next --save

• 註冊

全域註冊

 import DateWeekRange from 'date-week-range'
import { createApp } from 'vue'

// 引入样式；如果全局引入了 element-plus 样式，则无需再次引入


// 全局引入 element-plus 样式
// import 'element-plus/dist/index.css'

// 或引入
// import 'element-plus/theme-chalk/el-icon.css'
// import 'element-plus/theme-chalk/el-date-picker.css'
// import 'element-plus/theme-chalk/el-var.css';

// 或引入
// import 'date-week-range/index.css'

const app = createApp ( {
  /* ... */
} )

app . use ( DateWeekRange ) 

局部註冊

 < template >
  < DateWeekRange v-model = "test" > </ DateWeekRange >
</ template >

< script >
import { DateWeekRange } from 'date-week-range'
// 注意要引入样式！引入方式参考上面

export default {
  data ( ) {
    return {
      test : ''
    }
  } ,
  components : {
    DateWeekRange
  }
}
< / script>

瀏覽器使用

 <!-- 引入样式。如果全局引入了element-plus 样式，则不需额外引入 -->
<!-- 全局引入 element-plus 样式 -->
< link type =" text/css " href =" https://unpkg.com/element-plus/lib/theme-chalk/index.css " >
<!-- 或者额外引入 -->
< link type =" text/css " href =" https://unpkg.com/element-plus/lib/theme-chalk/el-icon.css " >
< link type =" text/css " href =" https://unpkg.com/element-plus/lib/theme-chalk/el-date-picker.css " >

< script src =" https://unpkg.com/date-week-range@next " > </ script >

< body >
  < div id =" app " >
    < date-week-range v-model =" test " > </ date-week-range >
  </ div >
</ body >

< script >
const app = window . Vue . createApp ( {
  data ( ) {
    return {
      test : ''
    }
  }
} )
app . use ( window . DateWeekRange )
app . mount ( "#app" )
</ script >

國際化

預設使用中文

全域註冊時

 import { createApp } from 'vue'
import App from './App.vue'
import DateWeekRange from 'date-week-range'
import 'dayjs/locale/zh-cn'
import locale from 'element-plus/lib/locale/lang/zh-cn'

const app = createApp ( App )

app . use ( DateWeekRange , { locale } )
app . mount ( '#app' )

export default app

局部註冊時

 < script >
import { DateWeekRange , locale } from 'date-week-range'
import lang from 'element-plus/lib/locale/lang/zh-cn'
import 'dayjs/locale/zh-cn'

locale(lang)
/* 省略… */
</ script >

文件

此插件是在element-plus 框架中的el-date-picker 元件基礎上進行開發，其文件和el-date-picker元件type="daterange" 一致。