class PhoneInternationalElement in International Phone 3.x
Same name and namespace in other branches
- 8.2 src/Element/PhoneInternationalElement.php \Drupal\phone_international\Element\PhoneInternationalElement
- 8 src/Element/PhoneInternationalElement.php \Drupal\phone_international\Element\PhoneInternationalElement
Provides a phone_international form.
Usage example:
By default field has geolocation enable.
$form['phone'] = [
'#type' => 'phone_international',
'#title' => $this
->t('International Phone'),
];
If you want default country you need to do this:
$form['phone'] = [
'#type' => 'phone_international',
'#title' => $this
->t('International Phone'),
'#attributes' => [
'data-country' => 'PT',
'data-geo' => 0,
// 0(Disable) or 1(Enable)
'data-exclude' => [],
'data-preferred' => [
'PT',
],
],
];
Plugin annotation
@FormElement("phone_international");
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\Core\Render\Element\RenderElement implements ElementInterface
- class \Drupal\Core\Render\Element\FormElement implements FormElementInterface
- class \Drupal\phone_international\Element\PhoneInternationalElement
- class \Drupal\Core\Render\Element\FormElement implements FormElementInterface
- class \Drupal\Core\Render\Element\RenderElement implements ElementInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of PhoneInternationalElement
1 #type use of PhoneInternationalElement
- PhoneInternationalDefaultWidget::formElement in src/
Plugin/ Field/ FieldWidget/ PhoneInternationalDefaultWidget.php - Returns the form for a single field widget.
File
- src/
Element/ PhoneInternationalElement.php, line 39
Namespace
Drupal\phone_international\ElementView source
class PhoneInternationalElement extends FormElement {
/**
* {@inheritdoc}
*/
public static function valueCallback(&$element, $input, FormStateInterface $form_state) {
if (!empty($input['full_number'])) {
return $input['full_number'];
}
else {
return '';
}
}
/**
* Form element validation handler for #type 'phone_international'.
*/
public static function validateNumber(&$element, FormStateInterface $form_state, &$complete_form) {
$value = $element['#value'];
$form_state
->setValueForElement($element, $value);
if ($value !== '' && !\Drupal::service('phone_international.validate')
->isValidNumber($value)) {
$form_state
->setError($element, t('The %name "%phone_international" is not valid.', [
'%phone_international' => $value,
'%name' => $element['#title'],
]));
}
}
/**
* {@inheritdoc}
*/
public function getInfo() {
$class = get_class($this);
return [
'#input' => TRUE,
'#process' => [
[
$class,
'processInternationalPhone',
],
],
'#element_validate' => [
[
$class,
'validateNumber',
],
],
'#theme_wrappers' => [
'form_element',
],
'#tree' => TRUE,
'#country' => '',
'#geolocation' => 0,
'#exclude' => [],
'#preferred' => [],
];
}
/**
* Add tel and hidden input to phone_international element.
*/
public static function processInternationalPhone(&$element, FormStateInterface $form_state, &$complete_form) {
$element['#attached']['library'][] = 'phone_international/phone_international';
$element['int_phone'] = [
'#type' => 'tel',
'#default_value' => $element['#default_value'],
'#attributes' => [
'class' => [
'phone_international-number',
],
'data-country' => $element['#country'],
'data-geo' => $element['#geolocation'],
'data-exclude' => $element['#exclude_countries'] ? implode("-", $element['#exclude_countries']) : [],
'data-preferred' => $element['#preferred_countries'] ? implode("-", $element['#preferred_countries']) : [],
],
'#theme_wrappers' => [],
'#size' => 30,
'#maxlength' => 128,
];
// Get library path to load utilsTellInput.js.
$config = \Drupal::config('phone_international.settings');
$cdn = $config
->get('cdn');
if ($cdn) {
$path = '//cdn.jsdelivr.net/npm/intl-tel-input/build';
}
else {
$path = '/' . _phone_international_get_path();
}
$element['#attached']['drupalSettings']['phone_international']['path'] = $path;
$element['full_number'] = [
'#type' => 'hidden',
];
if (isset($element['#value']) && !empty($element['#value'])) {
$element['int_phone']['#value'] = $element['#value'];
$element['full_number']['#value'] = $element['#value'];
}
if (isset($element['#default_value']) && !empty($element['#default_value'])) {
$element['full_number']['#default_value'] = $element['#default_value'];
}
return $element;
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
public | function | 2 | |
DependencySerializationTrait:: |
public | function | 2 | |
FormElement:: |
public static | function | Adds autocomplete functionality to elements. | |
FormElement:: |
public static | function | #process callback for #pattern form element property. | |
FormElement:: |
public static | function | #element_validate callback for #pattern form element property. | |
MessengerTrait:: |
protected | property | The messenger. | 27 |
MessengerTrait:: |
public | function | Gets the messenger. | 27 |
MessengerTrait:: |
public | function | Sets the messenger. | |
PhoneInternationalElement:: |
public | function |
Returns the element properties for this element. Overrides ElementInterface:: |
|
PhoneInternationalElement:: |
public static | function | Add tel and hidden input to phone_international element. | |
PhoneInternationalElement:: |
public static | function | Form element validation handler for #type 'phone_international'. | |
PhoneInternationalElement:: |
public static | function |
Determines how user input is mapped to an element's #value property. Overrides FormElement:: |
|
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. | |
PluginBase:: |
public | function | Constructs a \Drupal\Component\Plugin\PluginBase object. | 98 |
RenderElement:: |
public static | function | Adds Ajax information about an element to communicate with JavaScript. | |
RenderElement:: |
public static | function | Adds members of this group as actual elements for rendering. | |
RenderElement:: |
public static | function | Form element processing handler for the #ajax form property. | 1 |
RenderElement:: |
public static | function | Arranges elements into groups. | |
RenderElement:: |
public static | function |
Sets a form element's class attribute. Overrides ElementInterface:: |
|
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. |