abstract class FieldGroupFormatterBase in Field Group 8.3
Same name and namespace in other branches
- 8 src/FieldGroupFormatterBase.php \Drupal\field_group\FieldGroupFormatterBase
Base class for 'Fieldgroup formatter' plugin implementations.
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\field_group\FieldGroupFormatterBase implements FieldGroupFormatterInterface
- class \Drupal\Core\Field\PluginSettingsBase implements DependentPluginInterface, PluginSettingsInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of FieldGroupFormatterBase
7 files declare their use of FieldGroupFormatterBase
- Accordion.php in src/
Plugin/ field_group/ FieldGroupFormatter/ Accordion.php - AccordionItem.php in src/
Plugin/ field_group/ FieldGroupFormatter/ AccordionItem.php - Details.php in src/
Plugin/ field_group/ FieldGroupFormatter/ Details.php - Fieldset.php in src/
Plugin/ field_group/ FieldGroupFormatter/ Fieldset.php - HtmlElement.php in src/
Plugin/ field_group/ FieldGroupFormatter/ HtmlElement.php
File
- src/
FieldGroupFormatterBase.php, line 13
Namespace
Drupal\field_groupView source
abstract class FieldGroupFormatterBase extends PluginSettingsBase implements FieldGroupFormatterInterface {
/**
* The group this formatter needs to render.
*
* @var object
*/
protected $group;
/**
* The formatter settings.
*
* @var array
*/
protected $settings;
/**
* The label display setting.
*
* @var string
*/
protected $label;
/**
* The view mode.
*
* @var string
*/
protected $viewMode;
/**
* The context mode.
*
* @var string
*/
protected $context;
/**
* Constructs a FieldGroupFormatterBase object.
*
* @param string $plugin_id
* The plugin_id for the formatter.
* @param mixed $plugin_definition
* The plugin implementation definition.
* @param \stdClass $group
* The group object.
* @param array $settings
* The formatter settings.
* @param string $label
* The formatter label.
*/
public function __construct($plugin_id, $plugin_definition, \stdClass $group, array $settings, $label) {
parent::__construct([], $plugin_id, $plugin_definition);
$this->group = $group;
$this->settings = $settings;
$this->label = $label;
$this->context = $group->context;
}
/**
* Get the current label.
*
* @return string
* The current label.
*/
public function getLabel() {
return $this->label;
}
/**
* {@inheritdoc}
*/
public function settingsForm() {
$class = get_class($this);
$form = [];
$form['label'] = [
'#type' => 'textfield',
'#title' => $this
->t('Field group label'),
'#default_value' => $this->label,
'#weight' => -5,
];
$form['show_empty_fields'] = [
'#type' => 'checkbox',
'#title' => $this
->t('Display element also when empty'),
'#description' => $this
->t('Display this field group even if the contained fields are currently empty.'),
'#default_value' => $this
->getSetting('show_empty_fields'),
];
$form['id'] = [
'#title' => $this
->t('ID'),
'#type' => 'textfield',
'#default_value' => $this
->getSetting('id'),
'#weight' => 10,
'#element_validate' => [
[
$class,
'validateId',
],
],
];
$form['classes'] = [
'#title' => $this
->t('Extra CSS classes'),
'#type' => 'textfield',
'#default_value' => $this
->getSetting('classes'),
'#weight' => 11,
'#element_validate' => [
[
$class,
'validateCssClass',
],
],
];
return $form;
}
/**
* {@inheritdoc}
*/
public function settingsSummary() {
$summary = [];
if ($this
->getSetting('formatter')) {
$summary[] = $this->pluginDefinition['label'] . ': ' . $this
->getSetting('formatter');
}
if ($this
->getSetting('show_empty_fields')) {
$summary[] = $this
->t('Show Empty Fields');
}
if ($this
->getSetting('id')) {
$summary[] = $this
->t('Id: @id', [
'@id' => $this
->getSetting('id'),
]);
}
if ($this
->getSetting('classes')) {
$summary[] = \Drupal::translation()
->translate('Extra CSS classes: @classes', [
'@classes' => $this
->getSetting('classes'),
]);
}
return $summary;
}
/**
* {@inheritdoc}
*/
public static function defaultSettings() {
return self::defaultContextSettings('view');
}
/**
* {@inheritdoc}
*/
public static function defaultContextSettings($context) {
return [
'classes' => '',
'id' => '',
];
}
/**
* Get the classes to add to the group.
*/
protected function getClasses() {
$classes = [];
// Add a required-fields class to trigger the js.
if ($this
->getSetting('required_fields')) {
$classes[] = 'required-fields';
$classes[] = 'field-group-' . str_replace('_', '-', $this
->getBaseId());
}
if ($this
->getSetting('classes')) {
$classes = array_merge($classes, explode(' ', trim($this
->getSetting('classes'))));
}
return $classes;
}
/**
* {@inheritdoc}
*/
public function preRender(&$element, $rendering_object) {
$element['#group_name'] = $this->group->group_name;
$element['#entity_type'] = $this->group->entity_type;
$element['#bundle'] = $this->group->bundle;
$element['#show_empty_fields'] = $this
->getSetting('show_empty_fields');
}
/**
* {@inheritdoc}
*/
public function process(&$element, $processed_object) {
$element['#group_name'] = $this->group->group_name;
$element['#entity_type'] = $this->group->entity_type;
$element['#bundle'] = $this->group->bundle;
// BC: Call the pre render layer to not break contrib plugins.
return $this
->preRender($element, $processed_object);
}
/**
* Validate the entered css class from the submitted format settings.
*
* @param array $element
* The validated element.
* @param \Drupal\Core\Form\FormStateInterface $form_state
* The state of the form.
*/
public static function validateCssClass(array $element, FormStateInterface $form_state) {
$form_state_values = $form_state
->getValues();
$plugin_name = $form_state
->get('plugin_settings_edit');
if (!empty($form_state_values['fields'][$plugin_name]['settings_edit_form']['settings']['classes']) && !preg_match('!^[A-Za-z0-9-_ ]+$!', $form_state_values['fields'][$plugin_name]['settings_edit_form']['settings']['classes'])) {
$form_state
->setError($element, t('The css class must include only letters, numbers, underscores and dashes.'));
}
}
/**
* Validate the entered id attribute from the submitted format settings.
*
* @param array $element
* The validated element.
* @param \Drupal\Core\Form\FormStateInterface $form_state
* The state of the form.
*/
public static function validateId(array $element, FormStateInterface $form_state) {
$form_state_values = $form_state
->getValues();
$plugin_name = $form_state
->get('plugin_settings_edit');
if (!empty($form_state_values['fields'][$plugin_name]['settings_edit_form']['settings']['id']) && !preg_match('!^[A-Za-z0-9-_]+$!', $form_state_values['fields'][$plugin_name]['settings_edit_form']['settings']['id'])) {
$form_state
->setError($element, t('The id must include only letters, numbers, underscores and dashes.'));
}
}
}
Members
Name![]() |
Modifiers | Type | Description | Overrides |
---|---|---|---|---|
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 | |
FieldGroupFormatterBase:: |
protected | property | The context mode. | |
FieldGroupFormatterBase:: |
protected | property | The group this formatter needs to render. | |
FieldGroupFormatterBase:: |
protected | property | The label display setting. | |
FieldGroupFormatterBase:: |
protected | property |
The formatter settings. Overrides PluginSettingsBase:: |
|
FieldGroupFormatterBase:: |
protected | property | The view mode. | |
FieldGroupFormatterBase:: |
public static | function |
Defines the default settings for this plugin. Overrides FieldGroupFormatterInterface:: |
7 |
FieldGroupFormatterBase:: |
public static | function |
Defines the default settings for this plugin. Overrides PluginSettingsBase:: |
|
FieldGroupFormatterBase:: |
protected | function | Get the classes to add to the group. | 1 |
FieldGroupFormatterBase:: |
public | function | Get the current label. | |
FieldGroupFormatterBase:: |
public | function |
Allows the field group formatter to manipulate the field group array and attach the formatters rendering element. Overrides FieldGroupFormatterInterface:: |
7 |
FieldGroupFormatterBase:: |
public | function |
Allows the field group formatter to manipulate the field group array and attach the formatters elements.
The process method is called in the #process part of theme layer, and is currently used for forms.
The preRender method is called in the… Overrides FieldGroupFormatterInterface:: |
7 |
FieldGroupFormatterBase:: |
public | function |
Returns a form to configure settings for the formatter. Overrides FieldGroupFormatterInterface:: |
7 |
FieldGroupFormatterBase:: |
public | function |
Returns a short summary for the current formatter settings. Overrides FieldGroupFormatterInterface:: |
6 |
FieldGroupFormatterBase:: |
public static | function | Validate the entered css class from the submitted format settings. | |
FieldGroupFormatterBase:: |
public static | function | Validate the entered id attribute from the submitted format settings. | |
FieldGroupFormatterBase:: |
public | function |
Constructs a FieldGroupFormatterBase object. Overrides PluginBase:: |
|
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:: |
|
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. |