From 732efd2b3d388fff7eaf82f8aad0dd637c0a7da4 Mon Sep 17 00:00:00 2001 From: Aleksey Chichenkov Date: Wed, 10 Oct 2018 17:53:39 +0300 Subject: [PATCH] =?UTF-8?q?=D0=BD=D0=B5=D0=B1=D0=BE=D0=BB=D1=8C=D1=88?= =?UTF-8?q?=D0=BE=D0=B9=20=D1=80=D0=B5=D1=81=D1=82=D0=B0=D0=B9=D0=BB=D0=B8?= =?UTF-8?q?=D0=BD=D0=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docfiles/mainpage/main.js | 6 +- .../attributes/attribute.js | 100 +++++++++++++++++- .../globalAttributeTree/attributes/manager.js | 1 + .../trees/globalAttributeTree/node.js | 42 ++++++++ .../managers/trees/globalTree/node.js | 1 + templates/initi/publish.js | 2 +- templates/initi/static/styles/common.css | 34 ++++-- templates/initi/tmpl/method_compact.tmpl | 4 +- 8 files changed, 177 insertions(+), 13 deletions(-) diff --git a/docfiles/mainpage/main.js b/docfiles/mainpage/main.js index 1edba5a..66cbdeb 100644 --- a/docfiles/mainpage/main.js +++ b/docfiles/mainpage/main.js @@ -92,14 +92,14 @@ * * В общем случае они предназначены для отображение очень больших списков, которые могут подвесить GUI. * - * Пример использования паблишера есть в форме результатов обнануржения. + * Пример использования паблишера есть в форме результатов обнауржения. * * * *

* ### {@link Models}. Менеджер моделей. * - * Менеджер моделей предоставляет доступ к устройствами находящимся в системе, которые были отдискаверины или добавлены иным способом. + * Менеджер моделей предоставляет доступ к устройствами находящимся в системе, которые были обнаружены в сети или добавлены иным способом. * * Пример использования можно найти в Схеме моделей. * @@ -108,7 +108,7 @@ *

* ### {@link GroupTypes}. Менеджер типов групп. * - * Позволяет зная cTag, или иными словами тип группы, получить данные связанные с группой. + * Позволяет получить данные связанные с группой (cTag) * * Этот механизм используется в виджете для отображения атрибутов модели. * diff --git a/docfiles/providers/managers/trees/globalAttributeTree/attributes/attribute.js b/docfiles/providers/managers/trees/globalAttributeTree/attributes/attribute.js index 8c2e9d0..697d60c 100644 --- a/docfiles/providers/managers/trees/globalAttributeTree/attributes/attribute.js +++ b/docfiles/providers/managers/trees/globalAttributeTree/attributes/attribute.js @@ -1,10 +1,108 @@ /** - * Атрибут ноды + * #### Атрибут ноды * * @group manager * @class Attribute * @memberof Trees.GlobalAttributeTree.Node.Attributes */ function Attribute() { + /** + * Возвращает имя атрибута + * + * @public + * @function name + * @returns {v2.string} + * @memberof Trees.GlobalAttributeTree.Node.Attributes.Attribute + */ + this.name = function() { + + }; + + /** + * Возвращает значение атрибута + * + * @public + * @function value + * @returns {v2} + * @memberof Trees.GlobalAttributeTree.Node.Attributes.Attribute + */ + this.value = function() { + + }; + + /** + * Возвращает тип атрибута + * + * @public + * @function type + * @returns {v2.type} + * @memberof Trees.GlobalAttributeTree.Node.Attributes.Attribute + */ + this.type = function() { + + }; + + /** + * Возвращает значение о том, является ли атрибут редактируемым + * + * @public + * @function editable + * @returns {v2.boolean} + * @memberof Trees.GlobalAttributeTree.Node.Attributes.Attribute + */ + this.editable = function() { + + }; + + /** + * Возвращает значение о том, может ли данный атрибут быть удален + * + * @public + * @function removable + * @returns {v2.boolean} + * @memberof Trees.GlobalAttributeTree.Node.Attributes.Attribute + */ + this.removable = function() { + + }; + + /** + * Возвращает значение о том, может ли данный атрибут быть отображен + * + * @public + * @function visible + * @returns {v2.boolean} + * @memberof Trees.GlobalAttributeTree.Node.Attributes.Attribute + */ + this.visible = function() { + + }; + + /** + * **Небезопасный метод** + * + * Возвращет значение по указанному атрибуту + * + * @public + * @function parameter + * @param {string} _name + * @returns {v2} + * @memberof Trees.GlobalAttributeTree.Node.Attributes.Attribute + */ + this.parameter = function(_name) { + + }; + + /** + * Производит обновление атритбута + * + * @public + * @function update + * @param {v2} _value + * @memberof Trees.GlobalAttributeTree.Node.Attributes.Attribute + */ + this.update = function(_value) { + + }; } \ No newline at end of file diff --git a/docfiles/providers/managers/trees/globalAttributeTree/attributes/manager.js b/docfiles/providers/managers/trees/globalAttributeTree/attributes/manager.js index dbfed0b..5c4f177 100644 --- a/docfiles/providers/managers/trees/globalAttributeTree/attributes/manager.js +++ b/docfiles/providers/managers/trees/globalAttributeTree/attributes/manager.js @@ -1,4 +1,5 @@ /** @typedef {Trees.GlobalAttributeTree.Node.Attributes} NodeAttributes */ +/** @typedef {Trees.GlobalAttributeTree.Node.Attributes.Attribute} NodeAttribute */ /** * Интерфейс позволяющей пользователю работать с атрибутами ноды diff --git a/docfiles/providers/managers/trees/globalAttributeTree/node.js b/docfiles/providers/managers/trees/globalAttributeTree/node.js index 446bdd7..2ced587 100644 --- a/docfiles/providers/managers/trees/globalAttributeTree/node.js +++ b/docfiles/providers/managers/trees/globalAttributeTree/node.js @@ -1,4 +1,46 @@ /** + * ### Атрибутная нода + * Предоставляет интерфейс доступа к содержимому атрибутной ноды + * + * Здесь создаются менеджер по работе с атрибутами нодами + * + *
+ * Связанные объекты: + * + * - {@link Trees.GlobalTree.Node} - Здесь можно найти примеры, как работать с вложенными нодами + * - {@link Trees.GlobalAttributeTree} - Здесь можно найти примеры, как работать с глобальным деревом + * - {@link Trees.GlobalAttributeTree.Node.Attributes} - Здесь можно найти примеры, как работать с типами ноды + * + * + * @example + * // Пример: Как получить ноду дерева? + * + * // Пример взят для дерева пользовательских данных (т.к. у него есть атрибуты) + * var tree = null; + * var node = null; + * + * // Осуществляем запрос к менеджеру деревьев, на получение провайдера дерева + * ps.pl.tm.get(new v2.string("uat")).then(function(ref){ + * // ref - это ссылка на объект + * // метод value возвращает целевой объект. В данном случае дерево Trees.UserAttributeTree + * tree = ref.value(); + * + * // Доступ к ноде осуществляется похожим образом, но теперь вместо строки нужно указать v2.integer + * // Так как возвратится нативный проимс, мы можем вернуть его и обработать в следующем then + * return tree.get(v2.integer.from_number(0)) + * }, function(err){ + * // в случае неудачи придет ошибка. + * // обычно в ошибке содержится три переменные err - код ошибки, message - краткое описание, sub - если к этому + * // привела другая ошибка внутри системы. + * }).then(function(ref){ + * // Вот мы и получили ноду. + * node = ref.value(); + * }, function(err){ + * // Отобразим ошибку + * console.warn(err); + * }) + * + * * @class Node * @extends Trees.GlobalTree.Node * @memberof Trees.GlobalAttributeTree diff --git a/docfiles/providers/managers/trees/globalTree/node.js b/docfiles/providers/managers/trees/globalTree/node.js index e4dcff1..98b42bf 100644 --- a/docfiles/providers/managers/trees/globalTree/node.js +++ b/docfiles/providers/managers/trees/globalTree/node.js @@ -10,6 +10,7 @@ * - {@link Trees.GlobalTree} - Здесь можно найти примеры, как работать с глобальным деревом * - {@link Trees.GlobalTree.Node.Children} - Здесь можно найти примеры, как работать с вложенными нодами * - {@link Trees.GlobalTree.Node.NodeTypes} - Здесь можно найти примеры, как работать с типами ноды + * - {@link Trees.GlobalAttributeTree.Node} - Нода у которой присутствуют базовые и динамические атрибуты * * * @example diff --git a/templates/initi/publish.js b/templates/initi/publish.js index 39d9009..d9626a2 100644 --- a/templates/initi/publish.js +++ b/templates/initi/publish.js @@ -548,7 +548,7 @@ function buildMemberNavNamespace(items, itemHeading, itemsSeen, linktoFn) { } function buildNav(members) { - var nav = '

GUI 2.9.1-develop

'; + var nav = '

GUI 2.9.1-develop

'; nav += render_explorer(members.namespaces, members.classes); diff --git a/templates/initi/static/styles/common.css b/templates/initi/static/styles/common.css index 05bda8b..4026eae 100644 --- a/templates/initi/static/styles/common.css +++ b/templates/initi/static/styles/common.css @@ -21,25 +21,35 @@ div.full-method > .title span color: #d85a00; } +div.short > span.name, +div.short > span.name a, +div.short div.type > span.name, +div.short div.type > span.name a, +div.short span.access, +div.short div.params span, +div.parameter div.type span.name, +div.parameter div.type span.name > a, * { font-size: 15px; } -div.type > span.name, -div.type > span.name a, +.type > span.name, +.type > span.name a, div.returns > span.name, div.returns > span.name a, -div.short > span.name, -div.short > span.name a, span.access, -div.params span, -div.returns span, +.params span, +.returns span, dl.article-sub-classes a, ul.extends li a { font-size: 20px; } +.param .gap { + width: 15px; +} + .ib { display: inline-block; } @@ -160,3 +170,15 @@ h4, h4 a width: 4px; display: inline-block; } + +.access { + min-width: 60px; +} + +.compact-method { + word-spacing: 8px; +} + +.compact-method * { + word-spacing: 0px; +} diff --git a/templates/initi/tmpl/method_compact.tmpl b/templates/initi/tmpl/method_compact.tmpl index 18e882b..5a09e05 100644 --- a/templates/initi/tmpl/method_compact.tmpl +++ b/templates/initi/tmpl/method_compact.tmpl @@ -6,7 +6,7 @@ var self = this; ?>
- +
@@ -26,7 +26,7 @@ var self = this; ]
- , + ,