JTSage-DateBox 技术文档

1. 安装指南

1.1 通过CDN安装

JTSage-DateBox 提供了通过CDN快速引用的方式。你可以直接在HTML文件中引入以下脚本：

<script src="http://cdn.jtsage.com/jtsage-datebox/latest/jtsage-datebox.min.js"></script>

1.2 通过下载安装

你也可以从CDN下载最新版本的JTSage-DateBox，并将其放置在你的项目目录中。下载地址为：

http://cdn.jtsage.com/jtsage-datebox/latest/

下载后，将文件放置在你的项目中，并在HTML文件中引用：

<script src="path/to/your/jtsage-datebox.min.js"></script>

1.3 自定义下载

JTSage-DateBox 还提供了自定义下载构建器，允许你选择所需的模块和功能，生成自定义的脚本文件。你可以访问以下地址进行自定义下载：

http://datebox.jtsage.dev/builder/

2. 项目使用说明

2.1 基本使用

JTSage-DateBox 是一个多模式的日期和时间选择器，支持多种CSS框架。你可以通过以下步骤在项目中使用它：

1. 在HTML中添加一个输入框，并为其设置 data-role="datebox" 属性：

<input type="text" data-role="datebox" data-datebox-mode="calbox">

2. 在页面加载完成后，初始化DateBox：

$(document).ready(function() {
    $('input[data-role="datebox"]').datebox();
});

2.2 显示模式

JTSage-DateBox 提供了四种不同的显示模式：

• CalBox: 日历模式
• SlideBox: 滑动模式
• FlipBox: 翻转模式
• TimeBox: 时间选择模式

你可以通过设置 data-datebox-mode 属性来选择不同的模式。

2.3 本地化

JTSage-DateBox 支持40多种语言和地区的本地化。你可以通过引入相应的语言文件来实现本地化：

<script src="path/to/your/jtsage-datebox-locale.js"></script>

3. 项目API使用文档

3.1 初始化

$('input[data-role="datebox"]').datebox({
    mode: 'calbox', // 选择显示模式
    theme: 'default', // 设置主题
    lang: 'zh-CN' // 设置语言
});

3.2 回调函数

JTSage-DateBox 提供了多种回调函数，用于在特定事件发生时执行自定义代码。例如：

$('input[data-role="datebox"]').datebox({
    mode: 'calbox',
    onOpen: function() {
        console.log('DateBox opened');
    },
    onChange: function() {
        console.log('Date changed');
    }
});

3.3 触发器

你可以通过触发器手动控制DateBox的行为：

$('input[data-role="datebox"]').datebox('open'); // 打开DateBox
$('input[data-role="datebox"]').datebox('close'); // 关闭DateBox
$('input[data-role="datebox"]').datebox('destroy'); // 销毁DateBox实例

4. 项目安装方式

4.1 本地构建

如果你需要对JTSage-DateBox进行定制或开发，可以通过以下步骤在本地构建项目：

1. 克隆项目仓库：

git clone https://github.com/jtsage/jtsage-datebox.git

2. 安装依赖：

npm install

3. 运行测试：

npm test

4. 构建文档：

npm run docs

5. 运行本地服务器：

npm run serve

4.2 自定义构建

你可以通过以下命令生成自定义版本的DateBox：

npm run build-builder
npm run servebuild

这将启动一个本地服务器，允许你通过构建器生成自定义的DateBox脚本。

---

通过以上文档，你应该能够顺利安装、使用和定制JTSage-DateBox，享受其丰富的功能和灵活的配置选项。