日历页眉

日历页眉提供导航控制、视图切换器和搜索功能。您可以自定义其行为或完全替换它。

隐藏页眉

如果您想构建自己的导航，或者只是不需要默认页眉，可以禁用它。

const calendar = useCalendarApp({
  views: [createMonthView()],
  useCalendarHeader: false, // 隐藏默认页眉
});

自定义页眉

Breaking change from v3.4.1

不再支持向 useCalendarHeader 传入函数。请将自定义页眉迁移到 DayFlowCalendar 的 calendarHeader 插槽，如下所示。

通过 calendarHeader 内容插槽，您可以用自己的组件替换默认页眉。渲染器接收日历的状态和辅助方法，让您可以从自己的 UI 控制导航和搜索。

import { useCalendarApp, DayFlowCalendar, createMonthView } from '@dayflow/react';

function MyCalendar() {
  const calendar = useCalendarApp({
    views: [createMonthView()],
  });

  return (
    <DayFlowCalendar
      calendar={calendar}
      calendarHeader={() => (
        <div className='custom-header'>
          <button onClick={() => calendar.goToPrevious()}>‹</button>
          <button onClick={() => calendar.goToToday()}>今天</button>
          <button onClick={() => calendar.goToNext()}>›</button>
        </div>
      )}
    />
  );
}

<template>
  <DayFlowCalendar :calendar="calendar">
    <template #calendarHeader="{ calendar }">
      <div class="custom-header">
        <button @click="calendar.goToPrevious()">‹</button>
        <button @click="calendar.goToToday()">今天</button>
        <button @click="calendar.goToNext()">›</button>
      </div>
    </template>
  </DayFlowCalendar>
</template>

<script setup>
import { DayFlowCalendar, useCalendarApp } from '@dayflow/vue';
import { createMonthView } from '@dayflow/core';

const calendar = useCalendarApp({
  views: [createMonthView()],
});
</script>

import { Component } from '@angular/core';
import { DayFlowCalendarModule } from '@dayflow/angular';
import { createMonthView } from '@dayflow/core';

@Component({
  selector: 'app-root',
  standalone: true,
  imports: [DayFlowCalendarModule],
  template: `
    <dayflow-calendar
      [calendar]="calendar"
      [calendarHeader]="customHeader"
    >
    </dayflow-calendar>

    <ng-template #customHeader let-args>
      <div class="custom-header">
        <button (click)="args.calendar.goToPrevious()">‹</button>
        <button (click)="args.calendar.goToToday()">今天</button>
        <button (click)="args.calendar.goToNext()">›</button>
      </div>
    </ng-template>
  `
})
export class AppComponent {
  calendar = {
    views: [createMonthView()],
  };
}

<!-- App.svelte -->
<script lang="ts">
  import { DayFlowCalendar, useCalendarApp } from '@dayflow/svelte';
  import { createMonthView } from '@dayflow/core';
  import CustomHeader from './CustomHeader.svelte';

  const calendar = useCalendarApp({
    views: [createMonthView()],
  });
</script>

<DayFlowCalendar {calendar} calendarHeader={CustomHeader} />

<!-- CustomHeader.svelte -->
<script lang="ts">
  import type { CalendarHeaderProps } from '@dayflow/core';
  let { calendar } = $props<CalendarHeaderProps>();
</script>

<div class="custom-header">
  <button onclick={() => calendar.goToPrevious()}>‹</button>
  <button onclick={() => calendar.goToToday()}>今天</button>
  <button onclick={() => calendar.goToNext()}>›</button>
</div>

插槽参数

插槽渲染器接收以下参数：

参数	描述
`calendar`	`CalendarApp` 实例。
`switcherMode`	当前视图切换器模式（`buttons` 或 `select`）。
`onAddCalendar`	添加新日历的处理函数。
`onSearchChange`	更新搜索查询的处理函数。
`onSearchClick`	点击搜索图标时的处理函数。
`searchValue`	当前搜索字符串。
`isSearchOpen`	搜索 UI 当前是否打开。
`isEditable`	日历当前是否处于可编辑状态。
`safeAreaLeft`	左侧内边距（px），用于在 macOS 模式下避免与交通灯按钮重叠。