vgapp 1.3.4 → 1.3.5

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.
Files changed (88) hide show
  1. package/app/langs/en/buttons.json +17 -17
  2. package/app/langs/en/messages.json +36 -36
  3. package/app/langs/ru/buttons.json +17 -17
  4. package/app/langs/ru/messages.json +36 -36
  5. package/app/modules/base-module.js +111 -111
  6. package/app/modules/vgalert/js/vgalert.js +52 -52
  7. package/app/modules/vgalert/readme.md +105 -105
  8. package/app/modules/vgdynamictable/index.js +5 -5
  9. package/app/modules/vgdynamictable/js/editable.js +19 -19
  10. package/app/modules/vgdynamictable/js/filters.js +21 -21
  11. package/app/modules/vgdynamictable/js/fixed.js +179 -179
  12. package/app/modules/vgdynamictable/js/pagination.js +1 -1
  13. package/app/modules/vgdynamictable/js/search.js +12 -12
  14. package/app/modules/vgdynamictable/js/sortable.js +71 -71
  15. package/app/modules/vgdynamictable/js/summary-footer.js +28 -28
  16. package/app/modules/vgdynamictable/js/table-remote.js +79 -79
  17. package/app/modules/vgdynamictable/js/table-url-state.js +31 -31
  18. package/app/modules/vgdynamictable/js/utils/common.js +48 -48
  19. package/app/modules/vgdynamictable/js/vgdynamictable.js +268 -268
  20. package/app/modules/vgdynamictable/readme.md +250 -250
  21. package/app/modules/vgdynamictable/scss/_skeleton.scss +6 -6
  22. package/app/modules/vgdynamictable/scss/_sortable.scss +24 -24
  23. package/app/modules/vgdynamictable/scss/_table.scss +4 -4
  24. package/app/modules/vgdynamictable/scss/_variables.scss +79 -79
  25. package/app/modules/vgdynamictable/scss/vgdynamictable.scss +27 -27
  26. package/app/modules/vgfilepreview/js/i18n.js +56 -56
  27. package/app/modules/vgfilepreview/js/renderers/image-modal.js +145 -145
  28. package/app/modules/vgfilepreview/js/renderers/image.js +92 -92
  29. package/app/modules/vgfilepreview/js/renderers/index.js +19 -19
  30. package/app/modules/vgfilepreview/js/renderers/office-modal.js +168 -168
  31. package/app/modules/vgfilepreview/js/renderers/office.js +79 -79
  32. package/app/modules/vgfilepreview/js/renderers/pdf-modal.js +260 -260
  33. package/app/modules/vgfilepreview/js/renderers/pdf.js +76 -76
  34. package/app/modules/vgfilepreview/js/renderers/playlist.js +71 -71
  35. package/app/modules/vgfilepreview/js/renderers/text-modal.js +343 -343
  36. package/app/modules/vgfilepreview/js/renderers/text.js +83 -83
  37. package/app/modules/vgfilepreview/js/renderers/video-modal.js +272 -272
  38. package/app/modules/vgfilepreview/js/renderers/video.js +80 -80
  39. package/app/modules/vgfilepreview/js/renderers/zip-modal.js +522 -522
  40. package/app/modules/vgfilepreview/js/renderers/zip.js +89 -89
  41. package/app/modules/vgfilepreview/js/vgfilepreview.js +7 -7
  42. package/app/modules/vgfilepreview/readme.md +68 -68
  43. package/app/modules/vgfilepreview/scss/_variables.scss +113 -113
  44. package/app/modules/vgfilepreview/scss/vgfilepreview.scss +464 -464
  45. package/app/modules/vgfiles/js/base.js +26 -26
  46. package/app/modules/vgfiles/js/droppable.js +260 -260
  47. package/app/modules/vgfiles/js/render.js +153 -153
  48. package/app/modules/vgfiles/js/vgfiles.js +104 -104
  49. package/app/modules/vgfiles/readme.md +123 -123
  50. package/app/modules/vgfiles/scss/_variables.scss +18 -18
  51. package/app/modules/vgfiles/scss/vgfiles.scss +148 -148
  52. package/app/modules/vgformsender/js/hideshowpass.js +16 -16
  53. package/app/modules/vgformsender/scss/vgformsender.scss +34 -34
  54. package/app/modules/vgmodal/js/vgmodal.drag.js +332 -332
  55. package/app/modules/vgmodal/js/vgmodal.js +188 -188
  56. package/app/modules/vgmodal/js/vgmodal.resize.js +27 -27
  57. package/app/modules/vgmodal/scss/vgmodal.scss +14 -14
  58. package/app/modules/vgnav/js/vgnav.js +135 -135
  59. package/app/modules/vgnav/readme.md +67 -67
  60. package/app/modules/vgnestable/README.md +307 -307
  61. package/app/modules/vgnestable/scss/_variables.scss +60 -60
  62. package/app/modules/vgnestable/scss/vgnestable.scss +163 -163
  63. package/app/modules/vgrangeslider/js/skins.js +222 -222
  64. package/app/modules/vgrangeslider/js/vgrangeslider.js +704 -704
  65. package/app/modules/vgrangeslider/readme.md +523 -523
  66. package/app/modules/vgrangeslider/scss/_variables.scss +53 -53
  67. package/app/modules/vgrangeslider/scss/vgrangeslider.scss +240 -240
  68. package/app/modules/vgselect/js/vgselect.js +39 -39
  69. package/app/modules/vgselect/scss/vgselect.scss +22 -22
  70. package/app/modules/vgspy/readme.md +28 -28
  71. package/app/modules/vgtoast/readme.md +18 -18
  72. package/app/modules/vgtoast/scss/vgtoast.scss +48 -48
  73. package/app/modules/vgtooltip/js/vgtooltip.js +89 -89
  74. package/app/modules/vgtooltip/readme.md +181 -181
  75. package/app/utils/js/components/ajax.js +117 -117
  76. package/app/utils/js/components/audio-metadata.js +240 -240
  77. package/app/utils/js/components/backdrop.js +17 -17
  78. package/app/utils/js/components/file-icon.js +109 -109
  79. package/app/utils/js/components/file-preview.js +304 -304
  80. package/app/utils/js/components/sanitize.js +150 -150
  81. package/app/utils/js/components/video-metadata.js +140 -140
  82. package/app/vgapp.js +46 -46
  83. package/build/vgapp.css +1 -1
  84. package/build/vgapp.css.map +1 -1
  85. package/build/vgapp.js +1 -1
  86. package/build/vgapp.js.map +1 -1
  87. package/index.js +14 -14
  88. package/package.json +3 -2
@@ -1,523 +1,523 @@
1
- # VGRangeSlider
2
-
3
- **VGRangeSlider** — JavaScript-модуль для одиночных и диапазонных слайдеров на нативных `input[type="range"]`. Поддерживает одиночный режим, диапазон с двумя ручками, tooltips, текстовые labels, внешние output-цели, скрытые input-поля для форм и визуальные skin-режимы.
4
-
5
- ---
6
-
7
- ## ✅ Возможности
8
-
9
- - Одиночный слайдер и диапазонный слайдер (`range: true`)
10
- - Инициализация на `input[type="range"]` или на контейнере с `data-vgrangeslider`
11
- - Настройка `min`, `max`, `step`, `start`, `from`, `to`
12
- - Автоматическая нормализация значений по диапазону и шагу
13
- - Tooltips над ручками
14
- - Объединённый tooltip для range-режима, когда ручки сближаются
15
- - Текстовые labels под слайдером
16
- - Вывод значений во внешние DOM-элементы
17
- - Скрытые `input[type="hidden"]` для отправки значений формы
18
- - Скины `default`, `ruler`, `status`
19
- - События `init`, `input`, `change`, `update`
20
- - API для чтения, установки значения, включения и отключения
21
- - Автоинициализация по `DOMContentLoaded`
22
-
23
- ---
24
-
25
- ## 📦 Подключение
26
-
27
- ```js
28
- import VGRangeSlider from "./app/modules/vgrangeslider";
29
- ```
30
-
31
- Или напрямую:
32
-
33
- ```js
34
- import VGRangeSlider from "./app/modules/vgrangeslider/js/vgrangeslider";
35
- ```
36
-
37
- ---
38
-
39
- ## 🧩 Варианты использования
40
-
41
- ### 1. Одиночный слайдер на `input[type="range"]`
42
-
43
- ```html
44
- <input
45
- type="range"
46
- name="price"
47
- min="0"
48
- max="100"
49
- step="5"
50
- value="35"
51
- data-vgrangeslider
52
- >
53
- ```
54
-
55
- Модуль использует атрибуты самого input:
56
- - `min`
57
- - `max`
58
- - `step`
59
- - `value`
60
- - `name`
61
- - `disabled`
62
-
63
- ### 2. Диапазонный слайдер на контейнере
64
-
65
- ```html
66
- <div
67
- data-vgrangeslider
68
- data-range="true"
69
- data-min="0"
70
- data-max="100"
71
- data-start='[20,80]'
72
- data-input='{"min":"#price-min","max":"#price-max"}'
73
- data-output='{"target":"#price-result","min":"#price-from","max":"#price-to"}'
74
- ></div>
75
-
76
- <input type="hidden" id="price-min" name="price_min">
77
- <input type="hidden" id="price-max" name="price_max">
78
-
79
- <div id="price-result"></div>
80
- <div id="price-from"></div>
81
- <div id="price-to"></div>
82
- ```
83
-
84
- Если hidden inputs не найдены по селекторам, модуль создаст их сам внутри контейнера.
85
-
86
- ---
87
-
88
- ## ⚙️ Инициализация
89
-
90
- ### Автоинициализация
91
-
92
- Модуль автоматически инициализирует все элементы с `data-vgrangeslider` после `DOMContentLoaded`.
93
-
94
- ### Ручная инициализация
95
-
96
- ```js
97
- const element = document.querySelector('[data-vgrangeslider]');
98
- const slider = VGRangeSlider.init(element, {
99
- range: true,
100
- min: 0,
101
- max: 500,
102
- step: 10,
103
- start: [100, 300]
104
- });
105
- ```
106
-
107
- Или:
108
-
109
- ```js
110
- const slider = new VGRangeSlider(element, {
111
- range: true,
112
- min: 0,
113
- max: 500,
114
- step: 10,
115
- start: [100, 300]
116
- });
117
- ```
118
-
119
- ---
120
-
121
- ## 🛠 Параметры
122
-
123
- ```js
124
- {
125
- range: false,
126
- min: 0,
127
- max: 100,
128
- step: 1,
129
- start: null,
130
- connect: true,
131
- tooltips: true,
132
- labels: true,
133
- separator: " - ",
134
- suffix: "",
135
- prefix: "",
136
- labelWords: null,
137
- skin: "default",
138
- ruler: {
139
- count: 6,
140
- labels: true,
141
- values: null,
142
- dimInactive: false
143
- },
144
- status: {
145
- warningBelow: 60,
146
- dangerBelow: 30,
147
- by: "to"
148
- },
149
- name: {
150
- min: "",
151
- max: ""
152
- },
153
- input: {
154
- min: null,
155
- max: null
156
- },
157
- output: {
158
- target: null,
159
- min: null,
160
- max: null
161
- },
162
- disabled: false,
163
- onInit: null,
164
- onInput: null,
165
- onChange: null,
166
- onUpdate: null,
167
- formatValue: null
168
- }
169
- ```
170
-
171
- ### Основные параметры
172
-
173
- | Параметр | Тип | Описание |
174
- |---|---|---|
175
- | `range` | `boolean` | Включает режим диапазона с двумя ручками |
176
- | `min` | `number` | Минимальное значение |
177
- | `max` | `number` | Максимальное значение |
178
- | `step` | `number` | Шаг изменения |
179
- | `start` | `number \| number[]` | Стартовое значение или `[from, to]` |
180
- | `from` / `to` | `number` | Альтернатива `start` для range-режима |
181
- | `disabled` | `boolean` | Блокирует управление |
182
-
183
- ### Отображение
184
-
185
- | Параметр | Тип | Описание |
186
- |---|---|---|
187
- | `tooltips` | `boolean` | Показывает tooltip’ы |
188
- | `labels` | `boolean` | Показывает текстовые labels |
189
- | `separator` | `string` | Разделитель между значениями диапазона |
190
- | `prefix` | `string` | Префикс для вывода значения |
191
- | `suffix` | `string` | Суффикс для вывода значения |
192
- | `formatValue` | `function` | Кастомный форматтер значения |
193
-
194
- ### Интеграция с формой и DOM
195
-
196
- | Параметр | Тип | Описание |
197
- |---|---|---|
198
- | `name.min` | `string` | Имя hidden input для нижней границы |
199
- | `name.max` | `string` | Имя hidden input для верхней границы |
200
- | `input.min` | `string` | CSS-селектор существующего hidden input |
201
- | `input.max` | `string` | CSS-селектор существующего hidden input |
202
- | `output.target` | `string` | Селектор общего output-элемента |
203
- | `output.min` | `string` | Селектор output для нижней границы |
204
- | `output.max` | `string` | Селектор output для верхней границы |
205
-
206
- ### Колбэки
207
-
208
- | Параметр | Тип | Описание |
209
- |---|---|---|
210
- | `onInit` | `function` | Вызывается после инициализации |
211
- | `onInput` | `function` | Вызывается на `input` |
212
- | `onChange` | `function` | Вызывается на `change` |
213
- | `onUpdate` | `function` | Вызывается после `setValue()` |
214
-
215
- ---
216
-
217
- ## 🎨 Скины
218
-
219
- ### `default`
220
-
221
- Базовый режим с track, fill, thumb, labels и tooltip’ами.
222
-
223
- ```js
224
- new VGRangeSlider(element, {
225
- skin: "default"
226
- });
227
- ```
228
-
229
- ### `ruler`
230
-
231
- Добавляет шкалу отметок под слайдером.
232
-
233
- ```js
234
- new VGRangeSlider(element, {
235
- range: true,
236
- skin: "ruler",
237
- ruler: {
238
- count: 5,
239
- labels: true,
240
- dimInactive: true
241
- }
242
- });
243
- ```
244
-
245
- Поддерживает:
246
- - `ruler.count` — количество отметок, если `values` не заданы
247
- - `ruler.values` — явный массив значений шкалы
248
- - `ruler.labels` — показывать подписи значений
249
- - `ruler.dimInactive` — приглушать неактивные отметки
250
-
251
- ### `status`
252
-
253
- Окрашивает слайдер по порогам `success / warning / danger`.
254
-
255
- ```js
256
- new VGRangeSlider(element, {
257
- range: true,
258
- skin: "status",
259
- status: {
260
- warningBelow: 60,
261
- dangerBelow: 30,
262
- by: "avg"
263
- },
264
- labelWords: ["Низкий", "Средний", "Высокий"]
265
- });
266
- ```
267
-
268
- Поддерживает:
269
- - `status.warningBelow`
270
- - `status.dangerBelow`
271
- - `status.by: "from" | "to" | "avg"`
272
- - `labelWords: [danger, warning, success]`
273
-
274
- ---
275
-
276
- ## 🧪 Форматирование значений
277
-
278
- ### Через `prefix` и `suffix`
279
-
280
- ```js
281
- new VGRangeSlider(element, {
282
- start: 50,
283
- prefix: "от ",
284
- suffix: " ₽"
285
- });
286
- ```
287
-
288
- ### Через `formatValue`
289
-
290
- ```js
291
- new VGRangeSlider(element, {
292
- range: true,
293
- start: [1500, 4500],
294
- formatValue(value) {
295
- return `${value.toLocaleString("ru-RU")} ₽`;
296
- }
297
- });
298
- ```
299
-
300
- ---
301
-
302
- ## 📤 Вывод значений во внешние элементы
303
-
304
- ```html
305
- <div id="price-slider"></div>
306
-
307
- <div>
308
- <span id="price-result"></span>
309
- <span id="price-from"></span>
310
- <span id="price-to"></span>
311
- </div>
312
- ```
313
-
314
- ```js
315
- new VGRangeSlider(document.getElementById("price-slider"), {
316
- range: true,
317
- min: 0,
318
- max: 10000,
319
- start: [2000, 8000],
320
- output: {
321
- target: "#price-result",
322
- min: "#price-from",
323
- max: "#price-to"
324
- },
325
- formatValue(value) {
326
- return `${value} ₽`;
327
- }
328
- });
329
- ```
330
-
331
- Модуль синхронизирует:
332
- - `output.target` → `2000 ₽ - 8000 ₽`
333
- - `output.min` → `2000 ₽`
334
- - `output.max` → `8000 ₽`
335
-
336
- ---
337
-
338
- ## 🧾 Hidden inputs для форм
339
-
340
- ```html
341
- <div id="filter-price"></div>
342
- <input type="hidden" id="filter-price-min" name="price_min">
343
- <input type="hidden" id="filter-price-max" name="price_max">
344
- ```
345
-
346
- ```js
347
- new VGRangeSlider(document.getElementById("filter-price"), {
348
- range: true,
349
- min: 0,
350
- max: 1000,
351
- start: [100, 700],
352
- input: {
353
- min: "#filter-price-min",
354
- max: "#filter-price-max"
355
- }
356
- });
357
- ```
358
-
359
- Если селекторы не указаны, можно передать только `name`:
360
-
361
- ```js
362
- new VGRangeSlider(element, {
363
- range: true,
364
- name: {
365
- min: "price_min",
366
- max: "price_max"
367
- }
368
- });
369
- ```
370
-
371
- Тогда hidden inputs будут созданы автоматически.
372
-
373
- ---
374
-
375
- ## 🔔 События
376
-
377
- Модуль генерирует события на исходном элементе:
378
-
379
- | Событие | Когда вызывается |
380
- |---|---|
381
- | `vg.rangeslider.init` | После инициализации |
382
- | `vg.rangeslider.input` | При движении ручки |
383
- | `vg.rangeslider.change` | После завершения изменения |
384
- | `vg.rangeslider.update` | После `setValue()` |
385
-
386
- ### Пример подписки
387
-
388
- ```js
389
- const element = document.querySelector('[data-vgrangeslider]');
390
-
391
- element.addEventListener('vg.rangeslider.input', (event) => {
392
- console.log(event.detail.value);
393
- console.log(event.detail.from);
394
- console.log(event.detail.to);
395
- console.log(event.detail.status);
396
- });
397
- ```
398
-
399
- ### `event.detail`
400
-
401
- ```js
402
- {
403
- value,
404
- from,
405
- to,
406
- min,
407
- max,
408
- step,
409
- status,
410
- instance
411
- }
412
- ```
413
-
414
- `status` содержит:
415
-
416
- ```js
417
- {
418
- by,
419
- sourceValue,
420
- percent,
421
- tone,
422
- label,
423
- from: {
424
- value,
425
- percent,
426
- tone,
427
- label
428
- },
429
- to: {
430
- value,
431
- percent,
432
- tone,
433
- label
434
- }
435
- }
436
- ```
437
-
438
- ---
439
-
440
- ## 🧠 Публичный API
441
-
442
- ### `getValue()`
443
-
444
- Возвращает:
445
- - `number` для одиночного режима
446
- - `[from, to]` для диапазона
447
-
448
- ```js
449
- slider.getValue();
450
- ```
451
-
452
- ### `setValue(value, options?)`
453
-
454
- ```js
455
- slider.setValue(45);
456
-
457
- slider.setValue([100, 300], {
458
- silent: false,
459
- emit: "update"
460
- });
461
- ```
462
-
463
- Опции:
464
- - `silent` — не генерировать событие
465
- - `emit: "update" | "change"` — какое событие сгенерировать после установки
466
-
467
- ### `enable()`
468
-
469
- ```js
470
- slider.enable();
471
- ```
472
-
473
- ### `disable()`
474
-
475
- ```js
476
- slider.disable();
477
- ```
478
-
479
- ### `dispose()`
480
-
481
- ```js
482
- slider.dispose();
483
- ```
484
-
485
- Удаляет обработчики событий и освобождает экземпляр.
486
-
487
- ---
488
-
489
- ## 📝 Поведение и ограничения
490
-
491
- - Если модуль инициализирован на `input[type="range"]`, режим диапазона не используется
492
- - В range-режиме модуль не допускает пересечения ручек: `from` всегда меньше или равен `to`
493
- - Любое значение приводится к допустимому диапазону и округляется по `step`
494
- - Параметр `connect` сейчас присутствует в конфиге, но отдельной логики переключения fill не имеет — fill рисуется всегда
495
- - Для корректного внешнего вывода селекторы в `input` и `output` должны существовать в DOM к моменту инициализации
496
-
497
- ---
498
-
499
- ## 🎨 Стилизация
500
-
501
- Основные стили находятся в:
502
-
503
- - `app/modules/vgrangeslider/scss/vgrangeslider.scss`
504
- - `app/modules/vgrangeslider/scss/_variables.scss`
505
-
506
- Модуль использует CSS custom properties для:
507
- - размеров track и thumb
508
- - цветов track, fill, tooltip
509
- - параметров ruler
510
- - z-index слоёв
511
-
512
- ---
513
-
514
- ## 📎 См. также
515
-
516
- - `app/modules/vgrangeslider/js/vgrangeslider.js`
517
- - `app/modules/vgrangeslider/js/skins.js`
518
- - `app/modules/vgrangeslider/scss/vgrangeslider.scss`
519
-
520
- ---
521
-
522
- > Автор: VEGAS STUDIO (vegas-dev.com)
523
- > Поддерживается в проектах VEGAS
1
+ # VGRangeSlider
2
+
3
+ **VGRangeSlider** — JavaScript-модуль для одиночных и диапазонных слайдеров на нативных `input[type="range"]`. Поддерживает одиночный режим, диапазон с двумя ручками, tooltips, текстовые labels, внешние output-цели, скрытые input-поля для форм и визуальные skin-режимы.
4
+
5
+ ---
6
+
7
+ ## ✅ Возможности
8
+
9
+ - Одиночный слайдер и диапазонный слайдер (`range: true`)
10
+ - Инициализация на `input[type="range"]` или на контейнере с `data-vgrangeslider`
11
+ - Настройка `min`, `max`, `step`, `start`, `from`, `to`
12
+ - Автоматическая нормализация значений по диапазону и шагу
13
+ - Tooltips над ручками
14
+ - Объединённый tooltip для range-режима, когда ручки сближаются
15
+ - Текстовые labels под слайдером
16
+ - Вывод значений во внешние DOM-элементы
17
+ - Скрытые `input[type="hidden"]` для отправки значений формы
18
+ - Скины `default`, `ruler`, `status`
19
+ - События `init`, `input`, `change`, `update`
20
+ - API для чтения, установки значения, включения и отключения
21
+ - Автоинициализация по `DOMContentLoaded`
22
+
23
+ ---
24
+
25
+ ## 📦 Подключение
26
+
27
+ ```js
28
+ import VGRangeSlider from "./app/modules/vgrangeslider";
29
+ ```
30
+
31
+ Или напрямую:
32
+
33
+ ```js
34
+ import VGRangeSlider from "./app/modules/vgrangeslider/js/vgrangeslider";
35
+ ```
36
+
37
+ ---
38
+
39
+ ## 🧩 Варианты использования
40
+
41
+ ### 1. Одиночный слайдер на `input[type="range"]`
42
+
43
+ ```html
44
+ <input
45
+ type="range"
46
+ name="price"
47
+ min="0"
48
+ max="100"
49
+ step="5"
50
+ value="35"
51
+ data-vgrangeslider
52
+ >
53
+ ```
54
+
55
+ Модуль использует атрибуты самого input:
56
+ - `min`
57
+ - `max`
58
+ - `step`
59
+ - `value`
60
+ - `name`
61
+ - `disabled`
62
+
63
+ ### 2. Диапазонный слайдер на контейнере
64
+
65
+ ```html
66
+ <div
67
+ data-vgrangeslider
68
+ data-range="true"
69
+ data-min="0"
70
+ data-max="100"
71
+ data-start='[20,80]'
72
+ data-input='{"min":"#price-min","max":"#price-max"}'
73
+ data-output='{"target":"#price-result","min":"#price-from","max":"#price-to"}'
74
+ ></div>
75
+
76
+ <input type="hidden" id="price-min" name="price_min">
77
+ <input type="hidden" id="price-max" name="price_max">
78
+
79
+ <div id="price-result"></div>
80
+ <div id="price-from"></div>
81
+ <div id="price-to"></div>
82
+ ```
83
+
84
+ Если hidden inputs не найдены по селекторам, модуль создаст их сам внутри контейнера.
85
+
86
+ ---
87
+
88
+ ## ⚙️ Инициализация
89
+
90
+ ### Автоинициализация
91
+
92
+ Модуль автоматически инициализирует все элементы с `data-vgrangeslider` после `DOMContentLoaded`.
93
+
94
+ ### Ручная инициализация
95
+
96
+ ```js
97
+ const element = document.querySelector('[data-vgrangeslider]');
98
+ const slider = VGRangeSlider.init(element, {
99
+ range: true,
100
+ min: 0,
101
+ max: 500,
102
+ step: 10,
103
+ start: [100, 300]
104
+ });
105
+ ```
106
+
107
+ Или:
108
+
109
+ ```js
110
+ const slider = new VGRangeSlider(element, {
111
+ range: true,
112
+ min: 0,
113
+ max: 500,
114
+ step: 10,
115
+ start: [100, 300]
116
+ });
117
+ ```
118
+
119
+ ---
120
+
121
+ ## 🛠 Параметры
122
+
123
+ ```js
124
+ {
125
+ range: false,
126
+ min: 0,
127
+ max: 100,
128
+ step: 1,
129
+ start: null,
130
+ connect: true,
131
+ tooltips: true,
132
+ labels: true,
133
+ separator: " - ",
134
+ suffix: "",
135
+ prefix: "",
136
+ labelWords: null,
137
+ skin: "default",
138
+ ruler: {
139
+ count: 6,
140
+ labels: true,
141
+ values: null,
142
+ dimInactive: false
143
+ },
144
+ status: {
145
+ warningBelow: 60,
146
+ dangerBelow: 30,
147
+ by: "to"
148
+ },
149
+ name: {
150
+ min: "",
151
+ max: ""
152
+ },
153
+ input: {
154
+ min: null,
155
+ max: null
156
+ },
157
+ output: {
158
+ target: null,
159
+ min: null,
160
+ max: null
161
+ },
162
+ disabled: false,
163
+ onInit: null,
164
+ onInput: null,
165
+ onChange: null,
166
+ onUpdate: null,
167
+ formatValue: null
168
+ }
169
+ ```
170
+
171
+ ### Основные параметры
172
+
173
+ | Параметр | Тип | Описание |
174
+ |---|---|---|
175
+ | `range` | `boolean` | Включает режим диапазона с двумя ручками |
176
+ | `min` | `number` | Минимальное значение |
177
+ | `max` | `number` | Максимальное значение |
178
+ | `step` | `number` | Шаг изменения |
179
+ | `start` | `number \| number[]` | Стартовое значение или `[from, to]` |
180
+ | `from` / `to` | `number` | Альтернатива `start` для range-режима |
181
+ | `disabled` | `boolean` | Блокирует управление |
182
+
183
+ ### Отображение
184
+
185
+ | Параметр | Тип | Описание |
186
+ |---|---|---|
187
+ | `tooltips` | `boolean` | Показывает tooltip’ы |
188
+ | `labels` | `boolean` | Показывает текстовые labels |
189
+ | `separator` | `string` | Разделитель между значениями диапазона |
190
+ | `prefix` | `string` | Префикс для вывода значения |
191
+ | `suffix` | `string` | Суффикс для вывода значения |
192
+ | `formatValue` | `function` | Кастомный форматтер значения |
193
+
194
+ ### Интеграция с формой и DOM
195
+
196
+ | Параметр | Тип | Описание |
197
+ |---|---|---|
198
+ | `name.min` | `string` | Имя hidden input для нижней границы |
199
+ | `name.max` | `string` | Имя hidden input для верхней границы |
200
+ | `input.min` | `string` | CSS-селектор существующего hidden input |
201
+ | `input.max` | `string` | CSS-селектор существующего hidden input |
202
+ | `output.target` | `string` | Селектор общего output-элемента |
203
+ | `output.min` | `string` | Селектор output для нижней границы |
204
+ | `output.max` | `string` | Селектор output для верхней границы |
205
+
206
+ ### Колбэки
207
+
208
+ | Параметр | Тип | Описание |
209
+ |---|---|---|
210
+ | `onInit` | `function` | Вызывается после инициализации |
211
+ | `onInput` | `function` | Вызывается на `input` |
212
+ | `onChange` | `function` | Вызывается на `change` |
213
+ | `onUpdate` | `function` | Вызывается после `setValue()` |
214
+
215
+ ---
216
+
217
+ ## 🎨 Скины
218
+
219
+ ### `default`
220
+
221
+ Базовый режим с track, fill, thumb, labels и tooltip’ами.
222
+
223
+ ```js
224
+ new VGRangeSlider(element, {
225
+ skin: "default"
226
+ });
227
+ ```
228
+
229
+ ### `ruler`
230
+
231
+ Добавляет шкалу отметок под слайдером.
232
+
233
+ ```js
234
+ new VGRangeSlider(element, {
235
+ range: true,
236
+ skin: "ruler",
237
+ ruler: {
238
+ count: 5,
239
+ labels: true,
240
+ dimInactive: true
241
+ }
242
+ });
243
+ ```
244
+
245
+ Поддерживает:
246
+ - `ruler.count` — количество отметок, если `values` не заданы
247
+ - `ruler.values` — явный массив значений шкалы
248
+ - `ruler.labels` — показывать подписи значений
249
+ - `ruler.dimInactive` — приглушать неактивные отметки
250
+
251
+ ### `status`
252
+
253
+ Окрашивает слайдер по порогам `success / warning / danger`.
254
+
255
+ ```js
256
+ new VGRangeSlider(element, {
257
+ range: true,
258
+ skin: "status",
259
+ status: {
260
+ warningBelow: 60,
261
+ dangerBelow: 30,
262
+ by: "avg"
263
+ },
264
+ labelWords: ["Низкий", "Средний", "Высокий"]
265
+ });
266
+ ```
267
+
268
+ Поддерживает:
269
+ - `status.warningBelow`
270
+ - `status.dangerBelow`
271
+ - `status.by: "from" | "to" | "avg"`
272
+ - `labelWords: [danger, warning, success]`
273
+
274
+ ---
275
+
276
+ ## 🧪 Форматирование значений
277
+
278
+ ### Через `prefix` и `suffix`
279
+
280
+ ```js
281
+ new VGRangeSlider(element, {
282
+ start: 50,
283
+ prefix: "от ",
284
+ suffix: " ₽"
285
+ });
286
+ ```
287
+
288
+ ### Через `formatValue`
289
+
290
+ ```js
291
+ new VGRangeSlider(element, {
292
+ range: true,
293
+ start: [1500, 4500],
294
+ formatValue(value) {
295
+ return `${value.toLocaleString("ru-RU")} ₽`;
296
+ }
297
+ });
298
+ ```
299
+
300
+ ---
301
+
302
+ ## 📤 Вывод значений во внешние элементы
303
+
304
+ ```html
305
+ <div id="price-slider"></div>
306
+
307
+ <div>
308
+ <span id="price-result"></span>
309
+ <span id="price-from"></span>
310
+ <span id="price-to"></span>
311
+ </div>
312
+ ```
313
+
314
+ ```js
315
+ new VGRangeSlider(document.getElementById("price-slider"), {
316
+ range: true,
317
+ min: 0,
318
+ max: 10000,
319
+ start: [2000, 8000],
320
+ output: {
321
+ target: "#price-result",
322
+ min: "#price-from",
323
+ max: "#price-to"
324
+ },
325
+ formatValue(value) {
326
+ return `${value} ₽`;
327
+ }
328
+ });
329
+ ```
330
+
331
+ Модуль синхронизирует:
332
+ - `output.target` → `2000 ₽ - 8000 ₽`
333
+ - `output.min` → `2000 ₽`
334
+ - `output.max` → `8000 ₽`
335
+
336
+ ---
337
+
338
+ ## 🧾 Hidden inputs для форм
339
+
340
+ ```html
341
+ <div id="filter-price"></div>
342
+ <input type="hidden" id="filter-price-min" name="price_min">
343
+ <input type="hidden" id="filter-price-max" name="price_max">
344
+ ```
345
+
346
+ ```js
347
+ new VGRangeSlider(document.getElementById("filter-price"), {
348
+ range: true,
349
+ min: 0,
350
+ max: 1000,
351
+ start: [100, 700],
352
+ input: {
353
+ min: "#filter-price-min",
354
+ max: "#filter-price-max"
355
+ }
356
+ });
357
+ ```
358
+
359
+ Если селекторы не указаны, можно передать только `name`:
360
+
361
+ ```js
362
+ new VGRangeSlider(element, {
363
+ range: true,
364
+ name: {
365
+ min: "price_min",
366
+ max: "price_max"
367
+ }
368
+ });
369
+ ```
370
+
371
+ Тогда hidden inputs будут созданы автоматически.
372
+
373
+ ---
374
+
375
+ ## 🔔 События
376
+
377
+ Модуль генерирует события на исходном элементе:
378
+
379
+ | Событие | Когда вызывается |
380
+ |---|---|
381
+ | `vg.rangeslider.init` | После инициализации |
382
+ | `vg.rangeslider.input` | При движении ручки |
383
+ | `vg.rangeslider.change` | После завершения изменения |
384
+ | `vg.rangeslider.update` | После `setValue()` |
385
+
386
+ ### Пример подписки
387
+
388
+ ```js
389
+ const element = document.querySelector('[data-vgrangeslider]');
390
+
391
+ element.addEventListener('vg.rangeslider.input', (event) => {
392
+ console.log(event.detail.value);
393
+ console.log(event.detail.from);
394
+ console.log(event.detail.to);
395
+ console.log(event.detail.status);
396
+ });
397
+ ```
398
+
399
+ ### `event.detail`
400
+
401
+ ```js
402
+ {
403
+ value,
404
+ from,
405
+ to,
406
+ min,
407
+ max,
408
+ step,
409
+ status,
410
+ instance
411
+ }
412
+ ```
413
+
414
+ `status` содержит:
415
+
416
+ ```js
417
+ {
418
+ by,
419
+ sourceValue,
420
+ percent,
421
+ tone,
422
+ label,
423
+ from: {
424
+ value,
425
+ percent,
426
+ tone,
427
+ label
428
+ },
429
+ to: {
430
+ value,
431
+ percent,
432
+ tone,
433
+ label
434
+ }
435
+ }
436
+ ```
437
+
438
+ ---
439
+
440
+ ## 🧠 Публичный API
441
+
442
+ ### `getValue()`
443
+
444
+ Возвращает:
445
+ - `number` для одиночного режима
446
+ - `[from, to]` для диапазона
447
+
448
+ ```js
449
+ slider.getValue();
450
+ ```
451
+
452
+ ### `setValue(value, options?)`
453
+
454
+ ```js
455
+ slider.setValue(45);
456
+
457
+ slider.setValue([100, 300], {
458
+ silent: false,
459
+ emit: "update"
460
+ });
461
+ ```
462
+
463
+ Опции:
464
+ - `silent` — не генерировать событие
465
+ - `emit: "update" | "change"` — какое событие сгенерировать после установки
466
+
467
+ ### `enable()`
468
+
469
+ ```js
470
+ slider.enable();
471
+ ```
472
+
473
+ ### `disable()`
474
+
475
+ ```js
476
+ slider.disable();
477
+ ```
478
+
479
+ ### `dispose()`
480
+
481
+ ```js
482
+ slider.dispose();
483
+ ```
484
+
485
+ Удаляет обработчики событий и освобождает экземпляр.
486
+
487
+ ---
488
+
489
+ ## 📝 Поведение и ограничения
490
+
491
+ - Если модуль инициализирован на `input[type="range"]`, режим диапазона не используется
492
+ - В range-режиме модуль не допускает пересечения ручек: `from` всегда меньше или равен `to`
493
+ - Любое значение приводится к допустимому диапазону и округляется по `step`
494
+ - Параметр `connect` сейчас присутствует в конфиге, но отдельной логики переключения fill не имеет — fill рисуется всегда
495
+ - Для корректного внешнего вывода селекторы в `input` и `output` должны существовать в DOM к моменту инициализации
496
+
497
+ ---
498
+
499
+ ## 🎨 Стилизация
500
+
501
+ Основные стили находятся в:
502
+
503
+ - `app/modules/vgrangeslider/scss/vgrangeslider.scss`
504
+ - `app/modules/vgrangeslider/scss/_variables.scss`
505
+
506
+ Модуль использует CSS custom properties для:
507
+ - размеров track и thumb
508
+ - цветов track, fill, tooltip
509
+ - параметров ruler
510
+ - z-index слоёв
511
+
512
+ ---
513
+
514
+ ## 📎 См. также
515
+
516
+ - `app/modules/vgrangeslider/js/vgrangeslider.js`
517
+ - `app/modules/vgrangeslider/js/skins.js`
518
+ - `app/modules/vgrangeslider/scss/vgrangeslider.scss`
519
+
520
+ ---
521
+
522
+ > Автор: VEGAS STUDIO (vegas-dev.com)
523
+ > Поддерживается в проектах VEGAS