class RadioactivityEmitter in Radioactivity 4.0.x
Same name and namespace in other branches
- 8.3 src/Plugin/Field/FieldFormatter/RadioactivityEmitter.php \Drupal\radioactivity\Plugin\Field\FieldFormatter\RadioactivityEmitter
Plugin implementation of the 'radioactivity_emitter' formatter.
Plugin annotation
@FieldFormatter(
id = "radioactivity_emitter",
label = @Translation("Emitter"),
field_types = {
"radioactivity"
}
)
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\FormatterBase implements FormatterInterface, ContainerFactoryPluginInterface
- class \Drupal\radioactivity\Plugin\Field\FieldFormatter\RadioactivityEmitter
- class \Drupal\Core\Field\FormatterBase implements FormatterInterface, ContainerFactoryPluginInterface
- class \Drupal\Core\Field\PluginSettingsBase implements DependentPluginInterface, PluginSettingsInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of RadioactivityEmitter
File
- src/
Plugin/ Field/ FieldFormatter/ RadioactivityEmitter.php, line 24
Namespace
Drupal\radioactivity\Plugin\Field\FieldFormatterView source
class RadioactivityEmitter extends FormatterBase {
/**
* {@inheritdoc}
*/
public static function defaultSettings() {
return [
'energy' => 10,
'display' => 'none',
] + parent::defaultSettings();
}
/**
* {@inheritdoc}
*/
public function settingsForm(array $form, FormStateInterface $form_state) {
return [
// Implement settings form.
'energy' => [
'#title' => $this
->t('Energy'),
'#type' => 'textfield',
'#required' => TRUE,
'#description' => $this
->t('The amount of energy to emit when this field is displayed. Examples: 0.5, 10.'),
'#pattern' => '[0-9]+(\\.[0-9]+)?',
'#default_value' => $this
->getSetting('energy'),
],
'display' => [
'#title' => $this
->t('Display'),
'#type' => 'select',
'#options' => [
'none' => $this
->t('Only emit'),
'raw' => $this
->t('Energy level + emit'),
],
'#default_value' => $this
->getSetting('display'),
],
] + parent::settingsForm($form, $form_state);
}
/**
* {@inheritdoc}
*/
public function settingsSummary() {
$summary = [];
$summary[] = t('Emit: @energy', [
'@energy' => $this
->getSetting('energy'),
]);
switch ($this
->getSetting('display')) {
case 'none':
$summary[] = $this
->t('Only emit');
break;
case 'raw':
$summary[] = $this
->t('Display energy level');
break;
}
return $summary;
}
/**
* {@inheritdoc}
*/
public function viewElements(FieldItemListInterface $items, $langcode) {
$elements = [];
$shouldEmit = $this
->shouldEmit($items);
foreach ($items as $delta => $item) {
if ($shouldEmit) {
$incident = Incident::createFromFieldItemsAndFormatter($items, $item, $this);
$key = 'ra_emit_' . radioactivity_unique_emit_id();
$elements[$delta] = [
'#attached' => [
'library' => [
'radioactivity/triggers',
],
'drupalSettings' => [
$key => $incident
->toJson(),
],
],
];
}
switch ($this
->getSetting('display')) {
case 'raw':
$elements[$delta]['#markup'] = $this
->viewValue($item);
break;
}
}
return $elements;
}
/**
* {@inheritdoc}
*/
public function view(FieldItemListInterface $items, $langcode = NULL) {
$build = parent::view($items, $langcode);
// If 'none' is chosen (No value - only emit), we do not want this formatter
// to be rendered as field (it would be rendered in an empty wrapper diff).
// We only use the children which contain the energy emitter in "#attached".
if ($this
->getSetting('display') == 'none') {
$children = Element::children($build);
$build = array_intersect_key($build, $children);
}
return $build;
}
/**
* Generate the output appropriate for one field item.
*
* @param \Drupal\Core\Field\FieldItemInterface $item
* One field item.
*
* @return string
* The textual output generated.
*/
protected function viewValue(FieldItemInterface $item) {
return $item->energy;
}
/**
* Determine if the field should emit energy.
*
* @param \Drupal\Core\Field\FieldItemListInterface $items
* The field item list of the field.
*
* @return bool
* True if so.
*/
protected function shouldEmit(FieldItemListInterface $items) {
$entity = $items
->getEntity();
if (!$entity instanceof EntityPublishedInterface) {
return TRUE;
}
return $entity
->isPublished();
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
public | function | 2 | |
DependencySerializationTrait:: |
public | function | 2 | |
FormatterBase:: |
protected | property | The field definition. | |
FormatterBase:: |
protected | property | The label display setting. | |
FormatterBase:: |
protected | property |
The formatter settings. Overrides PluginSettingsBase:: |
|
FormatterBase:: |
protected | property | The view mode. | |
FormatterBase:: |
public static | function |
Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface:: |
12 |
FormatterBase:: |
protected | function | Returns the value of a field setting. | |
FormatterBase:: |
protected | function | Returns the array of field settings. | |
FormatterBase:: |
public static | function |
Returns if the formatter can be used for the provided field. Overrides FormatterInterface:: |
14 |
FormatterBase:: |
public | function |
Allows formatters to load information for field values being displayed. Overrides FormatterInterface:: |
2 |
FormatterBase:: |
public | function |
Constructs a FormatterBase object. Overrides PluginBase:: |
12 |
MessengerTrait:: |
protected | property | The messenger. | 27 |
MessengerTrait:: |
public | function | Gets the messenger. | 27 |
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:: |
2 |
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:: |
|
RadioactivityEmitter:: |
public static | function |
Defines the default settings for this plugin. Overrides PluginSettingsBase:: |
|
RadioactivityEmitter:: |
public | function |
Returns a form to configure settings for the formatter. Overrides FormatterBase:: |
|
RadioactivityEmitter:: |
public | function |
Returns a short summary for the current formatter settings. Overrides FormatterBase:: |
|
RadioactivityEmitter:: |
protected | function | Determine if the field should emit energy. | |
RadioactivityEmitter:: |
public | function |
Builds a renderable array for a fully themed field. Overrides FormatterBase:: |
|
RadioactivityEmitter:: |
public | function |
Builds a renderable array for a field value. Overrides FormatterInterface:: |
|
RadioactivityEmitter:: |
protected | function | Generate the output appropriate for one field item. | |
StringTranslationTrait:: |
protected | property | The string translation service. | 4 |
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. |