class SingleDateTimeRangeWidget in Single DateTimePicker 8
Plugin implementation of the 'daterange_default' widget.
Plugin annotation
@FieldWidget(
id = "single_date_time_range_widget",
label = @Translation("Single Date Time Picker"),
field_types = {
"daterange"
}
)
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\Core\Field\PluginSettingsBase implements DependentPluginInterface, PluginSettingsInterface
- class \Drupal\Core\Field\WidgetBase implements WidgetInterface, ContainerFactoryPluginInterface uses AllowedTagsXssTrait
- class \Drupal\datetime\Plugin\Field\FieldWidget\DateTimeWidgetBase
- class \Drupal\single_datetime\Plugin\Field\FieldWidget\SingleDateTimeBase
- class \Drupal\single_datetime_range\Plugin\Field\FieldWidget\SingleDateTimeRangeWidget
- class \Drupal\single_datetime\Plugin\Field\FieldWidget\SingleDateTimeBase
- class \Drupal\datetime\Plugin\Field\FieldWidget\DateTimeWidgetBase
- class \Drupal\Core\Field\WidgetBase implements WidgetInterface, ContainerFactoryPluginInterface uses AllowedTagsXssTrait
- class \Drupal\Core\Field\PluginSettingsBase implements DependentPluginInterface, PluginSettingsInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of SingleDateTimeRangeWidget
File
- modules/
single_datetime_range/ src/ Plugin/ Field/ FieldWidget/ SingleDateTimeRangeWidget.php, line 23
Namespace
Drupal\single_datetime_range\Plugin\Field\FieldWidgetView source
class SingleDateTimeRangeWidget extends SingleDateTimeBase {
/**
* {@inheritdoc}
*/
public function formElement(FieldItemListInterface $items, $delta, array $element, array &$form, FormStateInterface $form_state) {
$element = parent::formElement($items, $delta, $element, $form, $form_state);
// Wrap all of the select elements with a fieldset.
$element['#theme_wrappers'][] = 'fieldset';
// Overwriting default validateStartEnd validation with our function.
// validateStartEnd uses date object, we are submitting date as string.
$element['#element_validate'][0] = [
$this,
'validateSingleDateTime',
];
// Start value.
$element['value'] = [
'#title' => $this
->t('Start date'),
'#type' => 'single_date_time',
'#date_timezone' => date_default_timezone_get(),
'#default_value' => NULL,
'#required' => $element['#required'],
];
// End value.
$element['end_value'] = [
'#title' => $element['#required'] ? $this
->t('End date') : $this
->t('End date (optional)'),
'#type' => 'single_date_time',
'#date_timezone' => date_default_timezone_get(),
'#default_value' => NULL,
'#required' => $element['#required'],
];
// Identify the type of date and time elements to use.
switch ($this
->getFieldSetting('datetime_type')) {
case DateRangeItem::DATETIME_TYPE_DATE:
case DateRangeItem::DATETIME_TYPE_ALLDAY:
$date_type = 'date';
$time_type = 'none';
$date_format = $this->dateStorage
->load('html_date')
->getPattern();
$time_format = '';
break;
default:
$date_type = 'date';
$time_type = 'time';
$date_format = $this->dateStorage
->load('html_date')
->getPattern();
$time_format = $this->dateStorage
->load('html_time')
->getPattern();
if ($this
->getSetting('hour_format') === '12h') {
$time_format = 'h:i:s A';
}
break;
}
// Merge defaults with field settings.
$element_defaults = [
'#date_date_format' => $date_format,
'#date_date_element' => $date_type,
'#date_date_callbacks' => [],
'#date_time_format' => $time_format,
'#date_time_element' => $time_type,
'#date_time_callbacks' => [],
];
// Build elements array with all data.
$element['value'] = array_merge($element['value'], $element_defaults, $this
->getCommonElementSettings());
$element['end_value'] = array_merge($element['end_value'], $element_defaults, $this
->getCommonElementSettings());
// Make single date format from date / time parts.
// Trim spaces in case of date type only.
$format = trim($date_format . ' ' . $time_format);
if ($items[$delta]->start_date) {
$start_date = $items[$delta]->start_date;
$element['value']['#default_value'] = $this
->formatDefaultValue($start_date, $element['value']['#date_timezone'], $format);
}
if ($items[$delta]->end_date) {
$end_date = $items[$delta]->end_date;
$element['end_value']['#default_value'] = $this
->formatDefaultValue($end_date, $element['end_value']['#date_timezone'], $format);
}
return $element;
}
/**
* Callback #element_validate to ensure that the start date <= the end date.
*
* @param array $element
* An associative array containing the properties and children of the
* generic form element.
* @param \Drupal\Core\Form\FormStateInterface $form_state
* The current state of the form.
* @param array $complete_form
* The complete form structure.
*/
public function validateSingleDateTime(array &$element, FormStateInterface $form_state, array &$complete_form) {
// String to DrupalDateTime.
$start_date = new DrupalDateTime($element['value']['#value']);
$end_date = new DrupalDateTime($element['end_value']['#value']);
if ($start_date instanceof DrupalDateTime && $end_date instanceof DrupalDateTime) {
if ($start_date
->getTimestamp() !== $end_date
->getTimestamp()) {
$interval = $start_date
->diff($end_date);
if ($interval->invert === 1) {
$form_state
->setError($element, $this
->t('The @title end date cannot be before the start date', [
'@title' => $element['#title'],
]));
}
}
}
}
/**
* {@inheritdoc}
*/
public function massageFormValues(array $values, array $form, FormStateInterface $form_state) {
// The widget form element type has transformed the value to a
// DrupalDateTime object at this point. We need to convert it back to the
// storage timezone and format.
foreach ($values as &$item) {
if (!empty($item['value'])) {
// Date value is now string not instance of DrupalDateTime (without T).
// String needs to be converted to DrupalDateTime.
$start_date = new DrupalDateTime($item['value']);
switch ($this
->getFieldSetting('datetime_type')) {
// Dates only.
case DateRangeItem::DATETIME_TYPE_DATE:
// If this is a date-only field, set it to the default time so the
// timezone conversion can be reversed.
$start_date
->setDefaultDateTime();
$format = DateTimeItemInterface::DATE_STORAGE_FORMAT;
break;
// All day.
case DateRangeItem::DATETIME_TYPE_ALLDAY:
// All day fields start at midnight on the starting date, but are
// stored like datetime fields, so we need to adjust the time.
// This function is called twice, so to prevent a double conversion
// we need to explicitly set the timezone.
$start_date
->setTimeZone(timezone_open(date_default_timezone_get()));
$start_date
->setTime(0, 0, 0);
$format = DateTimeItemInterface::DATETIME_STORAGE_FORMAT;
break;
// Date and time.
default:
$format = DateTimeItemInterface::DATETIME_STORAGE_FORMAT;
break;
}
// Adjust the date for storage.
$start_date
->setTimezone(new \DateTimezone(DateTimeItemInterface::STORAGE_TIMEZONE));
$item['value'] = $start_date
->format($format);
}
// This is case for daterange field.
if (!empty($item['end_value'])) {
// Convert string to DrupalDateTime.
$end_date = new DrupalDateTime($item['end_value']);
switch ($this
->getFieldSetting('datetime_type')) {
case DateRangeItem::DATETIME_TYPE_DATE:
// If this is a date-only field, set it to the default time so the
// timezone conversion can be reversed.
$end_date
->setDefaultDateTime();
$format = DateTimeItemInterface::DATE_STORAGE_FORMAT;
break;
case DateRangeItem::DATETIME_TYPE_ALLDAY:
// All day fields end at midnight on the end date, but are
// stored like datetime fields, so we need to adjust the time.
// This function is called twice, so to prevent a double conversion
// we need to explicitly set the timezone.
$end_date
->setTimeZone(timezone_open(date_default_timezone_get()));
$end_date
->setTime(23, 59, 59);
$format = DateTimeItemInterface::DATETIME_STORAGE_FORMAT;
break;
default:
$format = DateTimeItemInterface::DATETIME_STORAGE_FORMAT;
break;
}
// Adjust the date for storage.
$end_date
->setTimezone(new \DateTimezone(DateTimeItemInterface::STORAGE_TIMEZONE));
$item['end_value'] = $end_date
->format($format);
}
}
return $values;
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
AllowedTagsXssTrait:: |
public | function | Returns a list of tags allowed by AllowedTagsXssTrait::fieldFilterXss(). | |
AllowedTagsXssTrait:: |
public | function | Returns a human-readable list of allowed tags for display in help texts. | |
AllowedTagsXssTrait:: |
public | function | Filters an HTML string to prevent XSS vulnerabilities. | |
DateTimeWidgetBase:: |
protected | function | Creates a date object for use as a default value. | |
DependencySerializationTrait:: |
protected | property | An array of entity type IDs keyed by the property name of their storages. | |
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | 1 | |
DependencySerializationTrait:: |
public | function | 2 | |
MessengerTrait:: |
protected | property | The messenger. | 29 |
MessengerTrait:: |
public | function | Gets the messenger. | 29 |
MessengerTrait:: |
public | function | Sets the messenger. | |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 1 |
PluginBase:: |
protected | property | The plugin implementation definition. | 1 |
PluginBase:: |
protected | property | The plugin_id. | |
PluginBase:: |
constant | A string which is used to separate base plugin IDs from the derivative ID. | ||
PluginBase:: |
public | function |
Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the definition of the plugin implementation. Overrides PluginInspectionInterface:: |
3 |
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function | Determines if the plugin is configurable. | |
PluginSettingsBase:: |
protected | property | Whether default settings have been merged into the current $settings. | |
PluginSettingsBase:: |
protected | property | The plugin settings injected by third party modules. | |
PluginSettingsBase:: |
public | function |
Calculates dependencies for the configured plugin. Overrides DependentPluginInterface:: |
6 |
PluginSettingsBase:: |
public | function |
Returns the value of a setting, or its default value if absent. Overrides PluginSettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Returns the array of settings, including defaults for missing settings. Overrides PluginSettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Gets the list of third parties that store information. Overrides ThirdPartySettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Gets the value of a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Gets all third-party settings of a given module. Overrides ThirdPartySettingsInterface:: |
|
PluginSettingsBase:: |
protected | function | Merges default settings values into $settings. | |
PluginSettingsBase:: |
public | function |
Informs the plugin that some configuration it depends on will be deleted. Overrides PluginSettingsInterface:: |
3 |
PluginSettingsBase:: |
public | function |
Sets the value of a setting for the plugin. Overrides PluginSettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Sets the settings for the plugin. Overrides PluginSettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Sets the value of a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
PluginSettingsBase:: |
public | function |
Unsets a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
SingleDateTimeBase:: |
protected | property | The date format storage. | |
SingleDateTimeBase:: |
public static | function |
Creates an instance of the plugin. Overrides WidgetBase:: |
|
SingleDateTimeBase:: |
public static | function |
Defines the default settings for this plugin. Overrides PluginSettingsBase:: |
|
SingleDateTimeBase:: |
public | function | Creates a date string for use as a default value. | |
SingleDateTimeBase:: |
public | function | Return array of field settings. | |
SingleDateTimeBase:: |
public | function |
Returns a form to configure settings for the widget. Overrides WidgetBase:: |
|
SingleDateTimeBase:: |
public | function |
Returns a short summary for the current widget settings. Overrides WidgetBase:: |
|
SingleDateTimeBase:: |
public | function |
Constructs a WidgetBase object. Overrides WidgetBase:: |
|
SingleDateTimeRangeWidget:: |
public | function |
Returns the form for a single field widget. Overrides DateTimeWidgetBase:: |
|
SingleDateTimeRangeWidget:: |
public | function |
Massages the form values into the format expected for field values. Overrides SingleDateTimeBase:: |
|
SingleDateTimeRangeWidget:: |
public | function | Callback #element_validate to ensure that the start date <= the end date. | |
StringTranslationTrait:: |
protected | property | The string translation service. | 1 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. | |
WidgetBase:: |
protected | property | The field definition. | |
WidgetBase:: |
protected | property |
The widget settings. Overrides PluginSettingsBase:: |
|
WidgetBase:: |
public static | function | Ajax callback for the "Add another item" button. | |
WidgetBase:: |
public static | function | Submission handler for the "Add another item" button. | |
WidgetBase:: |
public static | function | After-build handler for field elements in a form. | |
WidgetBase:: |
public | function |
Assigns a field-level validation error to the right widget sub-element. Overrides WidgetInterface:: |
8 |
WidgetBase:: |
public | function |
Extracts field values from submitted form values. Overrides WidgetBaseInterface:: |
2 |
WidgetBase:: |
public | function |
Reports field-level validation errors against actual form elements. Overrides WidgetBaseInterface:: |
2 |
WidgetBase:: |
public | function |
Creates a form element for a field. Overrides WidgetBaseInterface:: |
3 |
WidgetBase:: |
protected | function | Special handling to create form elements for multiple values. | 1 |
WidgetBase:: |
protected | function | Generates the form element for a single copy of the widget. | |
WidgetBase:: |
protected | function | Returns the value of a field setting. | |
WidgetBase:: |
protected | function | Returns the array of field settings. | |
WidgetBase:: |
protected | function | Returns the filtered field description. | |
WidgetBase:: |
public static | function |
Retrieves processing information about the widget from $form_state. Overrides WidgetBaseInterface:: |
|
WidgetBase:: |
protected static | function | Returns the location of processing information within $form_state. | |
WidgetBase:: |
protected | function | Returns whether the widget handles multiple values. | |
WidgetBase:: |
public static | function |
Returns if the widget can be used for the provided field. Overrides WidgetInterface:: |
4 |
WidgetBase:: |
protected | function | Returns whether the widget used for default value form. | |
WidgetBase:: |
public static | function |
Stores processing information about the widget in $form_state. Overrides WidgetBaseInterface:: |