Тип predefinedlist поля форми Joomla

Тип predefinedlist поля форми надає список попередньо визначених записів, що розкривається. Якщо поле має збережене значення, воно вибирається при першому завантаженні сторінки. В іншому випадку вибирається значення за налаштуванням (якщо є).

В основному параметри конфігурації такі ж, як і у поля списку, однак значення поля створюються змінною класу predefinedOptions параметрів. Таким чином, наступні змінні мають те саме значення, що й поле списку:

• type (обов'язковий) - має бути PredefinedList.
• name (обов'язково) – унікальне ім'я поля.
• label (обов'язково) (дозволяється перекладати) - описовий заголовок поля.
• default (необов'язково) – значення елемента списку за налаштуванням.
• description (необов'язково) (дозволяється перекладати) - це текст, який буде відображатися як спливаюча підказка, коли користувач наводить покажчик миші на список, що розкривається.
• class (необов'язково) – це ім'я класу CSS для поля форми HTML. Якщо цей параметр не вказано, використовується за замовчуванням inputbox.
• multiple (необов'язково) - чи можна вибрати кілька елементів одночасно (true або false).
• required (необов'язковий) – якщо встановлено значення true, перша опція поля має бути порожньою, див. останній приклад.
• useglobal (необов'язково) - якщо встановлено значення true, відображатиметься значення, встановлене у глобальній конфігурації, якщо воно знайдено у базі даних.

Приклад XML визначення

<field name="mylistvalue" type="Myextension.Mycustompredefinedlist" default="" label="Select an option" description="">
</field>

це буде супроводжуватися вашим полем, визначеним у PHP, яке виглядатиме так:

class MyextensionFormFieldMycustompredefinedlist extends JFormFieldPredefinedList
{
	public $type = 'Mycustompredefinedlist';

	protected $predefinedOptions = array(
		'1'  => 'COM_FOO_LABEL_FOR_TRANSLATION',
		'0'  => 'COM_FOO_ANOTHER_LABEL_FOR_TRANSLATION',
	);
}

Крім того, в PHP ви можете встановити для змінної класу translate значення false, що призведе до того, що значення вашої зумовленої опції не будуть проходити через JText для перекладу до того, як буде показано користувачеві.

Переглянути всі стандартні типи полів форми можна тут: https://d-nik.site/joomla-4/joomla-dlia-rozrobnykiv/standartni-tipi-poliv-formi

Джерело: https://docs.joomla.org/Predefined_List_form_field_type