by-strange/datetime-picker

Yii 框架的日期和时间选择器。

0.1.6 2024-09-13 09:24 UTC

README

Tempus Dominus 日期/时间选择器。


php-version PHPUnit PHPUnit Codecov Infection

安装

安装此扩展的首选方法是通过 Composer

运行

composer require --dev --prefer-dist yii2-extensions/datetime-picker:^0.1

或在您的 composer.json 文件的 require 部分添加

"yii2-extensions/datetime-picker": "^0.1"

to

使用

名称

use Yii2\Extensions\DateTimePicker\DateTimePicker;

echo DateTimePicker::widget(['name' => 'datetime-picker']);

活动字段

use Yii2\Extensions\DateTimePicker\DateTimePicker;

echo $form
    ->field($formModel, 'date')
    ->widget(
        DateTimePicker::class,
        [
            'icon' => Icon::renderIcon('solid', 'calendar', ['class' => 'me-2 fa-solid'])
        ]
    );

活动字段浮动标签

use Yii2\Extensions\DateTimePicker\DateTimePicker;

echo $form
    ->field($formModel, 'date', ['options' => ['class' => 'mt-3']])
    ->label(false)
    ->widget(
        DateTimePicker::class,
        [
            'floatingLabel' => true,
            'icon' => Icon::renderIcon('solid', 'calendar', ['class' => 'me-2 fa-solid'])
        ]
    )

为 tempusDominus 小部件库提供动态主题配置

此库提供根据用户偏好或预定义设置动态配置 tempusDominus 小部件主题的功能。

功能概述

该库引入了一个功能,可以自动设置 tempusDominus 小部件的主题,该主题由用户的偏好或指定的配置确定。

自动主题配置

初始化时,库会检查主题配置设置。如果用户在库的配置中指定了主题,则它具有优先权。

基于浏览器的主题检测

如果没有设置特定主题或缺少 data-bs-theme 属性:库使用 prefers-color-scheme 媒体查询来检测用户对 lightdark 模式的系统偏好。

将主题配置应用到 tempusDominus 小部件

库根据检测到的或指定的主题设置主题配置 (theme: 'dark' 或 theme: 'light')。然后,库的内部功能将此配置应用于 tempusDominus 小部件。

小部件属性

翻译支持

该扩展支持翻译。您可以将其翻译成您的语言,默认情况下,扩展支持以下语言。

  • 中文
  • 英语
  • 法语
  • 德语
  • 葡萄牙语
  • 俄语
  • 西班牙语

高质量代码

static-analysis phpstan-level StyleCI

支持版本 Yii2

Yii20 Yii22

测试

检查文档中的测试部分以了解测试信息

我们的社交媒体

Twitter

许可协议

MIT 许可协议。有关更多信息,请参阅 许可文件