# FxCalendar 日历

显示日期

# Attributes

参数 说明 类型 可选值 默认值
value / v-model 绑定值 Date/string/number
range 时间范围,包括开始时间与结束时间。开始时间必须是周一,结束时间必须是周日,且时间跨度不能超过两个月。 Array
first-day-of-week 周起始日 Number 1 到 7 1

# dateCell scoped slot 参数

参数 说明 类型 可选值 默认值
date 单元格代表的日期 Date
data { type, isSelected, day},type 表示该日期的所属月份,可选值有 prev-month,current-month,next-month;isSelected 标明该日期是否被选中;day 是格式化的日期,格式为 yyyy-MM-dd Object

# 基本

设置 value 来指定当前显示的月份。如果 value 未指定,则显示当月。value 支持 v-model 双向绑定。

<fx-calendar v-model="value">
</fx-calendar>

<script>
  export default {
    data() {
      return {
        value: new Date()
      }
    }
  }
</script>
显示代码 复制代码

# 自定义内容

通过设置名为 dateCellscoped-slot 来自定义日历单元格中显示的内容。在 scoped-slot 可以获取到 date(当前单元格的日期), data(包括 type,isSelected,day 属性)。详情解释参考下方的 API 文档。

<fx-calendar>
  <!-- 这里使用的是 2.5 slot 语法,对于新项目请使用 2.6 slot 语法-->
  <template
    slot="dateCell"
    slot-scope="{date, data}">
    <p :class="data.isSelected ? 'is-selected' : ''">
      {{ data.day.split('-').slice(1).join('-') }} {{ data.isSelected ? '✔️' : ''}}
    </p>
  </template>
</fx-calendar>
<style>
  .is-selected {
    color: #1989FA;
  }
</style>
显示代码 复制代码

# 自定义范围

设置 range 属性指定日历的显示范围。开始时间必须是周一,结束时间必须是周日,且时间跨度不能超过两个月。

<fx-calendar :range="['2019-03-04', '2019-03-24']">
</fx-calendar>
显示代码 复制代码
lastUpdate: 5/3/2023, 11:40:26 PM