bigfork/silverstripe-simpledatefield

A SilverStripe form field for entering dates based on the UK Government’s date input pattern

1.1.0 2024-07-05 08:49 UTC

Requires

• ext-intl: *
• silverstripe/framework: ^4 || ^5

BSD-3-Clause

• form
• date
• silverstripe
• field
• datefield

README

A form field for entering dates based on the GOV.UK Design System’s date input pattern, which uses three separate inputs for day, month, and year.

Usage

SimpleDateField::create('DateOfBirth', 'Date of birth');

// Or to offer the inputs in a different order
SimpleDateField::create('DateOfBirth', 'Date of birth', null, SimpleDateField::YMD);
SimpleDateField::create('DateOfBirth', 'Date of birth', null, SimpleDateField::MDY);

If you choose to manually pass a date to the $value argument, it must be in the ISO 6801 date format (YYYY-MM-DD).

Date of birth

If using this field to allow users to enter their date of birth, it’s recommended to add relevant autocomplete attributes to assist this.

$field = SimpleDateField::create('DateOfBirth', 'Date of birth');
$field->getDayField()->setAttribute('autocomplete', 'bday-day');
$field->getMonthField()->setAttribute('autocomplete', 'bday-month');
$field->getYearField()->setAttribute('autocomplete', 'bday-year');

Styling

No front-end styling is provided to display the fields “inline”. You could use the CMS styling for inspiration: check out client/src/bundles/cms.scss.

Todo

• Add translation entities for labels/error messages
• Min/max date options
• Unit tests