double_field-4.x-dev/src/Plugin/Field/FieldWidget/DoubleField.php
src/Plugin/Field/FieldWidget/DoubleField.php
<?php
namespace Drupal\double_field\Plugin\Field\FieldWidget;
use Drupal\Component\Render\FormattableMarkup;
use Drupal\Core\Datetime\DrupalDateTime;
use Drupal\Core\Field\FieldItemListInterface;
use Drupal\Core\Field\WidgetBase;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\Render\Element\Email;
use Drupal\double_field\Plugin\Field\FieldType\DoubleField as DoubleFieldItem;
use Symfony\Component\Validator\ConstraintViolationInterface;
/**
* Plugin implementation of the 'double_field' widget.
*
* @FieldWidget(
* id = "double_field",
* label = @Translation("Double Field"),
* field_types = {"double_field"}
* )
*/
class DoubleField extends WidgetBase {
/**
* {@inheritdoc}
*/
public static function defaultSettings(): array {
foreach (['first', 'second'] as $subfield) {
$settings[$subfield] = [
// As this method is static there is no way to set an appropriate type
// for the subwidget. Let self::getSettings() do it instead.
'type' => NULL,
'label_display' => 'block',
'size' => 30,
'placeholder' => '',
'label' => t('Ok'),
'cols' => 10,
'rows' => 5,
];
}
$settings['inline'] = FALSE;
return $settings + parent::defaultSettings();
}
/**
* {@inheritdoc}
*/
public function settingsForm(array $form, FormStateInterface $form_state): array {
$element = [];
$settings = $this->getSettings();
$field_settings = $this->getFieldSettings();
$types = DoubleFieldItem::subfieldTypes();
$field_name = $this->fieldDefinition->getName();
$element['inline'] = [
'#type' => 'checkbox',
'#title' => $this->t('Display as inline element'),
'#default_value' => $settings['inline'],
];
foreach (['first', 'second'] as $subfield) {
$type = $field_settings['storage'][$subfield]['type'];
$title = $subfield == 'first' ? $this->t('First subfield') : $this->t('Second subfield');
$title .= ' - ' . $types[$type];
$element[$subfield] = [
'#type' => 'details',
'#title' => $title,
'#open' => FALSE,
];
$element[$subfield]['type'] = [
'#type' => 'select',
'#title' => $this->t('Widget'),
'#default_value' => $settings[$subfield]['type'],
'#required' => TRUE,
'#options' => $this->getSubwidgets($type, $field_settings[$subfield]['list']),
];
$element[$subfield]['label_display'] = [
'#type' => 'select',
'#title' => $this->t('Label'),
'#default_value' => $settings[$subfield]['label_display'],
'#required' => TRUE,
'#options' => [
'block' => $this->t('Above'),
'inline' => $this->t('Inline'),
'invisible' => $this->t('Invisible'),
'hidden' => $this->t('Hidden'),
],
'#access' => self::isLabelSupported($settings[$subfield]['type']),
];
if ($settings[$subfield]['type'] == 'datetime') {
unset(
$element[$subfield]['label_display']['#options']['inline'],
$element[$subfield]['label_display']['#options']['invisible'],
);
}
$type_selector = "select[name='fields[$field_name][settings_edit_form][settings][$subfield][type]'";
$element[$subfield]['size'] = [
'#type' => 'number',
'#title' => $this->t('Size'),
'#default_value' => $settings[$subfield]['size'],
'#min' => 1,
'#states' => [
'visible' => [
[$type_selector => ['value' => 'textfield']],
[$type_selector => ['value' => 'email']],
[$type_selector => ['value' => 'tel']],
[$type_selector => ['value' => 'url']],
],
],
];
$element[$subfield]['placeholder'] = [
'#type' => 'textfield',
'#title' => $this->t('Placeholder'),
'#default_value' => $settings[$subfield]['placeholder'],
'#states' => [
'visible' => [
[$type_selector => ['value' => 'textfield']],
[$type_selector => ['value' => 'textarea']],
[$type_selector => ['value' => 'email']],
[$type_selector => ['value' => 'tel']],
[$type_selector => ['value' => 'url']],
],
],
];
$element[$subfield]['label'] = [
'#type' => 'textfield',
'#title' => $this->t('Label'),
'#default_value' => $settings[$subfield]['label'],
'#required' => TRUE,
'#states' => [
'visible' => [$type_selector => ['value' => 'checkbox']],
],
];
$element[$subfield]['cols'] = [
'#type' => 'number',
'#title' => $this->t('Columns'),
'#default_value' => $settings[$subfield]['cols'],
'#min' => 1,
'#description' => $this->t('How many columns wide the textarea should be'),
'#states' => [
'visible' => [$type_selector => ['value' => 'textarea']],
],
];
$element[$subfield]['rows'] = [
'#type' => 'number',
'#title' => $this->t('Rows'),
'#default_value' => $settings[$subfield]['rows'],
'#min' => 1,
'#description' => $this->t('How many rows high the textarea should be.'),
'#states' => [
'visible' => [$type_selector => ['value' => 'textarea']],
],
];
}
return $element;
}
/**
* {@inheritdoc}
*/
public function settingsSummary(): array {
$settings = $this->getSettings();
$field_settings = $this->getFieldSettings();
$subfield_types = DoubleFieldItem::subfieldTypes();
$summary = [];
if ($settings['inline']) {
$summary[] = $this->t('Display as inline element');
}
foreach (['first', 'second'] as $subfield) {
$subfield_type = $subfield_types[$field_settings['storage'][$subfield]['type']];
$summary[] = new FormattableMarkup(
'<b>@subfield - @subfield_type</b>',
[
'@subfield' => ($subfield == 'first' ? $this->t('First subfield') : $this->t('Second subfield')),
'@subfield_type' => strtolower($subfield_type),
]
);
$summary[] = $this->t('Widget: @type', ['@type' => $settings[$subfield]['type']]);
if (self::isLabelSupported($settings[$subfield]['type'])) {
$summary[] = $this->t('Label display: @label', ['@label' => $settings[$subfield]['label_display']]);
}
switch ($settings[$subfield]['type']) {
case 'textfield':
case 'email':
case 'tel':
case 'url':
$summary[] = $this->t('Size: @size', ['@size' => $settings[$subfield]['size']]);
if ($settings[$subfield]['placeholder'] != '') {
$summary[] = $this->t('Placeholder: @placeholder', ['@placeholder' => $settings[$subfield]['placeholder']]);
}
break;
case 'checkbox':
$summary[] = $this->t('Label: @label', ['@label' => $settings[$subfield]['label']]);
break;
case 'select':
break;
case 'textarea':
$summary[] = $this->t('Columns: @cols', ['@cols' => $settings[$subfield]['cols']]);
$summary[] = $this->t('Rows: @rows', ['@rows' => $settings[$subfield]['rows']]);
if ($settings[$subfield]['placeholder'] != '') {
$summary[] = $this->t('Placeholder: @placeholder', ['@placeholder' => $settings[$subfield]['placeholder']]);
}
break;
}
}
return $summary;
}
/**
* {@inheritdoc}
*/
public function formElement(FieldItemListInterface $items, $delta, array $element, array &$form, FormStateInterface $form_state): array {
$field_settings = $this->getFieldSettings();
$settings = $this->getSettings();
$widget = [
'#theme_wrappers' => ['container', 'form_element'],
'#attributes' => ['class' => ['double-field-elements']],
'#attached' => [
'library' => ['double_field/widget'],
],
];
if ($settings['inline']) {
$widget['#attributes']['class'][] = 'double-field-widget-inline';
}
foreach (['first', 'second'] as $subfield) {
$widget[$subfield] = [
'#type' => $settings[$subfield]['type'],
'#default_value' => $items[$delta]->{$subfield} ?? NULL,
'#subfield_settings' => $settings[$subfield],
'#wrapper_attributes' => ['class' => ['double-field-subfield-form-item']],
];
$label_display = $settings[$subfield]['label_display'];
$label = $field_settings[$subfield]['label'];
$widget_type = $settings[$subfield]['type'];
if ($label_display != 'hidden' && self::isLabelSupported($widget_type)) {
$widget[$subfield]['#title'] = $label;
if ($label_display == 'invisible') {
$widget[$subfield]['#title_display'] = 'invisible';
}
elseif ($label_display == 'inline') {
$widget[$subfield]['#wrapper_attributes']['class'][] = 'container-inline';
}
}
$storage_type = $field_settings['storage'][$subfield]['type'];
switch ($widget_type) {
case 'textfield':
case 'email':
case 'tel':
case 'url':
// Find out appropriate max length fot the element.
$max_length_map = [
'string' => $field_settings['storage'][$subfield]['maxlength'],
'telephone' => $field_settings['storage'][$subfield]['maxlength'],
'email' => Email::EMAIL_MAX_LENGTH,
'uri' => 2048,
];
if (isset($max_length_map[$storage_type])) {
$widget[$subfield]['#maxlength'] = $max_length_map[$storage_type];
}
if ($settings[$subfield]['size']) {
$widget[$subfield]['#size'] = $settings[$subfield]['size'];
}
if ($settings[$subfield]['placeholder']) {
$widget[$subfield]['#placeholder'] = $settings[$subfield]['placeholder'];
}
break;
case 'checkbox':
$widget[$subfield]['#title'] = $settings[$subfield]['label'];
break;
case 'select':
$label = $field_settings[$subfield]['required'] ? $this->t('- Select a value -') : $this->t('- None -');
$widget[$subfield]['#options'] = ['' => $label];
if ($field_settings[$subfield]['list']) {
$widget[$subfield]['#options'] += $field_settings[$subfield]['allowed_values'];
}
break;
case 'radios':
$label = $field_settings[$subfield]['required'] ? $this->t('N/A') : $this->t('- None -');
$widget[$subfield]['#options'] = ['' => $label];
if ($field_settings[$subfield]['list']) {
$widget[$subfield]['#options'] += $field_settings[$subfield]['allowed_values'];
}
break;
case 'textarea':
if ($settings[$subfield]['cols']) {
$widget[$subfield]['#cols'] = $settings[$subfield]['cols'];
}
if ($settings[$subfield]['rows']) {
$widget[$subfield]['#rows'] = $settings[$subfield]['rows'];
}
if ($settings[$subfield]['placeholder']) {
$widget[$subfield]['#placeholder'] = $settings[$subfield]['placeholder'];
}
break;
case 'number':
case 'range':
if (in_array($storage_type, ['integer', 'float', 'numeric'])) {
if ($field_settings[$subfield]['min']) {
$widget[$subfield]['#min'] = $field_settings[$subfield]['min'];
}
if ($field_settings[$subfield]['max']) {
$widget[$subfield]['#max'] = $field_settings[$subfield]['max'];
}
if ($storage_type == 'numeric') {
$widget[$subfield]['#step'] = pow(0.1, $field_settings['storage'][$subfield]['scale']);
}
elseif ($storage_type == 'float') {
$widget[$subfield]['#step'] = 'any';
}
}
break;
case 'datetime':
$widget[$subfield]['#default_value'] = $items[$delta]->createDate($subfield);
if ($field_settings['storage'][$subfield]['datetime_type'] == 'date') {
$widget[$subfield]['#date_time_element'] = 'none';
$widget[$subfield]['#date_time_format'] = '';
}
else {
if ($widget[$subfield]['#default_value']) {
$widget[$subfield]['#default_value']->setTimezone(new \DateTimezone(date_default_timezone_get()));
}
// Ensure that the datetime field processing doesn't set its own
// time zone here.
$widget[$subfield]['#date_timezone'] = date_default_timezone_get();
}
break;
}
}
return $element + $widget;
}
/**
* {@inheritdoc}
*/
public function massageFormValues(array $values, array $form, FormStateInterface $form_state): array {
$storage_settings = $this->getFieldSetting('storage');
foreach ($values as $delta => $value) {
foreach (['first', 'second'] as $subfield) {
if ($value[$subfield] === '') {
$values[$delta][$subfield] = NULL;
}
elseif ($value[$subfield] instanceof DrupalDateTime) {
$date = $value[$subfield];
$storage_format = $storage_settings[$subfield]['datetime_type'] == 'datetime'
? DoubleFieldItem::DATETIME_DATETIME_STORAGE_FORMAT
: DoubleFieldItem::DATETIME_DATE_STORAGE_FORMAT;
// Before it can be saved, the time entered by the user must be
// converted to the storage time zone.
$storage_timezone = new \DateTimezone(DoubleFieldItem::DATETIME_STORAGE_TIMEZONE);
$values[$delta][$subfield] = $date->setTimezone($storage_timezone)->format($storage_format);
}
}
}
return $values;
}
/**
* Returns available subwidgets.
*/
protected function getSubwidgets(string $subfield_type, bool $list): array {
$subwidgets = [];
if ($list) {
$subwidgets['select'] = $this->t('Select list');
$subwidgets['radios'] = $this->t('Radio buttons');
}
switch ($subfield_type) {
case 'boolean':
$subwidgets['checkbox'] = $this->t('Checkbox');
break;
case 'string':
$subwidgets['textfield'] = $this->t('Textfield');
$subwidgets['email'] = $this->t('Email');
$subwidgets['tel'] = $this->t('Telephone');
$subwidgets['url'] = $this->t('Url');
$subwidgets['color'] = $this->t('Color');
break;
case 'email':
$subwidgets['email'] = $this->t('Email');
$subwidgets['textfield'] = $this->t('Textfield');
break;
case 'telephone':
$subwidgets['tel'] = $this->t('Telephone');
$subwidgets['textfield'] = $this->t('Textfield');
break;
case 'uri':
$subwidgets['url'] = $this->t('Url');
$subwidgets['textfield'] = $this->t('Textfield');
break;
case 'text':
$subwidgets['textarea'] = $this->t('Text area');
break;
case 'integer':
case 'float':
case 'numeric':
$subwidgets['number'] = $this->t('Number');
$subwidgets['textfield'] = $this->t('Textfield');
$subwidgets['range'] = $this->t('Range');
break;
case 'datetime_iso8601':
$subwidgets['datetime'] = $this->t('Date');
break;
}
return $subwidgets;
}
/**
* {@inheritdoc}
*/
public function errorElement(array $element, ConstraintViolationInterface $violation, array $form, FormStateInterface $form_state) {
/* @noinspection PhpUndefinedFieldInspection */
// @see https://www.drupal.org/project/drupal/issues/2600790
return isset($violation->arrayPropertyPath[0]) ? $element[$violation->arrayPropertyPath[0]] : $element;
}
/**
* {@inheritdoc}
*/
protected function getFieldSettings(): array {
$field_settings = parent::getFieldSettings();
foreach (['first', 'second'] as $subfield) {
$subfield_type = $field_settings['storage'][$subfield]['type'];
if ($field_settings[$subfield]['list'] && !DoubleFieldItem::isListAllowed($subfield_type)) {
$field_settings[$subfield]['list'] = FALSE;
}
}
return $field_settings;
}
/**
* {@inheritdoc}
*/
public function getSettings(): array {
$settings = parent::getSettings();
$field_settings = $this->getFieldSettings();
foreach (['first', 'second'] as $subfield) {
$widget_types = $this->getSubwidgets($field_settings['storage'][$subfield]['type'], $field_settings[$subfield]['list']);
// Use the first eligible widget type unless it is set explicitly.
if (!$settings[$subfield]['type']) {
$settings[$subfield]['type'] = key($widget_types);
}
}
return $settings;
}
/**
* Determines whether the widget can render subfield label.
*/
private static function isLabelSupported(string $widget_type): bool {
return $widget_type != 'checkbox';
}
}
