Значения по умолчанию
В документации мы покажем, как использовать query-параметры в URL для задания значений по умолчанию в различных полях формы/тексте. Функционал позволяет динамически изменять поведение полей или текста в зависимости от переданных параметров в URL. Это может быть полезно, например, для предзаполнения полей при переходе по ссылке.
Как это использовать в полях формы
Динамическое управление значениями по умолчанию происходит через query-параметры в URL. URL это ссылка на вашу страницу.
Для создания URL добавьте после адреса сайта:
?paramName=значение, где:
- paramName — это имя параметра, которое соответствует типу поля;
- Значение — это значение, которое будет использовано для задания значения по умолчанию для поля.
Покажем подробнее на примере поля Выбор.
Включаем в настройках поля галочку Получать значение из query.
В поле для ввода пишем название параметра (латинскими буквами). В нашем примере это select. Вы можете придумать свое название.
Далее, формируем конечный URL.
Чтобы выбрать по умолчанию Вариант 1, ссылка будет иметь вид:
https://вашдомен.ru/?select=Вариант 1
Чтобы выбрать по умолчанию Вариант 2, ссылка будет иметь вид:
https://вашдомен.ru/?select=Вариант 2
🚨 Если вы хотите объединить несколько query-параметров в ссылке, используйте символ &. Например, вашдомен.ru/?select=Вариант 1&?message=Hello%20World
Общие правила написания синтаксиса для query-параметров
Общие правила при работе с query-параметрами:
🚨 Для задания значения по умолчанию через URL, необходимо использовать синтаксис query-параметра. Синтаксис параметров зависит от типа поля (например, Галочка, Выбор, Имя, Телефон).
🚨 Значения query-параметров чувствительны к регистру. Например: query и Query - это разные параметры. Убедитесь, что значение в настройках и в URL совпадают.
🚨 Если параметр не передан, либо передан с неверным синтаксисом, используется значение по умолчанию.
🚨 Функционал доступен только в обычных формах/тексте. В квизах на данный момент функционал недоступен.
🚨 Валидация значений отрабатывает по принципу допустимости. К примеру, в поле Ползунок и Телефон можно писать только числа. Также проверяется кратность, если она задана. Если значение из query не соответствует, значение по умолчанию не будет проставлено.
Использование синтаксиса query-параметров для разных типов полей
Рассмотрим синтаксис с примерами использования для разных типов полей. Для удобства навигации используйте ссылки:
1. Тип поля Галочка
Для поля Галочка параметр может быть одним из следующих значений:
on, true, 1 — значение для включения чекбокса.
off, false, 0 — значение для выключения чекбокса.
| Поле Галочка включено (варианты URL) | Поле Галочка выключено (варианты URL) |
|---|---|
| https://вашдомен.ru/page?paramName=on | https://вашдомен.ru/page?paramName=off |
| https://вашдомен.ru/page?paramName=true | https://вашдомен.ru/page?paramName=false |
| https://вашдомен.ru/page?paramName=1 | https://вашдомен.ru/page?paramName=0 |
2. Тип поля Выбор или Список
Для полей типа Выбор и Список можно передавать параметр как:
- Название варианта, чувствительное к регистру (например, ?paramName=Вариант 1)
- Порядковый номер варианта (например, ?paramName=1 для первого варианта)
| В поле выбран Вариант 1 | В поле выбран Вариант 2 |
|---|---|
| https://вашдомен.ru/page?paramName=Вариант 1 | https://вашдомен.ru/page?paramName=Вариант 2 |
| https://вашдомен.ru/page?paramName=1 | https://вашдомен.ru/page?paramName=Вариант 2 |
3. Для всех остальных типов полей используйте синтаксис:
Значение по умолчанию , где:
paramName это имя параметра, которое соответствует типу поля;
Значение по умолчанию замените на значение, которое хотите видеть в поле, как значение по умолчанию. Например, город Калининград в поле Текст.
Ссылка для значения по умолчанию Калининград:
https://вашдомен.ru/page?text=Калининград
Для отображения другого города по умолчанию замените Калининград на нужный вам город.
Звонок по России бесплатный
8 (800) 555-45-12
© 2012 – 2025 ООО «Флексби»
