Привязки

Последнее обновление Nov 27th, 2019 | История страницы | Улучшить эту страницу | Сообщить о проблеме

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$301 per month—let's make that $500!

Learn more

С помощью привязок вы можете определить динамический источник данных для переменной шаблона. Обычно используется для телевизоров selectbox или checkbox, где редактор может выбрать один или несколько соответствующих параметров, которые отображаются динамически.

Например:

внешне сгенерированный файл, который отправляется через FTP на сервер
таблица базы данных, доступная для MODX
Ресурс в дереве ресурсов
Чанк в дереве элементов
результат оцененного PHP-скрипта

Эти источники данных могут быть привязаны (или «связаны») к переменной шаблона для форматирования и отображения в документе. Кроме того, связанные данные на TV можно легко отформатировать с помощью средств управления TV для получения действительно потрясающих результатов. Формат для использования типов привязок источника данных, доступных для всех переменных шаблона, следующий:

@FILE file_path
@RESOURCE resource_id
@CHUNK chunk_name
@SELECT sql_query
@DIRECTORY path_relative_to_base_path
@INLINE доступный в некоторых дополнительных объектах (например, getResources), это указывает блок форматирования in-line в виде строки.

Эти «@» команды или привязки позволят вам быстро и легко присоединить переменные шаблона практически к любой доступной системе базы данных.

Значение, возвращаемое из источника данных, может быть либо строковым значением (включая числа, даты и т.д.), массивом или набором записей. Возвращаемое значение зависит от типа используемой привязки. Некоторые элементы управления отображением будут пытаться преобразовать возвращаемое значение в строку или массив.

Например, элементы управления, которые принимают строковые значения, такие как группа переключателей или список выбора, будут пытаться преобразовать набор записей (строки и столбцы) в следующий формат:

col1row1Value==col2row1Value||col1row2Value==col2row2Value,...

Обратите внимание, что @-bindings работают только в полях «Значения параметра ввода» или «Значение по умолчанию».

При размещении @ привязок внутри поля «Значения параметров ввода» они используются для форматирования параметров ввода только при редактировании документа в Менеджере, например, для создания раскрывающегося списка городов или стран.

При размещении @ привязок внутри поля «Значение по умолчанию» возвращаемое значение используется для отображения на конечной веб-странице. Это позволяет очень быстро создавать сложные формы для ввода данных в Интернете.

Types¶

Некоторые дополнения, такие как getResources, поддерживают привязки @INLINE или @FILE для своих чанков.

Смотрите также¶

Переменные шаблона TV