安装和使用
Vanilla Calendar Pro 可以轻松集成到任何项目中。根据您管理依赖项和构建项目的方式,有几种安装方法。
通过包管理器安装
安装 Vanilla Calendar Pro 最常见的方法是使用包管理器。这种方法非常适合使用 Node.js 和现代构建工具的项目。
- 安装包:
npm install vanilla-calendar-pro
# 或
yarn add vanilla-calendar-pro
# 或
pnpm add vanilla-calendar-pro- 在文档的 body 中创建一个带有任意 CSS 选择器的 HTML 元素:
<html>
<head>
</head>
<body>
<div id="calendar"></div>
</body>
</html>在本节的演示目的中,我们将使用
#calendar 作为 CSS 选择器,但您可以创建和使用任何其他选择器。- 在您的 JavaScript 或 TypeScript 文件中导入脚本,创建日历实例并初始化它。
import { Calendar } from 'vanilla-calendar-pro';
const calendar = new Calendar('#calendar', {
// 您的设置
});
calendar.init();- 在同一文件中导入样式。
index.css文件包含日历的布局网格,以及浅色和深色主题。
import 'vanilla-calendar-pro/styles/index.css';您也可以选择分别包含布局和主题样式,如下所示:
import 'vanilla-calendar-pro/styles/layout.css'; // 仅骨架
import 'vanilla-calendar-pro/styles/themes/light.css'; // 浅色主题
import 'vanilla-calendar-pro/styles/themes/dark.css'; // 深色主题
// 或任何其他自定义主题...- 没有任何自定义设置的简单初始化的完整示例:
正如您可能在此示例中注意到的,我们使用的是扁平日历视图,而不使用 «输入» 字段,如果您对如何将日历集成到 «输入» 中感兴趣,请查看 此示例。
本地或 CDN
如果您需要快速集成 Vanilla Calendar Pro 而不使用构建工具或包管理器,可以通过 CDN 包含它,或 下载存档 最新版本并在本地包含它。
<html>
<head>
<link href="https://cdn.jsdelivr.net/npm/vanilla-calendar-pro/styles/index.css" rel="stylesheet">
<script src="https://cdn.jsdelivr.net/npm/vanilla-calendar-pro/index.js" defer></script>
</head>
<body style="display: flex; align-items: start">
<div id="calendar"></div>
<script>
document.addEventListener('DOMContentLoaded', () => {
// 解构 Calendar 构造函数
const { Calendar } = window.VanillaCalendarPro;
// 创建日历实例并初始化它。
const calendar = new Calendar('#calendar');
calendar.init();
});
</script>
</body>
</html>extensions
motion 提供动画和手势。time 提供 12/24 小时时间选择。annotations 提供日期弹出内容、样式修饰符和范围提示。weeks 提供一周视图、折叠、周数和星期/周数点击回调。months 提供多月显示和导航。ESM 打包工具可移除未导入和注册的扩展。
import { Calendar, motion, time, annotations } from 'vanilla-calendar-pro';
import 'vanilla-calendar-pro/styles/index.css';
const calendar = new Calendar('#calendar', {
extensions: [motion, time, annotations],
animation: true,
selectionTimeMode: 24,
popups: { '2026-09-21': { html: 'Event' } },
});
calendar.init();输入框日历、日期和范围选择以及月份和年份选择仍属于核心功能。普通星期标题无需扩展。完整的普通 <script> / CommonJS 构建会自动注册全部五个扩展。CSS 导入保持不变。
模块化 CSS
现有的 styles/index.css、styles/layout.css 和 styles/themes/*.css 仍提供完整样式并保持兼容。要减小 CSS 体积,可以只导入需要的部分。注册 JavaScript 扩展不会自动加载 CSS。
按需导入 CSS 的说明见样式参考。原有完整样式表仍受支持,示例仅导入所需部分。