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 привязку.

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

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

  • modmore
  • STERC
  • Jens Wittmann – Gestaltung & Entwicklung
  • Fabian Christen
  • Digital Penguin
  • Dannevang Digital
  • Sepia River Studios
  • CrewMark
  • Chris Fickling
  • deJaya
  • Following Sea
  • Anton Tarasov
  • eydolan
  • Raffy
  • Lefthandmedia
  • Murray Wood
  • Snow Creative
  • Nick Clark
  • Helen
  • JT Skaggs
  • krisznet
  • YJ
  • Yanni
  • Richard

Budget

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

Learn more