Тип text поля форми надає текстове поле для введення даних. Якщо поле має збережене значення, це значення відображається при першому завантаженні сторінки. Якщо ні, вибирається значення за налаштуванням (якщо є).
- type (обов'язково) — має бути text.
- name (обов'язково) — унікальне ім'я поля.
- label (обов'язкова) (дозволяється перекладати) — описовий заголовок поля.
- size (необов'язково) — ширина текстового поля у символах. Якщо пропущено, ширина визначається браузером. Значення size не обмежує кількість символів, що вводяться..
- maxlength (необов'язковий) — обмежує кількість символів, які можна ввести.
- default (необов'язково) (неперекладається) — це значення за налаштуванням.
- description (необов'язково) (перекладається) — це текст, який буде відображатися у вигляді спливаючої підказки, коли користувач наводить покажчик миші на список, що розкривається.
- class (необов'язково) — ім'я класу CSS для поля HTML—форми. Якщо пропущено, за налаштуванням буде text_area.
- readonly (необов'язково) Поле не може бути змінено і автоматично успадковує значення за промовчанням. (Можливі значення: "true", "1", "readonly" для встановлення в true).
- disabled (необов'язково) — поле не може бути змінено і автоматично успадковує значення за промовчанням. Воно також не буде надіслано. (Можливі значення: "true", "1", "readonly" для встановлення в true).
- required (необов'язково) — поле необхідно заповнити перед відправкою форми. (Можливі значення: "true", "1", "readonly" для встановлення в true).
- filter (необов'язково) — дозволяє системі зберігати певні HTML-теги або необроблені дані.
- message (необов'язково) — повідомлення про помилку, яке буде відображатися замість стандартного повідомлення.
- hint (необов'язково) — текст, що відображається в елементі-заповнювачі html, зазвичай світліша підказка, що відображається всередині порожнього поля.
- inputtype (необов'язково) — встановіть тип введення HTML5.
- pattern (необов'язково) — шаблон регулярного виразу, який використовується для перевірки.
Поле text також може приймати масив поделементів параметрів, щоб показати користувачеві пропозиції в текстовому полі.
Приклад XML визначення
<field name="mytextvalue" type="text" default="Some text" label="Enter some text" description="" size="10" />
Використовуйте цілий фільтр, щоб переконатися, що типи літер видаляються при обробці форми.
<field name="myintvalue" type="text" default="8" label="Enter some text" description="Enter some description" filter="integer" />
Використовуйте необроблений фільтр, щоб забезпечити збереження html-коду при обробці форми.
<field name="myhtmlvalue" type="text" default="" label="Enter some text" description="Enter some description" filter="raw" />
Переглянути всі стандартні типи полів форми можна тут: https://d-nik.site/joomla-4/joomla-dlia-rozrobnykiv/standartni-tipi-poliv-formi
