@ac-codeprod/vuetify2-daterange-picker 中文文档教程

发布于 5年前 浏览 18 项目主页 更新于 3年前

Vuetify2 daterange picker

我需要更好地自定义 Vuetify daterange picker 并将其与 Vuetify 2.x 版一起使用

Table of Contents

Requirements

您必须拥有 Vuetify 2。 X。 如果您在此页面上,您可能已经拥有它们。 但是,如果您还没有安装它们,您可以这样做。

yarn add vuetify

您还需要 date-fns 才能使组件正常工作。 日期操作、格式化和所有与日期相关的事情都需要它。 它很棒,因为它支持代码拆分和 tree shaking,并为组件增加了最少的负担。

yarn add date-fns

当您安装 @ac-codeprod/vuetify2-daterange-picker 时,对等依赖项警告应该会为您指出这一点。

Installation & Usage

Installation

yarn add @ac-codeprod/vuetify2-daterange-picker

Usage

// If you wanna use it in components, please import necessary files as shown above
<template>
  <v-daterange v-model="range"></v-daterange>
</template>
<script>
import { VDaterange } from '@ac-codeprod/vuetify2-daterange-picker'
import '@ac-codeprod/vuetify2-daterange-picker/dist/vuetify2-daterange-picker.css'
export default {
  components: { VDaterange },
  data() {
    return {
      range: {}
    }
  }
}
</script>

Props, Events & Slots

Props

value

说明:选择器的起始值和结束值。

默认值:如果 prop 未定义,则以 yyyy-MM-dd 格式将开始和结束值设置为今天的对象。 但是,如果传递的是空对象,则起始值和结束值将为空字符串。 如果传递的对象包含 yyyy-MM-dd 格式的开始值和结束值,则选择器将初始化为该范围。


disabled

说明:如果为 true ,则禁用打开日期选择器菜单的输入。

默认值:false


dark

说明:将深色主题变体应用于组件。

默认值:false


start-label

说明:未选择范围时显示在开始日期输入占位符中的文本。

默认值:'Start Date'


end-label

描述:显示在输入占位符中的结束文本未选择范围时的日期。

默认:'End Date'


preset-label

描述:显示为列表标题的文本的预设。

默认值:'Presets'


presets

描述:以下形式的预设对象列表。

默认值:一个空数组。


no-presets

描述:关闭预设的显示。

默认值:false


separator-label

说明:在开始日期和结束日期之间的输入占位符中显示的文本。

默认值:'To'


min

说明:可选择的最小日期,格式为 yyyy-MM-dd。 与 Vuetify 的日期选择器 的 min 道具相同。

默认值:未定义


max

说明:yyyy-MM-dd 格式的最大可选日期。 与 Vuetify 的日期选择器 的 max 属性相同。

默认值:未定义


locale

描述:设置语言环境。 接受带有 BCP 47 语言标记的字符串。 与 Vuetify 的日期选择器 的语言环境属性相同。

默认值:'en-us'


first-day-of-week

说明:设置一周的第一天,从 0 开始表示星期日.

默认:0


no-title

描述:Vuetify 的日期选择器

默认值:false


display-format

描述:所选范围在输入中的显示格式。

默认:yyyy-MM-dd


highlight-color

描述:Vuetify 颜色类 您要应用于范围内突出显示的日期。 您甚至可以根据需要提供自己的课程和风格亮点。

默认值:''


show-reset

说明:在取消旁边的日期范围对话框操作中显示重置按钮。 单击它会重置选择器,并为开始和结束发出空值。

默认:

If you don't want to show a reset button and still wanna reset the picker programmatically, you can get a ref to the component and call the reset() method.


next-icon

描述:Vuetify 的日期的 next-icon 属性相同选择器

默认值:'$vuetify.icons.next'


prev-icon

描述:Vuetify 的日期选择器

默认值:'$vuetify.icons.prev'


input-props

描述:包含所有 Vuetify 的文本字段 支持。 这有助于您根据需要自定义输入,包括更改字段样式,例如 outline 或 solo 等。

默认值:{}

注意:某些属性,例如 readonly、placeholder、disabled 和 value 不能使用此中的值覆盖支柱。


menu-props

描述:包含Vuetify 菜单的所有道具的对象 支持。 这有助于您根据需要自定义菜单。

默认值:{}

注意:某些属性(例如 close-on-content-click 和 offset-y)无法使用此属性中的值覆盖。

Events

input

Description:每次应用新范围时发出。

事件数据:包含所选开始和结束日期的对象,格式为 yyyy-MM-dd。 示例:

{
  start: '2018-12-04',
  end: '2019-02-20',
  key: 'customize'
}

menu-closed

描述:当日期选择器菜单关闭时。

事件数据:undefined

Slots


title

Description:传递到这个插槽的内容成为卡的激活器,其中日期选择器打开。 如果存在,则提供的内容会在组件内呈现。


激活器

描述:传递到此位置的内容成为打开 Vuetify2 日期范围选择器的激活器。 如果存在,所提供的内容将呈现在组件中。 替换默认激活器。

Vuetify2 daterange picker

I need to better customize Vuetify daterange picker and use it with Vuetify version 2.x

Table of Contents

Requirements

You must have a Vuetify 2.x. You probably already have them if you are on this page. However, if you have not installed them, you can do so by doing.

yarn add vuetify

You also need to have date-fns for the component to work. It is required for date manipulation, formatting and all things related to dates. It is great because it supports code splitting and tree shaking and adds minimal baggage to the component.

yarn add date-fns

When you install @ac-codeprod/vuetify2-daterange-picker, the peer dependencies warning should point that out for you.

Installation & Usage

Installation

yarn add @ac-codeprod/vuetify2-daterange-picker

Usage

// If you wanna use it in components, please import necessary files as shown above
<template>
  <v-daterange v-model="range"></v-daterange>
</template>
<script>
import { VDaterange } from '@ac-codeprod/vuetify2-daterange-picker'
import '@ac-codeprod/vuetify2-daterange-picker/dist/vuetify2-daterange-picker.css'
export default {
  components: { VDaterange },
  data() {
    return {
      range: {}
    }
  }
}
</script>

Props, Events & Slots

Props

value

Description: The start and end values of the picker.

Default: An object having start and end values set to today in yyyy-MM-dd format if the prop is undefined. If an empty object is passed however, the start and end values will be empty strings. If the passed object contains start and end values in yyyy-MM-dd format, the picker is initialised to that range.


disabled

Description: if true , disables the input that opens date picker menu.

Default: false


dark

Description: Applies the dark theme variant to the component.

Default: false


start-label

Description: The text that shows up in the input placeholder for start date when no range is selected.

Default: 'Start Date'


end-label

Description: The text that shows up in the input placeholder for end date when no range is selected.

Default: 'End Date'


preset-label

Description: The text that shows up as the heading of the list of presets.

Default: 'Presets'


presets

Description: A list of preset objects of the following form.

Default: An empty array.


no-presets

Description: Turn off display of presets.

Default: false


separator-label

Description: The text that shows up in the input placeholder in-between start and end dates.

Default: 'To'


min

Description: he min selectable date in yyyy-MM-dd format. Same as the min prop for Vuetify's Date Picker.

Default: undefined


max

Description: The max selectable date in yyyy-MM-dd format. Same as the max prop for Vuetify's Date Picker.

Default: undefined


locale

Description: Sets the locale. Accepts a string with a BCP 47 language tag. Same as the locale prop for Vuetify's Date Picker.

Default: 'en-us'


first-day-of-week

Description: Sets the first day of the week, starting with 0 for Sunday.

Default: 0


no-title

Description: Same as the no-title prop for Vuetify's Date Picker.

Default: false


display-format

Description: The format in which the selected ranges should show up in the input.

Default: yyyy-MM-dd


highlight-color

Description: Vuetify color classes you want to apply to the highlighted dates in range. You can even supply your own class and style the highlight as you wish.

Default: ''


show-reset

Description: Shows a reset button in the date range dialog actions beside Cancel. This clicking on it resets the picker as well as it emits empty values for start and end.

Default: true

If you don't want to show a reset button and still wanna reset the picker programmatically, you can get a ref to the component and call the reset() method.


next-icon

Description: Same as next-icon prop for Vuetify's Date Picker.

Default: '$vuetify.icons.next'


prev-icon

Description: Same as prev-icon prop for Vuetify's Date Picker.

Default: '$vuetify.icons.prev'


input-props

Description: An object containing all the props that Vuetify's Text Field supports. This helps you customise the input as you wish including changing field styles such as outline or solo etc.

Default: {}

Note: Some props like readonly , placeholder, disabled and value cannot be overridden using values in this prop.


menu-props

Description: An object containing all the props that Vuetify's Menu supports. This helps you customise the menu as you wish.

Default: {}

Note: Some props like close-on-content-click , offset-y cannot be overridden using values in this prop.

Events

input

Description: Emitted every time a new range is applied.

Event Data: An object containing the selected start and end dates in yyyy-MM-dd format. Example:

{
  start: '2018-12-04',
  end: '2019-02-20',
  key: 'customize'
}

menu-closed

Description: When the date picker menu is closed.

Event Data: undefined

Slots


title

Description: Content passed to this slot becomes the activator of the card in which the date picker opens. If it is present, the provided content is rendered insidecomponent.


activator

Description: Content passed to this location becomes the activator to open Vuetify2 daterange picker. If present, the content provided is rendered in thecomponent. to replace the default activator.

    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文