-

docs/forms/cmp/index.rst

@@ -25,3 +25,4 @@
   resolutionlist
   processlist
   doclink
+  repeater

docs/forms/cmp/repeater.rst

+«Период повторения»
+===================
+
+.. js:class:: AS.FORMS.RepeatPeriodView
+
+    Отображение компонента, наследует :js:class:`AS.FORMS.View`
+
+    .. code-block:: js
+
+        {
+          "id": "repeater-cmp",
+          "type": "repeater",
+          "style": {},
+          "config": {
+            "read-only": false,     // заблокировать от изменений пользователем
+            "locale": "ru",         // язык
+            "script": ""
+          },
+          "fromHistory": true,
+          "fullId": "repeater-cmp",
+          "required": false
+        }
+
+--------------------------------------------------------------------------------
+
+.. js:class:: AS.FORMS.RepeatPeriodModel
+
+    Модель компонента, наследует :js:class:`AS.FORMS.Model`
+
+    .. code-block:: js
+
+        // Формат данных для значения «По дням недели»
+        {
+          "id": "repeater-cmp",
+          "type": "repeater",
+          "value": "По дням недели: Понедельник, Среда, Пятница", // значение состоит из типа значения («По дням недели») и через «: » список полных названий дней недели, разделенных «, »
+          "key": "1|1.0;3.0;5.0;"                                 // значение состоит из типа значения (1 - это по дням недели) и через «|» список значений, разделенных «;», каждое значение в формате порядковый_номер_дня_недели.0
+        }
+
+    .. code-block:: js
+
+        // Формат данных для значения «По дням месяца»
+        {
+          "id": "repeater-cmp",
+          "type": "repeater",
+          "value": "По дням месяца: 1, 15, 30", // значение состоит из типа значения («По дням месяца») и через «: » список дней месяца, разделенных «, »
+          "key": "2|1.0;15.0;30.0;"             // значение состоит из типа значения (2 - это по дням месяца) и через «|» список значений, разделенных «;», каждое значение в формате день_месяца.0
+        }
+
+    .. code-block:: js
+
+        // Формат данных для значения «Ежегодно»
+        {
+          "id": "repeater-cmp",
+          "type": "repeater",
+          "value": "Ежегодно: 1 Октябрь, 31 Декабрь", // значение состоит из типа значения («Ежегодно») и через «: » список дней года, разделенных «, », каждое значение в формате номер_месяца.номер_дня
+          "key": "4|1.10;31.12;"                      // значение состоит из типа значения (4 - это ежегодно) и через «|» список значений, разделенных «; », каждое значение в формате номер_дня.номер_месяца
+        }
+
+    .. js:data:: type
+
+        Тип периода (0 - нет, 1 - по дням недели, 2 - по дням месяца, 4 - ежегодно)
+
+    .. js:function:: getTypeText()
+
+        Получить текстовую расшифровку выбранного типа
+
+        :returns: ``string``
+
+    .. js:function:: getValue()
+
+        Получить значение компонента
+
+        :returns: ``[string]`` массив элементов согласно типу, например [«1.10», «31.12»]
+
+    .. js:function:: getValueString()
+
+        Получить строчное представление данных
+
+        :returns: ``[object]`` массив элементов согласно типу, например [«1.10», «31.12»]
+
+    .. js:function:: setValue(newValue)
+
+        :param string newValue: cтрока вида: ``4|1.4;11.5;12.7;30.9``
+
+    .. js:function:: setValueFromInput(newType, newValues)
+
+        :param number newType: тип периода
+        :param [string] newValues: массив строк согласно типу, например [«4.1», «5.11», «7.12», «9.30»]