README

注意： 此模块只为 DateField 提供选择器。如果您需要一个可以输入时间的选择器（因此支持 DatetimeField 和 TimeField），请考虑使用 SilverWare 日历模块。

为 SilverStripe v4 的 DateField 类提供填充模块，以在尚未支持 HTML5 日期输入的浏览器中显示日期选择器。

内容

通过 Composer 进行安装

$ composer require silverware/datepicker

与所有 SilverStripe 模块一样，配置通过 YAML 进行。通过 config.yml 应用对 LeftAndMain 的扩展。您还可以将捆绑文件包含到主题中，以便在表单中使用填充。

您可以在 YAML 中配置 DateField 的默认格式和填充设置

SilverStripe\Forms\DateField:
  default_datepicker_format: d MMM yyyy
  default_datepicker_polyfill: all

配置选项 default_datepicker_format 是一个标准的 CLDR 日期格式，它将被默认应用于所有使用日期选择器的 DateField 实例。

配置选项 default_datepicker_polyfill 决定了 DateField 实例的默认填充模式，并将强制在指定的设备上使用填充。可能的值有：desktop、mobile、all 和 none。

您可以通过以下方法在 DateField 的每个实例上覆盖这些默认设置

$field = DateField::create('MyDate', 'Date');
$field->setDatepickerFormat('d/MM/yyyy');
$field->setDatepickerPolyfill('mobile');

要自定义日期选择器的外观，首先使用 Yarn（或 NPM）安装前端依赖项

$ cd silverware-datepicker
$ yarn install

在 client/src/styles 文件夹中的 _variables.scss 中进行所需更改。一旦自定义了变量，您就需要编译源文件。

此模块使用 webpack 编译和捆绑前端资产。仓库中提供了一个配置文件，以便您可以立即开始使用。要使 webpack 监视文件并自动编译，请运行

$ yarn watch

当您的自定义设置准备就绪用于生产时，您可以运行以下命令来优化捆绑文件

$ yarn build

请使用 GitHub 问题跟踪器报告错误和请求功能。

我们欢迎您的贡献来帮助改进此项目。有关更多信息，请参阅贡献。