Свойства

Большинство элементов, описанных ранее, могут иметь свойства. Свойства во многом похожи на настройки. Они являются набором переменных, каждая из которых имеет имя, значение и описание. Подобно настройкам они могут создаваться и редактироваться в панели управления. Свойства наиболее часто используются со сниппетами, но также используются с плагинами, чанками, шаблонами и tv-параметрами.

Свойства могут показаться избыточными, но между ними и настройками есть важное различие. Настройки воздействуют на все страницы сайта. Свойства, наоборот, прикреплены к отдельным элементам MODX (чанкам, сниппетам, плагинам, шаблонам и tv-параметрам), поэтому область их действия ограничена элементом, к которому они прикреплены. Это делает их более эффективным выбором, когда вы хотите, чтобы значение применялось к отдельному элементу или к группе элементов, но не ко всему сайту.

В случае, когда свойства прикреплены к сниппету или плагину, значения свойств могут содержать информацию, используемую в этом элементе. Когда свойства прикрепляются к другому элементу, их значения передаются этому элементу через теги плейсхолдеров.

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

При указании в теге свойству всегда предшествует символ амперсанда, а их значения заключаются в обратные одинарные кавычки. Ниже приведен пример с двумя свойствами, задаваемыми в теге сниппета :

[[SnippetName? &color=`red` &size=`large`]]

В данном примере значение свойства color устанавливается в "red", а значение свойства size устанавливается в "large". Многие стандартные сниппеты MODX используют свойства для передачи информации, которая требуется сниппету для выполнения его работы и управления действиями сниппета.

Сниппет, подобный Wayfinder, который создает меню, например, может иметь свойство, которое определяет отображать ли в меню неопубликованные ресурсы. Это свойство может выглядеть следующим образом :

&showUnpublished=`1`

Кроме передачи в тегах свойства могут создаваться и редактироваться в разделе панели управления Инструменты -> Наборы параметров. Они также могут создаваться и редактироваться в разделе "Свойства"  любого элемента, где они используются. Второй метод обычно является гораздо лучшим выбором, если вы планируете использовать набор свойств с определенным элементом. Если же вы хотите просто переопределить несколько свойств по умолчанию, проще всего передать им свойства в теге элемента.

В более ранних версиях MODX свойства, передаваемые в теге, назывались параметрами. Вы можете до сих пор встретить этот термин в документации на старые версии или на форумах MODX.

Более подробно мы рассмотрим свойства и все варианты их использования позднее.

Назад Вперёд