Тэг tab — вкладка формы

Примеры использования

Чаще всего используется в таком виде:

<tab name="general">
    <elements>
        <!-- Перечисление полей и элементов вкладки -->
    </elements>
</tab>

Пример со всеми атрибутами:

<tab name="checkyourself" caption="Проверка данных" hint="Отображает возможные ошибки в данных">
    <ccounts>
        <circle color='-1' hint='Ошибок' value="{{count_errors}}" />
        <circle color='1' hint='Предупреждений' value="{{count_warnings}}" />
    </ccounts>
    <condition name="do_check" checked="1" /> <!-- tab целиком можно скрывать с помощью condition (как и обычное поле) -->
    <!-- В тэге elements располагаются поля вкладки. 
    ВАЖНО! Также, в нём можно задавать атрибуты по умолчанию для всех элементов внутри -->
    <elements width="{{#76*9}}"> <!-- Например, так у всех элементов, включая html будет ширина 684 пикселя. -->
        <field name="foo" prompt="Проба пера" />
        <!-- ... -->
        <html><![CDATA[<h2>HELLO WORLD!</h2>]]></html>
        <!-- ... -->
    </elements>
    <!-- Тэгов elements может быть несколько -->
    <elements>
        <field name="test" prompt="BAR" type="int"/>
    </elements>
    <finishsql>
        <!-- Finishsql могут быть в любом месте внутри формы -->
    </finishsql>
</tab>

Элементы

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

(N) — элемент может использоваться несколько раз, (1) — элемент используется один раз. Жирным выделены самые часто используемые элементы.

  • condition(N) — задаёт условия, при которых вкладка будет отображаться. Если не указан, то вкладка будет отображаться всегда.

  • ccounts(N) — тэг для задания цветовых кружков (например, контроля сроков) внутри вкладки.

  • elements (N) — элементы формы (поля, html-вставки, встроенные списки, etc.). Также этот тег позволяет задавать параметры по умолчанию для элементов внутри себя.

  • finishsql (N) — запрос, выполняющийся при сохранении и/или удалении. Может быть использован как внутри elements (так чаще всего происходит), так и сразу внутри вкладки (равно, кстати, как и за пределами вкладки, просто в теге form).

Атрибуты

Атрибут Описание Примечание
caption Текстовое обозначение формы — заголовок, который виден пользователю.
name Ключ вкладки, на английском языке Допустимо использовать только латинские буквы, цифры (но не в начале) и знак подчеркивания. _TODO: добавить проверку в движок.
hidden _TODO: Планируется. Но пока нет.
hint Подсказка. Будет показываться при наведении мышки на вкладку. Редко используется. Реализовано (пока что) через атрибут title="" в html. Никакого специального выделение нет. Иконка тоже не добавляется. Пока так.
title Такого атрибута нет! Это ошибка!
help Такого атрибута нет! Это ошибка!

results matching ""

    No results matching ""