Логотип

Документация по макросам и шаблонам UMI.CMS

Описание атрибутов из пространства имен umi

Атрибуты из пространства имен umi необходимы для указания редактируемых регионов.

Список атрибутов

umi:element-id

Указывает идентификатор элемента (страницы), соответствующий редактируемой области. Если этот атрибут указан, создается редактируемый регион.

umi:object-id

Указывает идентификатор объекта, соответствующий редактируемой области. Если этот атрибут указан, создается редактируемый регион.

umi:field-name

Указывает идентификатор свойства элемента или объекта (можно посмотреть в шаблонах данных), с которым связана редактируемая область. Работает только в связке с umi:element-id или umi:object-id.

Если umi:object-id и umi:element-id не указан, пытается взять его у первой родительской редактируемой области.

Если этот атрибут указан и определен идентификатор объекта или элемента, создается редактируемый регион с возможностью править свойство.

umi:module, umi:method

Указывает какому модулю и методу соответствует редактируемая область. Если оба атрибута указаны, создается редактируемый регион с возможностью добавлять объекты или элементы. Если у области указан umi:element-id, то создаваемые элементы (страницы) будут создаваться дочерними от элемента, соответствующего идентификатору umi:element-id

umi:delete="delete"

При наличии этого атрибута с этим значением выводится иконка удаления рядом с редактируемым полем. По умолчанию при нажатии на эту иконку страница с указанным element-id будет перемещена в корзину, а в случае объекта — объект с указанным object-id будет удален из системы. Однако при необходимости, можно задать настройку eip.fake-delete = "1" в config.ini: Секция [system] — в этом случае элемент всего лишь будет скрыт с сайта (станет неактивным).

Атрибут нужно добавлять к текстовым элементам <a> и <p>. Для других элементов иконка удаления страницы не выводится.

umi:region

Используется для обозначения списков элементов. Может принимать два значения: list и row. В таких списках можно добавлять, удалять или перемещать элементы.

umi:region="list" — это значение атрибута должно использоваться у тега оборачивающего список элементов (например, в случае маркированного списка, для элемента <ul>). Для того чтобы работало перемещение (drag and drop) необходимо, чтобы у этого элемента также стоял атрибут umi:sortable="sortable".

umi:region="row" — это значение атрибута должно использоваться у тега обозначающего отдельный элемент списка (например, в случае маркированного списка, для элемента <li>).

umi:add-method="popup"

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

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

umi:sortable="sortable"

Наличие этого атрибута с этим значением у области с umi:region="list" указывает, что разрешено перетаскивание элементов с umi:region="row" внутри этой области.

umi:button-position

Указывает положение кнопки Добавить. Может принимать значения "top left" (сверху слева), "top right" (сверху справа), "bottom left" (снизу слева), "bottom right" (снизу справа).

umi:empty

Указывает значение, которое будет отображаться в редактируемом поле вместо пустого значения.