Jump to main content Jump to doc navigation

Что такое @ привязки?

В контексте шаблонных переменных Tv источником данных является расположение отображаемой информации. Источник данных может поступать из любого из следующих источников:

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

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

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

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

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

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

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

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

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

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

Types

getResources дополнение поддерживающее @INLINE привязку.

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