JGuang

日历

Calendar · Arco Design

交互预览
npm install @arco-design/web-react@2.66.18

日历 Calendar

日历组件。

安装

npm install @arco-design/web-react@2.66.18

在入口引入 @arco-design/web-react/dist/css/arco.css,用 ConfigProvider 设置语言。React 19 项目还需在入口最先引入 @arco-design/web-react/es/_util/react-19-adapter,否则 Message、Modal 等命令式 API 无法渲染。

示例

  • 基本用法:日历的基本用法。
  • 下拉选择的头部:除了默认的头部切换外,也支持下拉选择的头部,更快速的定位。
  • 卡片日历:设置 panel=true,可以使用卡片日历。

示例来自 Arco Design 官方仓库(MIT),固定在 npm 2.66.18 对应的提交;部分示例使用在线图片或上传地址,预览中网络请求被禁用。

API

Calendar

参数名描述类型默认值
allowSelect是否允许选中和切换日期,panel 模式下默认可选中切换boolean-
isWeek周选择boolean-
panel是否放在容器中进行展示。boolean-
panelTodayBtn是否显示跳转到今天的按钮boolean-
defaultMode选择日期的月日历和选择月份的年日历。'day' | 'week' | 'month' | 'year'month
headerType有两种头部可供选择,默认的按钮类型和下拉框类型,只在全屏日历模式下生效。'button' | 'select'button
mode选择日期的月日历和选择月份的年日历,受控模式。'day' | 'week' | 'month' | 'year'-
panelOperations卡片模式下配置操作按钮Array<'left' | 'double-left' | 'right' | 'double-right'>-
className节点类名string | string[]-
dayStartOfWeek每周的第一天开始于周几,0 - 周日,1 - 周一。0 | 10
locale国际化配置Record<string, any>-
panelWidth卡片模式的宽度number | string265
style节点样式CSSProperties-
dateInnerContent定制日期单元格,内容会被添加到单元格内,只在全屏日历模式下生效。(currentDate: Dayjs) => ReactNode-
dateRender定制日期显示,会完全覆盖日期单元格。(currentDate: Dayjs) => ReactNode-
disabledDate不可选取的时间(current: Dayjs) => boolean-
headerRender自定义头部渲染。(props: {value?: Dayjs;pageShowDate?: Dayjs;mode?: string;onChange;onChangePageDate;onChangeMode;}) => ReactNode-
monthRender定制月份显示,会完全覆盖月份单元格。(currentDate: Dayjs) => ReactNode-
onChange日期变化触发的回调。(date: Dayjs) => void-
onPanelChange面板日期发生改变触发的回调。(date: Dayjs) => void-