class FontAwesomeIconpickerWidget in Font Awesome Icons 8.2
Fontawesome Iconpicker Widget.
Plugin annotation
@FieldWidget(
id = "fontawesome_iconpicker_widget",
module = "fontawesome_iconpicker_widget",
label = @Translation("Font Awesome Iconpicker Widget"),
field_types = {
"fontawesome_icon"
}
)
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\fontawesome\Plugin\Field\FieldWidget\FontAwesomeIconWidget implements ContainerFactoryPluginInterface
- class \Drupal\fontawesome_iconpicker_widget\Plugin\Field\FieldWidget\FontAwesomeIconpickerWidget
- class \Drupal\fontawesome\Plugin\Field\FieldWidget\FontAwesomeIconWidget implements ContainerFactoryPluginInterface
- 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 FontAwesomeIconpickerWidget
File
- modules/
fontawesome_iconpicker_widget/ src/ Plugin/ Field/ FieldWidget/ FontAwesomeIconpickerWidget.php, line 27
Namespace
Drupal\fontawesome_iconpicker_widget\Plugin\Field\FieldWidgetView source
class FontAwesomeIconpickerWidget extends FontAwesomeIconWidget {
/**
* Drupal\Core\Messenger\MessengerInterface definition.
*
* @var \Drupal\Core\Messenger\MessengerInterface
*/
protected $messenger;
/**
* Drupal\fontawesome_iconpicker_widget\IconManagerInterface definition.
*
* @var \Drupal\fontawesome_iconpicker_widget\IconManagerInterface
*/
protected $iconManager;
/**
* Drupal Font Awesome manager service.
*
* @var \Drupal\fontawesome\FontAwesomeManagerInterface
*/
protected $fontAwesomeManager;
/**
* {@inheritdoc}
*/
public function __construct($plugin_id, $plugin_definition, FieldDefinitionInterface $field_definition, array $settings, array $third_party_settings, ConfigFactory $config_factory, MessengerInterface $messenger, IconManagerServiceInterface $icon_manager, FontAwesomeManagerInterface $font_awesome_manager) {
parent::__construct($plugin_id, $plugin_definition, $field_definition, $settings, $third_party_settings, $config_factory, $font_awesome_manager);
$this->messenger = $messenger;
$this->iconManager = $icon_manager;
$this->fontAwesomeManager = $font_awesome_manager;
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
return new static($plugin_id, $plugin_definition, $configuration['field_definition'], $configuration['settings'], $configuration['third_party_settings'], $container
->get('config.factory'), $container
->get('messenger'), $container
->get('fontawesome_iconpicker_widget.icon_manager'), $container
->get('fontawesome.font_awesome_manager'));
}
/**
* {@inheritdoc}
*/
public function formElement(FieldItemListInterface $items, $delta, array $element, array &$form, FormStateInterface $form_state) {
$element = parent::formElement($items, $delta, $element, $form, $form_state);
// Throw error if library file not found.
if (!fontawesome_iconpicker_widget_check_installed()) {
$this->messenger
->addWarning($this
->t('The fontIconPicker library could not be found. To use the Font Awesome Iconpicker, please verify that the fontIconPicker library is installed correctly. Please see the Font Awesome Iconpicker submodule README file for more details.'));
}
$cardinality = $this->fieldDefinition
->getFieldStorageDefinition()
->getCardinality();
$icon_list = $this->iconManager
->getFormattedIconList();
$term_list = $this->iconManager
->getFormattedTermList();
$icon_style_default_value = $items[$delta]
->get('style')
->getValue();
$icon_name_default_value = $items[$delta]
->get('icon_name')
->getValue();
$icon_default = NULL;
if ($icon_name_default_value && $icon_style_default_value) {
$icon_default = $icon_style_default_value . ' fa-' . $icon_name_default_value;
}
$element['icon_name'] = [
'#type' => 'textfield',
'#title' => $cardinality == 1 ? $this->fieldDefinition
->getLabel() : $this
->t('Icon Name'),
'#required' => $element['#required'],
'#default_value' => $icon_default,
'#attributes' => [
'class' => [
'fontawesome-iconpicker-icon',
],
],
'#attached' => [
'library' => [
'fontawesome_iconpicker_widget/fontawesome-iconpicker',
],
'drupalSettings' => [
'fontawesomeIcons' => [
'icons' => $icon_list,
'terms' => $term_list,
],
],
],
'#element_validate' => [
[
static::class,
'validateIconName',
],
],
];
$element['settings']['style'] = [
'#type' => 'hidden',
'#default_value' => $icon_style_default_value,
];
// Get current settings.
$iconSettings = unserialize($items[$delta]
->get('settings')
->getValue());
$mask_icon = '';
$mask_style = NULL;
if (isset($iconSettings['masking']['mask']) && isset($iconSettings['masking']['style'])) {
$mask_style = $iconSettings['masking']['style'];
$mask_icon = $mask_style . ' fa-' . $iconSettings['masking']['mask'];
}
$element['settings']['masking']['mask'] = [
'#type' => 'textfield',
'#title' => $this
->t('Icon Name'),
'#default_value' => $mask_icon,
'#attributes' => [
'class' => [
'fontawesome-iconpicker-mask',
],
],
'#element_validate' => [
[
static::class,
'validateIconName',
],
],
];
$element['settings']['masking']['style'] = [
'#type' => 'hidden',
'#default_value' => $mask_style,
];
return $element;
}
/**
* Validate the Font Awesome icon name.
*/
public static function validateIconName($element, FormStateInterface $form_state) {
$iconManager = \Drupal::service('fontawesome_iconpicker_widget.icon_manager');
$fontAwesomeManager = \Drupal::service('fontawesome.font_awesome_manager');
$value = $element['#value'];
if (strlen($value) == 0) {
$form_state
->setValueForElement($element, '');
return;
}
$icon_base = $iconManager
->getIconBaseNameFromClass($value);
$iconData = $fontAwesomeManager
->getIconMetadata($icon_base);
if (!isset($iconData['name'])) {
$form_state
->setError($element, t("Invalid icon"));
}
}
/**
* {@inheritdoc}
*/
public function massageFormValues(array $values, array $form, FormStateInterface $form_state) {
// Loop over each item and set the data properly.
foreach ($values as &$item) {
// Reset $item['icon_name'] to the base name.
$class = $item['icon_name'];
$item['icon_name'] = $this->iconManager
->getIconBaseNameFromClass($class);
$item['style'] = $this->iconManager
->getIconPrefixFromClass($class);
unset($item['settings']['style']);
if (!empty($item['settings']['masking']['mask'])) {
$mask_class = $item['settings']['masking']['mask'];
$item['settings']['masking']['mask'] = $this->iconManager
->getIconBaseNameFromClass($mask_class);
$item['settings']['masking']['style'] = $this->iconManager
->getIconPrefixFromClass($mask_class);
}
// Massage rotate and flip values to make them format properly.
if (is_numeric($item['settings']['power_transforms']['rotate']['value'])) {
$item['settings']['power_transforms']['rotate']['type'] = 'rotate';
}
else {
unset($item['settings']['power_transforms']['rotate']);
}
if (!empty($item['settings']['power_transforms']['flip-h']['value'])) {
$item['settings']['power_transforms']['flip-h']['type'] = 'flip';
}
else {
unset($item['settings']['power_transforms']['flip-h']);
}
if (!empty($item['settings']['power_transforms']['flip-v']['value'])) {
$item['settings']['power_transforms']['flip-v']['type'] = 'flip';
}
else {
unset($item['settings']['power_transforms']['flip-v']);
}
$item['settings'] = serialize(array_filter($item['settings']));
}
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. | |
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 | |
FontAwesomeIconpickerWidget:: |
protected | property |
Drupal Font Awesome manager service. Overrides FontAwesomeIconWidget:: |
|
FontAwesomeIconpickerWidget:: |
protected | property | Drupal\fontawesome_iconpicker_widget\IconManagerInterface definition. | |
FontAwesomeIconpickerWidget:: |
protected | property |
Drupal\Core\Messenger\MessengerInterface definition. Overrides MessengerTrait:: |
|
FontAwesomeIconpickerWidget:: |
public static | function |
Creates an instance of the plugin. Overrides FontAwesomeIconWidget:: |
|
FontAwesomeIconpickerWidget:: |
public | function |
Returns the form for a single field widget. Overrides FontAwesomeIconWidget:: |
|
FontAwesomeIconpickerWidget:: |
public | function |
Massages the form values into the format expected for field values. Overrides FontAwesomeIconWidget:: |
|
FontAwesomeIconpickerWidget:: |
public static | function |
Validate the Font Awesome icon name. Overrides FontAwesomeIconWidget:: |
|
FontAwesomeIconpickerWidget:: |
public | function |
Constructs a WidgetBase object. Overrides FontAwesomeIconWidget:: |
|
FontAwesomeIconWidget:: |
protected | property | Drupal configuration service container. | |
FontAwesomeIconWidget:: |
public static | function | Validate the Font Awesome power transforms. | |
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 static | function |
Defines the default settings for this plugin. Overrides PluginSettingsInterface:: |
42 |
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. | |
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 | function |
Returns a form to configure settings for the widget. Overrides WidgetInterface:: |
16 |
WidgetBase:: |
public | function |
Returns a short summary for the current widget settings. Overrides WidgetInterface:: |
15 |
WidgetBase:: |
public static | function |
Stores processing information about the widget in $form_state. Overrides WidgetBaseInterface:: |