idez/nova-date-range-filter

一个基于 Laravel Nova 的日期范围过滤器。

2.2.0 2024-04-15 18:25 UTC

This package is auto-updated.

Last update: 2024-09-15 19:24:57 UTC


README

License Latest Stable Version Total Downloads

关于

这是一个可配置并可直接使用的过滤器,用于 Laravel Nova 4,基于 Nova 自身的日期过滤器,可以显示日期范围选择器。

安装

要在您的 Laravel Nova 项目中安装过滤器,请运行以下命令

composer require idez/nova-date-range-filter

用法

只需将此过滤器添加到您的 Nova 资源中的 filters 方法。

use Illuminate\Http\Request;
use Idez\DateRangeFilter\DateRangeFilter;

class CustomResource extends Resource
{
    public function filters(Request $request): array
    {
        return [
            new DateRangeFilter(),
        ];
    }
}

默认情况下,这将创建一个名为 "创建于" 的过滤器,它将选定的日期范围应用到 created_at 数据库列。

自定义

该过滤器最多接受三个参数,以根据您的需求进行自定义。

配置

所有可用的设置都由包含的 Config 枚举提供。请参阅下面的完整示例了解如何使用它。

完整示例

use Illuminate\Http\Request;
use Idez\DateRangeFilter\DateRangeFilter;
use Idez\DateRangeFilter\Enums\Config;

class CustomResource extends Resource
{
    public function filters(Request $request): array
    {
        return [
            new DateRangeFilter('Created at', 'created_at', [
                Config::ALLOW_INPUT => false,
                Config::DATE_FORMAT => 'Y-m-d',
                Config::DEFAULT_DATE => ['2019-06-01', '2019-06-30'],
                Config::DISABLED => false,
                Config::ENABLE_TIME => false,
                Config::ENABLE_SECONDS => false,
                Config::FIRST_DAY_OF_WEEK => 0,
                Config::LOCALE => 'default',
                Config::MAX_DATE => '2019-12-31',
                Config::MIN_DATE => '2019-01-01',
                Config::PLACEHOLDER => __('Choose date range'),
                Config::SHORTHAND_CURRENT_MONTH => false,
                Config::SHOW_MONTHS => 1,
                Config::TIME24HR => false,
                Config::WEEK_NUMBERS => false,
            ]),
        ];
    }
}

屏幕截图

贡献

欢迎贡献,请说明您想要解决的问题/功能,并使用测试来支持您的代码。祝您编码愉快!

许可证

此包最初由 https://github.com/pos-lifestyle/laravel-nova-date-range-filter 开发,但他们已放弃该包。MIT 许可证 (MIT)。请参阅 许可证文件 获取更多信息。