日期时间组件

组件说明

日期时间组件用于选择日期和时间,支持精确到秒的时间选择。

用法示例

use plugin\xbCode\builder\Builder;
use plugin\xbCode\builder\Renders\Form;

Builder::form(function (Form $builder) {
    // 基础用法
    $builder->addRowDateTime('datetime', '日期时间', '', function($component) {
        $component->format('YYYY-MM-DD HH:mm:ss');
        $component->placeholder('请选择日期时间');
        $component->clearable(true);
    });

    // 带快捷选项
    $builder->addRowDateTime('publish_time', '发布时间', '', [
        'shortcuts' => ['now', 'today', 'yesterday'],
        'minDate' => '${TODAY}',
        'closeOnSelect' => false
    ]);
});

组件参数

参数名类型默认值说明
namestring-字段名称
labelstring-字段标签
valuestring-默认值
valueFormatstring'YYYY-MM-DD HH:mm:ss'日期时间值格式
displayFormatstring-显示格式
placeholderstring-占位文本
shortcutsarray-快捷键
minDatestring-限制最小日期时间
maxDatestring-限制最大日期时间
clearableboolfalse是否可清除
closeOnSelectbooltrue选择后是否关闭
requiredboolfalse是否必填
disabledboolfalse是否禁用

使用说明

  1. 日期时间组件是日期组件的扩展,包含时分秒选择
  2. shortcuts支持:now、today、yesterday等
  3. valueFormat默认为'YYYY-MM-DD HH:mm:ss'