Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
— |
tags:tablist [29/10/2020 16:32] (текущий) |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
+ | ====== <tablist ... > ====== | ||
+ | |||
+ | ''Список закладок. '' | ||
+ | ---- | ||
+ | ===== Синтаксис ===== | ||
+ | <file> | ||
+ | <tablist tablist-attributes> | ||
+ | [{<tab> | ||
+ | ... | ||
+ | <tab/>}] | ||
+ | <tablist/> | ||
+ | </file> | ||
+ | |||
+ | ===== Атрибуты Tablist ===== | ||
+ | |||
+ | ==== Основные атрибуты (R/W): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **id** | [[intro:types#id_name]] |Уникальный, в рамках приложения, идентификатор объекта. Доступ к объекту с помощью AppScript выполняется через этот идентификатор. \\ Если id не задан, то интерпретатор автоматически заполнит его некоторым случайным в момент запуска приложения. В этом случае appxml-программист лишается возможности обращаться к объекту.| | ||
+ | |||
+ | ==== Визуальные атрибуты (R/W): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **order** | ''top | bottom | left | right'' |Указание месторасположения закладок.| | ||
+ | | **scroll** | [[intro:types#boolean]] |Флаг, регулирующий расположение закладок: "true" - в одну строку с прокруткой, "false" - в несколько строк. По умолчанию, scroll="false".| | ||
+ | | **moving** | [[intro:types#boolean]] |Перемещение окна перемещением tablist. По умолчанию moving="true".| | ||
+ | |||
+ | ==== Командные атрибуты (W/O): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **repeat** | [[intro:types#number]] |Командный атрибут, выполняющий следующую функцию: создать n закладок, взяв в качестве шаблона то описание, что внутри <tablist>. Id закладок-шаблонов не изменяются. Применяется для создания динамического количества закладок. Рекомендуется вместо repeat использовать атрибут id-list.| | ||
+ | | **remove-all** | [[intro:types#boolean]] |Команда удаления всех вкладок.| | ||
+ | | **id-list** | ''id1, id2, ...'' |Командный атрибут, выполняющий следующую функцию: создать закладки в количестве, равным списку id-list, взяв в качестве шаблона то описание закладки, что внутри <tablist>. Если закладки-шаблоны имеют id, то результирующее id = id закладки + "-" + id из списка. Применяется для создания динамического количества закладок. Атрибут похож на repeat, но предпочтительнее repeat, т.к. можно управлять id закладок.| | ||
+ | | **add** | |Добавление новой закладки.| | ||
+ | | **add-id** | ''id4newtab'' |Добавление новой закладки на основе описанной внутри <tablist> закладки (см. id-list).| | ||
+ | |||
+ | ==== Прочие атрибуты (R/W): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **active** | ''tabId | tabN'' |Установка активной закладки. Закладка определяется либо по ее id, либо по ее порядковому номеру.| | ||
+ | |||
+ | ==== Событийные атрибуты (R/W): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **onCreated** | [[intro:types#code]] |Описание действий для события, возникающего единожды, после создания объекта. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onChanged** | [[intro:types#code]] |Описание действий для события, возникающего при изменении содержимого объекта. this является ссылкой на объект tablist. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | |||
+ | ===== Атрибуты Tab ===== | ||
+ | |||
+ | ==== Основные атрибуты (R/W): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **title** | [[intro:types#string]] |Заголовок объекта. Атрибут имеет силу только при создании объекта. Изменение значения атрибута после | ||
+ | создания объекта не будет иметь эффекта. Имеет дополнительные атрибуты: title-before, title-after, title-visible.| | ||
+ | | **visible** | [[intro:types#boolean]] |Флаг, регулирующий видимость объекта.| | ||
+ | |||
+ | ==== Событийные атрибуты (R/W): ==== | ||
+ | |||
+ | ^ Название ^ Тип ^ Описание ^ | ||
+ | | **onCreated** | [[intro:types#code]] |Описание действий для события, возникающего единожды, после создания объекта. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onSelected** | [[intro:types#code]] |Описание действий для события, возникающего при показе объекта пользователю. this является ссылкой на объект tab. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | | **onHided** | [[intro:types#code]] |Описание действий для события, возникающего при скрытии объекта от пользователя. this является ссылкой на объект tab. \\ Правила описания см. ([[intro:event_desc|Описание событий в ApplicationXML]]).| | ||
+ | |||
+ | |||
+ | |||
+ | ===== Описание ===== | ||
+ | |||
+ | Вкладки в tablist описываются с помощью тэга <tab>. | ||
+ | |||
+ | |||
+ | |||
+ | ===== Примеры ===== | ||
+ | |||
+ | Динамическое создание вкладок. | ||
+ | <code> | ||
+ | <panel layout="flow" position="top" align="left"> | ||
+ | <button id="add_tab" text="Добавить вкладку"> | ||
+ | <onaction> | ||
+ | var b = tab_id.addItem(); | ||
+ | tab_id.currentItem(b.id); | ||
+ | tab_id.currentItem().title = "Вкладка №" + tab_id.currentItem().id; | ||
+ | </onaction> | ||
+ | </button> | ||
+ | </panel> | ||
+ | <panel id="p" position="center"> | ||
+ | <tablist id="tab_id"/> | ||
+ | </panel> | ||
+ | </code> | ||
+ | |||
+ | Статическое создание вкладок | ||
+ | <code> | ||
+ | <panel id="p" position="center"> | ||
+ | <tablist id="tab_id"> | ||
+ | <tab title="Я Вкладка №1"/> | ||
+ | <tab title="Я Вкладка №2"/> | ||
+ | <tab title="Я Вкладка №3"/> | ||
+ | </tablist> | ||
+ | </panel> | ||
+ | </code> | ||