@tetacom/ng-components 1.6.6 → 1.6.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -70,208 +70,10 @@ Table (таблица) — компонент, который отображае
70
70
 
71
71
  ### Свойства
72
72
 
73
- <table>
74
- <thead>
75
- <tr>
76
- <th>Свойство</th>
77
- <th>Tип</th>
78
- <th>Описание</th>
79
- </tr>
80
- </thead>
81
- <tbody>
82
- <tr>
83
- <td class="text-align-center">
84
- <p>data</p>
85
- </td>
86
- <td class="text-align-center">
87
- <code>any[]</code>
88
- </td>
89
- <td class="text-align-center">
90
- <p>Данные для формирования таблицы</p>
91
- </td>
92
- </tr>
93
- <tr>
94
- <td class="text-align-center">
95
- <p>cookieName</p>
96
- </td>
97
- <td class="text-align-center">
98
- <code>string</code>
99
- </td>
100
- <td class="text-align-center">
101
- <p>Будут формироваться куки данных таблицы с указанным именем</p>
102
- </td>
103
- </tr>
104
- <tr>
105
- <td class="text-align-center">
106
- <p>columns</p>
107
- </td>
108
- <td class="text-align-center">
109
- <code>TableColumns[]</code>
110
- </td>
111
- <td class="text-align-center">
112
- <p>Шаблон столбцов таблицы</p>
113
- </td>
114
- </tr>
115
- <tr>
116
- <td class="text-align-center">
117
- <p>virtual</p>
118
- </td>
119
- <td class="text-align-center">
120
- <code>boolean</code>
121
- </td>
122
- <td class="text-align-center">
123
- <p>Флаг для добавления виртульного скролла</p>
124
- </td>
125
- </tr>
126
- <tr>
127
- <td class="text-align-center">
128
- <p>dict</p>
129
- </td>
130
- <td class="text-align-center">
131
- <code>any[]</code>
132
- </td>
133
- <td class="text-align-center">
134
- <p>
135
- Массив выбираемых элементов. Каждое свойство имеет название, которое должно совпадать с соответствующим
136
- свойством в <code>data</code>. В качестве значения принимает массив объектов id,name.Требуется если вы
137
- добавляете ячейку типа лист.
138
- </p>
139
- </td>
140
- </tr>
141
- <tr>
142
- <td class="text-align-center">
143
- <p>contextMenu</p>
144
- </td>
145
- <td class="text-align-center">
146
- <code>template</code>
147
- </td>
148
- <td class="text-align-center">
149
- <p>Шаблон контекстного меню </p>
150
- </td>
151
- </tr>
152
- <tr>
153
- <td class="text-align-center">
154
- <p>filterOptions</p>
155
- </td>
156
- <td class="text-align-center">
157
- <code>IDictionary&lt;IIdName&lt;any&gt;[]&gt;</code>
158
- </td>
159
- <td class="text-align-center">
160
- <p>Список опций для фильтрации, если не задано - берет Dict</p>
161
- </td>
162
- </tr>
163
- <tr>
164
- <td class="text-align-center">
165
- <p>editType</p>
166
- </td>
167
- <td class="text-align-center">
168
- <code>EditType</code>
169
- </td>
170
- <td class="text-align-center">
171
- <p>
172
- Тип редактирования - построчно или по ячейкам. При построчном - активируется вся строка для редактирования,
173
- иначе - по одной ячейке
174
- </p>
175
- </td>
176
- </tr>
177
- <tr>
178
- <td class="text-align-center">
179
- <p>editEvent</p>
180
- </td>
181
- <td class="text-align-center">
182
- <code>EditEvent</code>
183
- </td>
184
- <td class="text-align-center">
185
- <p>Выбор события при котором начинается редактирование ячейки таблицы</p>
186
- </td>
187
- </tr>
188
- <tr>
189
- <td class="text-align-center">
190
- <p>selectType</p>
191
- </td>
192
- <td class="text-align-center">
193
- <code>SelectType</code>
194
- </td>
195
- <td class="text-align-center">
196
- <p>Тип выбора строк. Никак, чекбоксами (появляется доп столбец с чеком), или просто мышью.</p>
197
- </td>
198
- </tr>
199
- <tr>
200
- <td class="text-align-center">
201
- <p>selectedRows</p>
202
- </td>
203
- <td class="text-align-center">
204
- <code>any[]</code>
205
- </td>
206
- <td class="text-align-center">
207
- <p>Свойство отвечающее за выбранные ячейки</p>
208
- </td>
209
- </tr>
210
- <tr>
211
- <td class="text-align-center">
212
- <p>tableService</p>
213
- </td>
214
- <td class="text-align-center">
215
- <code>function</code>
216
- </td>
217
- <td class="text-align-center">
218
- <p>Срабатывает при создании сервиса и отдает его.</p>
219
- </td>
220
- </tr>
221
- <tr>
222
- <td class="text-align-center">
223
- <p>cellEditEnd</p>
224
- </td>
225
- <td class="text-align-center">
226
- <code>function</code>
227
- </td>
228
- <td class="text-align-center">
229
- <p>Указанная функция применяется при окончании редактирования ячейки </p>
230
- </td>
231
- </tr>
232
- <tr>
233
- <td class="text-align-center">
234
- <p>cellEditStart</p>
235
- </td>
236
- <td class="text-align-center">
237
- <code>function</code>
238
- </td>
239
- <td class="text-align-center">
240
- <p>Указанная функция применяется при начале редактирования ячейки </p>
241
- </td>
242
- </tr>
243
- <tr>
244
- <td class="text-align-center">
245
- <p>rowEditEnd</p>
246
- </td>
247
- <td class="text-align-center">
248
- <code>function</code>
249
- </td>
250
- <td class="text-align-center">
251
- <p>Указанная функция применяется при окончании редактирования строчки.</p>
252
- </td>
253
- </tr>
254
- <tr>
255
- <td class="text-align-center">
256
- <p>rowEditStart</p>
257
- </td>
258
- <td class="text-align-center">
259
- <code>function</code>
260
- </td>
261
- <td class="text-align-center">
262
- <p>Указанная функция применяется при начале редактирования строчки.</p>
263
- </td>
264
- </tr>
265
- <tr>
266
- <td class="text-align-center">
267
- <p>activeRowChange</p>
268
- </td>
269
- <td class="text-align-center">
270
- <code>function</code>
271
- </td>
272
- <td class="text-align-center">
273
- <p>Указанная функция применяется при изменении выбранной строчки.</p>
274
- </td>
275
- </tr>
276
- </tbody>
277
- </table>
73
+ | Свойство | Тип | Описание |
74
+ | ---------- | ---------------- | ------------------------------------------------------------------------------------------------------------------- |
75
+ | data | `any[]` | Данные для формирования таблицы |
76
+ | cookieName | `string` | Будут формироваться куки данных таблицы с указанным именем |
77
+ | columns | `TableColumns[]` | Шаблон столбцов таблицы |
78
+ | virtual | `boolean` | Флаг для добавления виртуального скролла |
79
+ | dict | `any[]` | Массив выбираемых элементов. Каждое свойство имеет название, которое должно совпадать с соответствующим свойством в |
package/docs/tabsDocs.mdx CHANGED
@@ -64,100 +64,18 @@ Tab (таб) — компонент, который переключают вк
64
64
 
65
65
  #### teta-tabs
66
66
 
67
- <table>
68
- <thead>
69
- <tr>
70
- <th>Свойство</th>
71
- <th>Tип</th>
72
- <th>Описание</th>
73
- </tr>
74
- </thead>
75
- <tbody>
76
- <tr>
77
- <td class="text-align-center">
78
- <p>activeId</p>
79
- </td>
80
- <td class="text-align-center">
81
- <code>string</code>
82
- </td>
83
- <td class="text-align-center">
84
- <p>
85
- Используется для указания выбранного таба (аттрибут не обязателен, т.к. компонент сам умеет управлять своим
86
- состоянием)
87
- </p>
88
- </td>
89
- </tr>
90
- <tr>
91
- <td class="text-align-center">
92
- <p>tabChange</p>
93
- </td>
94
- <td class="text-align-center">
95
- <code>function</code>
96
- </td>
97
- <td class="text-align-center">
98
- <p>Принимает функцию, которая применяется при изменении активного таба.Отдает текущее состояния.</p>
99
- </td>
100
- </tr>
101
- <tr>
102
- <td class="text-align-center">
103
- <p>destroyOnHide</p>
104
- </td>
105
- <td class="text-align-center">
106
- <code>boolean</code>
107
- </td>
108
- <td class="text-align-center">
109
- <p>Свойство, отвечающее за уничтожение и пересоздание содержимого таба.</p>
110
- </td>
111
- </tr>
112
- </tbody>
113
- </table>
67
+ | Свойство | Тип | Описание |
68
+ | ---------- | ---------------- | ------------------------------------------------------------------------------------------------------------------- |
69
+ | data | `any[]` | Данные для формирования таблицы |
70
+ | cookieName | `string` | Будут формироваться куки данных таблицы с указанным именем |
71
+ | columns | `TableColumns[]` | Шаблон столбцов таблицы |
72
+ | virtual | `boolean` | Флаг для добавления виртуального скролла |
73
+ | dict | `any[]` | Массив выбираемых элементов. Каждое свойство имеет название, которое должно совпадать с соответствующим свойством в |
114
74
 
115
75
  #### teta-tab
116
76
 
117
- <table>
118
- <thead>
119
- <tr>
120
- <th>Свойство</th>
121
- <th>Tип</th>
122
- <th>Описание</th>
123
- </tr>
124
- </thead>
125
- <tbody>
126
- <tr>
127
- <td class="text-align-center">
128
- <p>id</p>
129
- </td>
130
- <td class="text-align-center">
131
- <code>string</code>
132
- </td>
133
- <td class="text-align-center">
134
- <p>Идентификатор,который используется при выборе активного таба</p>
135
- </td>
136
- </tr>
137
- <tr>
138
- <td class="text-align-center">
139
- <p>disabled</p>
140
- </td>
141
- <td class="text-align-center">
142
- <code>boolean</code>
143
- </td>
144
- <td class="text-align-center">
145
- <p>Отключает взаимодействие с табом</p>
146
- </td>
147
- </tr>
148
- <tr>
149
- <td class="text-align-center">
150
- <p>title</p>
151
- </td>
152
- <td class="text-align-center">
153
- <code>string</code>
154
- </td>
155
- <td class="text-align-center">
156
- <p>
157
- Замента директиве <code>tetaTabTitle</code>. Это свойство нужно использовать, если требуется вывести просто
158
- текст без дополнительных модификаций.
159
- </p>
160
- </td>
161
- </tr>
162
- </tbody>
163
- </table>
77
+ | Свойство | Тип | Описание |
78
+ | -------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------- |
79
+ | id | `string` | Идентификатор, который используется при выборе активного таба |
80
+ | disabled | `boolean` | Отключает взаимодействие с табом |
81
+ | title | `string` | Замена директиве `tetaTabTitle`. Это свойство нужно использовать, если требуется вывести просто текст без дополнительных модификаций. |
package/docs/tagDocs.mdx CHANGED
@@ -3,23 +3,14 @@ import TagStories from '../src/component/tag/Tag.stories';
3
3
 
4
4
  <Meta of={TagStories} />
5
5
 
6
- <div class="column gap-24">
7
- <h1>Тег</h1>
8
- <div class="column">
9
- <p>
10
- Tag (тег) — компонент, который объединяет между собой похожие объекты: статьи, документы, фотографии. По сути, это
11
- метки, которые позволяет маркировать и классифицировать контент, и состоят из релевантных ключевых слов, которые
12
- облегчают поиск и просмотр контента.
13
- </p>
14
- </div>
15
- <h3>Как использовать</h3>
16
- <div class="column">
17
- <p>
18
- Для того чтобы сделать чип, нужно к блоку добавить CSS класс <code>tag</code>
19
- </p>
20
- <p>Если помимо текста в чипе нужна кнопка (допустим кнопка с иконкой closeBig), то она должна идти после текста</p>
21
- <p>
22
- У тегов есть дополнительный класс для отображения с фоном - <code>tag_filled</code>
23
- </p>
24
- </div>
25
- </div>
6
+ # Тег
7
+
8
+ Tag (тег) — компонент, который объединяет между собой похожие объекты: статьи, документы, фотографии. По сути, это метки, которые позволяет маркировать и классифицировать контент, и состоят из релевантных ключевых слов, которые облегчают поиск и просмотр контента.
9
+
10
+ ### Как использовать
11
+
12
+ Для того чтобы сделать чип, нужно к блоку добавить CSS класс `tag`
13
+
14
+ Если помимо текста в чипе нужна кнопка (допустим кнопка с иконкой closeBig), то она должна идти после текста
15
+
16
+ У тегов есть дополнительный класс для отображения с фоном - `tag_filled`
@@ -3,58 +3,23 @@ import toggleStories from '../src/component/toggle/Toggle.stories';
3
3
 
4
4
  <Meta of={toggleStories} />
5
5
 
6
- <div class="column gap-24">
7
- <h1>Переключатель</h1>
8
- <div class="column">
9
- <p>Toggle (переключатель) — компонент, который позволяет переключаться между состояниями.</p>
10
- </div>
11
- <h3>Функции</h3>
12
- <div class="column">
13
- <p>
14
- Функционально тогл аналог чекбокса, но контекст их использования может отличаться. Тогл нельзя использовать для
15
- выбора элементов в списке. Например, выбрать несколько параметров.
16
- </p>
17
- <p>Тогл больше и заметнее чекбокса. Хорошо, когда на странице 1 тогл, максимум 2–3.</p>
18
- </div>
19
- <h3>Как использовать</h3>
20
- <div class="column">
21
- <p>
22
- <code>teta-toggle</code> - компонент для создание тогла. Для управления его состоянием используется{' '}
23
- <code>ngModel</code>
24
- </p>
25
- </div>
26
- <h3>Свойства</h3>
27
- <table>
28
- <thead>
29
- <tr>
30
- <th>Свойство</th>
31
- <th>Tип</th>
32
- <th>Описание</th>
33
- </tr>
34
- </thead>
35
- <tbody>
36
- <tr>
37
- <td class="text-align-center">
38
- <p>noLabel</p>
39
- </td>
40
- <td class="text-align-center">
41
- <code>boolean</code>
42
- </td>
43
- <td class="text-align-center">
44
- <p>Свойство, которое отображает/скрывает блок текста в тогле</p>
45
- </td>
46
- </tr>
47
- <tr>
48
- <td class="text-align-center">
49
- <p>disabled</p>
50
- </td>
51
- <td class="text-align-center">
52
- <code>boolean</code>
53
- </td>
54
- <td class="text-align-center">
55
- <p>Отключает взаимодействие со всем листом радиокнопок</p>
56
- </td>
57
- </tr>
58
- </tbody>
59
- </table>
60
- </div>
6
+ # Переключатель
7
+
8
+ Toggle (переключатель) — компонент, который позволяет переключаться между состояниями.
9
+
10
+ ### Функции
11
+
12
+ Функционально тогл — аналог чекбокса, но контекст их использования может отличаться. Тогл нельзя использовать для выбора элементов в списке. Например, выбрать несколько параметров.
13
+
14
+ Тогл больше и заметнее чекбокса. Хорошо, когда на странице 1 тогл, максимум 2–3.
15
+
16
+ ### Как использовать
17
+
18
+ `teta-toggle` - компонент для создание тогла. Для управления его состоянием используется `ngModel`
19
+
20
+ ### Свойства
21
+
22
+ | Свойство | Тип | Описание |
23
+ | -------- | --------- | --------------------------------------------------------- |
24
+ | noLabel | `boolean` | Свойство, которое отображает/скрывает блок текста в тогле |
25
+ | disabled | `boolean` | Отключает взаимодействие со всем листом радиокнопок |
@@ -3,20 +3,12 @@ import ToolbarStories from '../src/component/toolbar/Toolbar.stories';
3
3
 
4
4
  <Meta of={ToolbarStories} />
5
5
 
6
- <div class="column gap-24">
7
- <h1>Панель инструментов</h1>
8
- <div class="column">
9
- <p>
10
- Toolbar (панель инструментов) — элемент графического интерфейса пользователя. Обычно панель инструментов
11
- располагается в верхней части окна программы и содержит иконки, кнопки или выпадающие списки, которые позволяют
12
- пользователю выполнять определенные действия без необходимости просматривать меню или вводить команды вручную.
13
- </p>
14
- </div>
15
- <h3>Как использовать</h3>
16
- <div class="column">
17
- <p>
18
- Для создания туллбара используется компонент <code>teta-toolbar</code>
19
- </p>
20
- <p>Внутрь передается контент, который необходимо отобразить в нем.</p>
21
- </div>
22
- </div>
6
+ # Панель инструментов
7
+
8
+ Toolbar (панель инструментов) — элемент графического интерфейса пользователя. Обычно панель инструментов располагается в верхней части окна программы и содержит иконки, кнопки или выпадающие списки, которые позволяют пользователю выполнять определенные действия без необходимости просматривать меню или вводить команды вручную.
9
+
10
+ ### Как использовать
11
+
12
+ Для создания туллбара используется компонент `teta-toolbar`
13
+
14
+ Внутрь передается контент, который необходимо отобразить в нем.
package/docs/treeDocs.mdx CHANGED
@@ -3,124 +3,42 @@ import TreeStories from '../src/component/tree/Tree.stories';
3
3
 
4
4
  <Meta of={TreeStories} />
5
5
 
6
- <div class="column gap-24">
7
- <h1>Дерево</h1>
8
- <div class="column">
9
- <p>
10
- Tree (дерево) компонент, использующийся для отображения иерархических структур, представленных расширяемыми
11
- узлами дерева.
12
- </p>
13
- <p>Компонент используется для сущностей, которые имеют ссылки на самих себя.</p>
14
- </div>
15
- <h3>Правила применения</h3>
16
- <div class="column">
17
- <p>
18
- У дерева есть отдельные элементы (TreeItem), которые совмещаются между собой. Каждый элемент имеет свой
19
- уровень.Раскрытие происходит иерархично: 1 уровень раскрывается на 2 уровень, 2 уровень на 3 уровень и т. п.
20
- </p>
21
- </div>
22
- <h3>Как использовать</h3>
23
- <div class="column">
24
- <p>
25
- Для начала нужно создать <code> &lt;teta-tree&gt;</code>. Этот компонент ждет свойство <code>data</code>, оно ждет
26
- объект со свойством <code>children</code>, которое принимает массив таких же данных. Также можно передавать любые
27
- дополнительные свойства, которые необходимы вам для генерации дерева.
28
- </p>
29
- <p>
30
- Внутрь необходимо передать блок <code>ng-template</code> с директивой <code>teta-template</code> для кастомизации
31
- элемента дерева.
32
- </p>
33
- </div>
34
- <h3>Пример кода</h3>
35
- <p>
36
- <pre>
37
- <code>
38
- &lt;teta-tree [data]="data"&gt; &nbsp;&nbsp;&lt;ng-template tetaTemplate let-item&gt;
39
- &nbsp;&nbsp;&nbsp;&nbsp;&lt;teta-icon [name]="item.icon"&gt;&lt;/teta-icon&gt;
40
- &nbsp;&nbsp;&nbsp;&nbsp;&lt;p&gt;&#123;&#123;item.name&#125;&#125;&lt;/p&gt; &nbsp;&nbsp;&lt;/ng-template&gt;
41
- &nbsp;&lt;/teta-tree&gt;
42
- </code>
43
- </pre>
44
- </p>
45
- <h3>Свойства</h3>
46
- <h4>teta-tree</h4>
47
- <table>
48
- <thead>
49
- <tr>
50
- <th>Свойство</th>
51
- <th>Tип</th>
52
- <th>Описание</th>
53
- </tr>
54
- </thead>
55
- <tbody>
56
- <tr>
57
- <td class="text-align-center">
58
- <p>data</p>
59
- </td>
60
- <td class="text-align-center">
61
- <code>ITreeData[]</code>
62
- </td>
63
- <td class="text-align-center">
64
- <p>Данные для формирования дерева</p>
65
- </td>
66
- </tr>
67
- <tr>
68
- <td class="text-align-center">
69
- <p>childNodeName</p>
70
- </td>
71
- <td class="text-align-center">
72
- <code>string</code>
73
- </td>
74
- <td class="text-align-center">
75
- <p>
76
- Свойство, отвечающее за название элемента с дочерними элементами дерева (по дефолту <code>children</code>)
77
- </p>
78
- </td>
79
- </tr>
80
- <tr>
81
- <td class="text-align-center">
82
- <p>height</p>
83
- </td>
84
- <td class="text-align-center">
85
- <code>number</code>
86
- </td>
87
- <td class="text-align-center">
88
- <p>Высота дерева</p>
89
- </td>
90
- </tr>
91
- <tr>
92
- <td class="text-align-center">
93
- <p>openItems</p>
94
- </td>
95
- <td class="text-align-center">
96
- <code>ITreeData[]</code>
97
- </td>
98
- <td class="text-align-center">
99
- <p>Свойство, отвечающее контроль над открытыми элементами дерева</p>
100
- </td>
101
- </tr>
102
- <tr>
103
- <td class="text-align-center">
104
- <p>virtual</p>
105
- </td>
106
- <td class="text-align-center">
107
- <code>boolean</code>
108
- </td>
109
- <td class="text-align-center">
110
- <p>Флаг добавления виртуального скролла</p>
111
- </td>
112
- </tr>
113
- <tr>
114
- <td class="text-align-center">
115
- <p>openItemsChange</p>
116
- </td>
117
- <td class="text-align-center">
118
- <code>function</code>
119
- </td>
120
- <td class="text-align-center">
121
- <p>Переданная функция срабатывает при открытии/закрытии элемента дерева и отдает открытые элементы дерева</p>
122
- </td>
123
- </tr>
124
- </tbody>
125
- </table>
126
- </div>
6
+ # Дерево
7
+
8
+ Tree (дерево) — компонент, использующийся для отображения иерархических структур, представленных расширяемыми узлами дерева.
9
+
10
+ Компонент используется для сущностей, которые имеют ссылки на самих себя.
11
+
12
+ ### Правила применения
13
+
14
+ У дерева есть отдельные элементы (TreeItem), которые совмещаются между собой. Каждый элемент имеет свой уровень. Раскрытие происходит иерархично: 1 уровень раскрывается на 2 уровень, 2 уровень на 3 уровень и т. п.
15
+
16
+ ### Как использовать
17
+
18
+ Для начала нужно создать `<teta-tree>`. Этот компонент ждет свойство `data`, оно ждет объект со свойством `children`, которое принимает массив таких же данных. Также можно передавать любые дополнительные свойства, которые необходимы вам для генерации дерева.
19
+
20
+ Внутрь необходимо передать блок `ng-template` с директивой `teta-template` для кастомизации элемента дерева.
21
+
22
+ ### Пример кода
23
+
24
+ ```
25
+ <teta-tree [data]="data">
26
+ <ng-template tetaTemplate let-item>
27
+ <teta-icon [name]="item.icon"></teta-icon>
28
+ <p>{{ item.name }}</p>
29
+ </ng-template>
30
+ </teta-tree>
31
+ ```
32
+
33
+ ### Свойства
34
+
35
+ #### teta-tree
36
+
37
+ | Свойство | Тип | Описание |
38
+ | --------------- | ------------- | ------------------------------------------------------------------------------------------------------ |
39
+ | data | `ITreeData[]` | Данные для формирования дерева |
40
+ | childNodeName | `string` | Свойство, отвечающее за название элемента с дочерними элементами дерева (по дефолту `children`) |
41
+ | height | `number` | Высота дерева |
42
+ | openItems | `ITreeData[]` | Свойство, отвечающее контроль над открытыми элементами дерева |
43
+ | virtual | `boolean` | Флаг добавления виртуального скролла |
44
+ | openItemsChange | `function` | Переданная функция срабатывает при открытии/закрытии элемента дерева и отдает открытые элементы дерева |