1.0.0-beta.2 • Published 11 months ago

@hey_dino/quarter-picker v1.0.0-beta.2

Weekly downloads
-
License
ISC
Repository
github
Last release
11 months ago

alt 使用示例

The Quarter Picker based on Vue-2.x and Element-UI

前置要求

如果你针对 Element-UI 使用了 按需引入 , 确保下述组件已注册:

  • Input
  • Icon
  • Popover

安装

npm install @hey_dino/quarter-picker

注册

你可以通过 全局 或 局部 的方式引入QuarterPicker

注意:样式文件需要单独引入

全局注册

在 main.js:

import Vue from 'vue';
import App from './App.vue';
import QuarterPicker from '@hey_dino/quarter-picker';
import '@hey_dino/quarter-picker/lib/style/index.css';

Vue.use(QuarterPicker);

new Vue({
  el: '#app',
  render: h => h(App)
});

局部注册

在任意组件:

<script>
import QuarterPicker from '@hey_dino/quarter-picker';

export default {
  components: { QuarterPicker },
};
</script>

<style>
@import '@hey_dino/quarter-picker/lib/style/index.css'
</style>

快速开始

<quarter-picker v-model="quarter" placeholder="please input" />

日期格式

使用 format 指定输入框的格式;使用 value-format 指定绑定值的格式

以下为常用的格式化字符串,以 UTC 2024年9月1日 00:00:00 为例:

请注意大小写;下述 含义 中标注星号,表示与 Element-UI 日期格式 使用方式有差异

占位符含义备注举例
YY年*简称,两位数24
YYYY年*全称2024
M9
MM补零09
D日*1
DD日*补零01
Q季度数值格式3
H小时0
HH小时补零,24小时制00
m分钟0
mm分钟补零00
s0
ss补零00
h小时12小时制12
hh小时补零,12小时制12
AAM/PM大写,仅 format 可用AM
aam/pm小写,仅 format 可用am
x时间戳*1725120000000
XXX无需格式化的字符避免被错误解析,例如 Q 可避免被解析为季度XXX

Attributes

名称说明类型可选值默认值
value/v-model绑定值,默认返回 所选季度 的初始日期String
readonly只读Booleanfalse
disabled禁用Booleanfalse
editable支持手动输入Booleantrue
clearable支持一键清空Booleantrue
width输入框宽度String220px
size输入框高度Stringmedium / small / mini
placeholder占位内容String
format显示值格式String见上方 日期格式YYYY-QQ
value-format绑定值格式String见上方 日期格式YYYY-MM-DD
popper-class弹出框类名String
picker-options特殊配置项,详见下表
name输入框元素属性String
prefix-icon自定义头部图标的名称Stringel-icon-date
clear-icon自定义清空图标的名称Stringel-icon-circle-close
validate-event绑定值发生变化时,是否触发表单的校验Booleantrue

Picker Options

名称说明类型可选值默认值
disabledDate设置禁用状态,禁用则返回 true,反之返回 falseFunction({ startTime, endTime })
cellClassName设置单个季度DOM的类名Function({ startTime, endTime })

Events

名称说明参数
change选定值被确定时触发绑定值 value
blur当 input 失去焦点时触发组件实例
focus当 input 获得焦点时触发组件实例

Methods

名称说明参数
focus使 input 获取焦点
1.0.0-beta.2

11 months ago

1.0.0-beta.1

11 months ago