@cat-of-summer/st-script 1.4.2 → 1.5.0
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.
- package/README.md +1 -1
- package/dist/shape.esm.min.js +2 -0
- package/dist/{cut.esm.min.js.map → shape.esm.min.js.map} +4 -4
- package/dist/shape.min.js +2 -0
- package/dist/shape.min.js.map +7 -0
- package/docs/README.md +36 -0
- package/docs/src/README.md +29 -0
- package/docs/src/_traits/README.md +8 -0
- package/docs/src/_traits/hasInstanceSymbol.js.md +57 -0
- package/docs/src/app/README.md +13 -0
- package/docs/src/app/datepicker/README.md +9 -0
- package/docs/src/app/datepicker/_calendar.js.md +1 -0
- package/docs/src/app/datepicker/index.js.md +153 -0
- package/docs/src/app/form/README.md +8 -0
- package/docs/src/app/form/index.js.md +560 -0
- package/docs/src/app/index.js.md +1302 -0
- package/docs/src/cookie/README.md +8 -0
- package/docs/src/cookie/index.js.md +80 -0
- package/docs/src/core/README.md +8 -0
- package/docs/src/core/index.js.md +178 -0
- package/docs/src/index.js.md +1 -0
- package/docs/src/loader/README.md +8 -0
- package/docs/src/loader/index.js.md +125 -0
- package/docs/src/mask/README.md +10 -0
- package/docs/src/mask/_engine.js.md +1 -0
- package/docs/src/mask/_groups.js.md +1 -0
- package/docs/src/mask/index.js.md +411 -0
- package/docs/src/modal/README.md +8 -0
- package/docs/src/modal/index.js.md +809 -0
- package/docs/src/observer/README.md +9 -0
- package/docs/src/observer/_engine.js.md +28 -0
- package/docs/src/observer/index.js.md +259 -0
- package/docs/src/route/README.md +8 -0
- package/docs/src/route/index.js.md +385 -0
- package/docs/src/select/README.md +8 -0
- package/docs/src/select/index.js.md +115 -0
- package/docs/src/shape/README.md +9 -0
- package/docs/src/shape/_engine.js.md +1 -0
- package/docs/src/shape/index.js.md +98 -0
- package/docs/src/st_button_widget/README.md +9 -0
- package/docs/src/st_button_widget/README.txt.md +4 -0
- package/docs/src/st_button_widget/index.js.md +68 -0
- package/docs/src/st_links_widget/README.md +9 -0
- package/docs/src/st_links_widget/README.txt.md +4 -0
- package/docs/src/st_links_widget/index.js.md +46 -0
- package/docs/src/st_widget/README.md +8 -0
- package/docs/src/st_widget/button/README.md +4 -0
- package/docs/src/toggle/README.md +8 -0
- package/docs/src/toggle/index.js.md +572 -0
- package/docs/src/typograf/README.md +9 -0
- package/docs/src/typograf/_engine.js.md +75 -0
- package/docs/src/typograf/index.js.md +165 -0
- package/docs/src/uploader/README.md +8 -0
- package/docs/src/uploader/index.js.md +112 -0
- package/docs/src/validator/README.md +8 -0
- package/docs/src/validator/index.js.md +113 -0
- package/package.json +3 -2
- package/src/index.js +1 -1
- package/src/{cut → shape}/_engine.js +1 -1
- package/src/{cut → shape}/index.js +10 -10
- package/dist/cut.esm.min.js +0 -2
- package/dist/cut.min.js +0 -2
- package/dist/cut.min.js.map +0 -7
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
# cookie
|
|
2
|
+
|
|
3
|
+
## Описание
|
|
4
|
+
|
|
5
|
+
Статический утилитарный класс для управления cookie через `document.cookie`. Поддерживает автоматическую сериализацию/десериализацию JSON, колбэки при первой установке и готовый баннер согласия на обработку данных.
|
|
6
|
+
|
|
7
|
+
## Публичные методы
|
|
8
|
+
|
|
9
|
+
### `Cookie.set(name, value, params?)`
|
|
10
|
+
|
|
11
|
+
Устанавливает cookie. Значения, которые не являются строкой (объекты, массивы, числа, `true`/`false`, `null`), записываются через `JSON.stringify`, поэтому `get` возвращает их в исходном виде. Строки записываются как есть, чтобы сервер мог читать их без разбора JSON.
|
|
12
|
+
|
|
13
|
+
> [!warning] Строки, похожие на JSON
|
|
14
|
+
> `get` пробует разобрать любое значение как JSON. Строка `'123'` прочитается числом `123`, строка `'true'` — значением `true`. Если важен именно строковый тип, приводите результат `get` сами.
|
|
15
|
+
|
|
16
|
+
| Параметр | По умолчанию | Описание |
|
|
17
|
+
|---|---|---|
|
|
18
|
+
| `params.expires` | `3600` | Время жизни в секундах, строка даты или объект `Date`. `Infinity` — «бессрочно»: 400 дней, это максимум, который сохраняет Chrome. |
|
|
19
|
+
| `params.path` | `'/'` | Путь |
|
|
20
|
+
| `params.domain` | — | Домен |
|
|
21
|
+
| `params.secure` | — | Флаг `Secure` |
|
|
22
|
+
| `params.sameSite` | — | `'Strict'` / `'Lax'` / `'None'` |
|
|
23
|
+
|
|
24
|
+
### `Cookie.get(name)`
|
|
25
|
+
|
|
26
|
+
Возвращает значение cookie (автоматический `JSON.parse`) или `null`.
|
|
27
|
+
|
|
28
|
+
### `Cookie.delete(name, params?)`
|
|
29
|
+
|
|
30
|
+
Удаляет cookie (устанавливает `expires: 0`).
|
|
31
|
+
|
|
32
|
+
### `Cookie.callback(name, callback, params?)`
|
|
33
|
+
|
|
34
|
+
Если cookie с именем `name` отсутствует — устанавливает её и вызывает `callback(name)` с задержкой `params.delay` секунд. При `params.interval > 0` проверяет повторно.
|
|
35
|
+
|
|
36
|
+
| Параметр | По умолчанию | Описание |
|
|
37
|
+
|---|---|---|
|
|
38
|
+
| `params.interval` | `0` | Интервал повторной проверки (сек), `0` = однократно |
|
|
39
|
+
| `params.delay` | `0` | Задержка вызова callback (сек) |
|
|
40
|
+
| `params.value` | `true` | Значение устанавливаемой cookie |
|
|
41
|
+
|
|
42
|
+
### `Cookie.consent(params?)`
|
|
43
|
+
|
|
44
|
+
Отображает баннер согласия с cookie. Показывается один раз — при отсутствии cookie `params.name`. Кнопки с атрибутом `action="accept"` / `action="decline"` управляют закрытием и записывают результат в cookie.
|
|
45
|
+
|
|
46
|
+
| Параметр | По умолчанию | Описание |
|
|
47
|
+
|---|---|---|
|
|
48
|
+
| `params.content` | HTML строка | HTML баннера или CSS-селектор существующего элемента |
|
|
49
|
+
| `params.container` | `'body'` | Контейнер для вставки (`'body'` — позиционируется абсолютно) |
|
|
50
|
+
| `params.location` | `'bottom'` | Позиция: `'top'`, `'bottom'`, `'center'`, `'left'`, `'right'` |
|
|
51
|
+
| `params.zIndex` | `1000` | z-index |
|
|
52
|
+
| `params.name` | `'cookie_consent'` | Имя cookie |
|
|
53
|
+
| `params.interval` | `5` | Интервал проверки (сек) |
|
|
54
|
+
|
|
55
|
+
## Примеры
|
|
56
|
+
|
|
57
|
+
```js
|
|
58
|
+
// Установка на 1 день
|
|
59
|
+
Cookie.set('user', { id: 42, name: 'Иван' }, { expires: 86400 });
|
|
60
|
+
|
|
61
|
+
// «Бессрочно» (400 дней)
|
|
62
|
+
Cookie.set('theme', 'dark', { expires: Infinity });
|
|
63
|
+
|
|
64
|
+
// Чтение
|
|
65
|
+
const user = Cookie.get('user'); // { id: 42, name: 'Иван' }
|
|
66
|
+
|
|
67
|
+
// Удаление
|
|
68
|
+
Cookie.delete('user');
|
|
69
|
+
|
|
70
|
+
// callback при первом посещении
|
|
71
|
+
Cookie.callback('welcome', () => {
|
|
72
|
+
showWelcomePopup();
|
|
73
|
+
}, { delay: 2 });
|
|
74
|
+
|
|
75
|
+
// Баннер согласия
|
|
76
|
+
Cookie.consent({
|
|
77
|
+
location: 'bottom',
|
|
78
|
+
name: 'gdpr_consent'
|
|
79
|
+
});
|
|
80
|
+
```
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
# index.js
|
|
2
|
+
|
|
3
|
+
## Описание
|
|
4
|
+
|
|
5
|
+
`Core` — набор статических утилит: глубокое слияние, случайные строки, UUID, склонение по числу, экранирование HTML, копирование в буфер обмена, скачивание файла и AJAX-обёртка `fetch`. Используется внутри других модулей библиотеки (например, `Loader` грузит данные через `Core.fetch`) и доступен снаружи.
|
|
6
|
+
|
|
7
|
+
Подключение:
|
|
8
|
+
|
|
9
|
+
```js
|
|
10
|
+
// ESM / npm
|
|
11
|
+
import Core from '@cat-of-summer/st-script/core';
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
```html
|
|
15
|
+
<!-- CDN / IIFE: объявляет глобальный Core -->
|
|
16
|
+
<script defer src="dist/core.min.js"></script>
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Публичные статические методы
|
|
20
|
+
|
|
21
|
+
### `Core.merge(...objects)`
|
|
22
|
+
|
|
23
|
+
Глубокое слияние. Принимает любое количество аргументов и сливает их слева направо, возвращая новый объект (входы не мутируются).
|
|
24
|
+
|
|
25
|
+
- Обычные объекты и массивы сливаются рекурсивно; массивы — overlay по индексу (`[1,2,3]` + `[9]` → `[9,2,3]`).
|
|
26
|
+
- Если на одном ключе с обеих сторон оказались функции — они компонуются: результат вызывается с теми же аргументами и сам сливается.
|
|
27
|
+
- Во всех остальных случаях (скаляры, `null`, несовпадающие типы, экземпляры классов, `Date`) побеждает позднее значение.
|
|
28
|
+
|
|
29
|
+
### `Core.getRandomChars(params?)`
|
|
30
|
+
|
|
31
|
+
Случайная строка на `crypto.getRandomValues`.
|
|
32
|
+
|
|
33
|
+
| Параметр | По умолчанию | Описание |
|
|
34
|
+
|---|---|---|
|
|
35
|
+
| `params.length` | `16` | Длина строки |
|
|
36
|
+
| `params.characters` | `A-Za-z0-9` | Набор символов |
|
|
37
|
+
|
|
38
|
+
### `Core.uuid(version?)`
|
|
39
|
+
|
|
40
|
+
UUID в каноническом виде `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`.
|
|
41
|
+
|
|
42
|
+
| `version` | Что выдаёт |
|
|
43
|
+
|---|---|
|
|
44
|
+
| `7` (по умолчанию) | UUIDv7: первые 48 бит — время `Date.now()` в мс, остальное случайно. Сортируется по времени создания |
|
|
45
|
+
| `4` | UUIDv4: полностью случайный |
|
|
46
|
+
|
|
47
|
+
### `Core.plural(n, one, few, many)`
|
|
48
|
+
|
|
49
|
+
Форма слова по числу, правила русского языка:
|
|
50
|
+
|
|
51
|
+
```js
|
|
52
|
+
Core.plural(1, 'файл', 'файла', 'файлов'); // 'файл'
|
|
53
|
+
Core.plural(3, 'файл', 'файла', 'файлов'); // 'файла'
|
|
54
|
+
Core.plural(11, 'файл', 'файла', 'файлов'); // 'файлов'
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### `Core.escape(text)`
|
|
58
|
+
|
|
59
|
+
Экранирует `& < > " '` для вставки строки в HTML (`innerHTML`, `#html` в App). `null` и `undefined` дают пустую строку.
|
|
60
|
+
|
|
61
|
+
### `Core.copy(text)`
|
|
62
|
+
|
|
63
|
+
Копирует строку в буфер обмена, возвращает `Promise<boolean>`. Вне защищённого контекста (сайт по http не на localhost) Clipboard API недоступен — тогда копирование идёт через скрытое поле и `document.execCommand('copy')`, а фокус возвращается туда, где был. Вызывать из обработчика действия пользователя: без него браузер копирование запрещает.
|
|
64
|
+
|
|
65
|
+
### `Core.download(content, filename, type?)`
|
|
66
|
+
|
|
67
|
+
Отдаёт строку или `Blob` файлом через временную ссылку `<a download>`. `type` — MIME-тип для строки, по умолчанию `text/plain`.
|
|
68
|
+
|
|
69
|
+
```js
|
|
70
|
+
Core.download(key, 'access.key');
|
|
71
|
+
Core.download(JSON.stringify(data), 'export.json', 'application/json');
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### `Core.fetch(params)`
|
|
75
|
+
|
|
76
|
+
Обёртка над `XMLHttpRequest`, а не над браузерным `fetch`. Возвращает объект `api`: у него есть методы промиса (`then`, `catch`, `finally`), а также отмена запроса и подписка на события - см. [возвращаемый объект](#возвращаемый-объект-api). Сам запрос уходит в микрозадаче (`queueMicrotask`), поэтому обработчики событий можно навешивать цепочкой сразу после вызова.
|
|
77
|
+
|
|
78
|
+
Аргументом можно передать как объект параметров, так и `HTMLFormElement` — тогда `url`, `method` и `data` берутся из атрибутов формы (`action`, `method`) и её полей, включая скрытые.
|
|
79
|
+
|
|
80
|
+
**Параметры (`params`):**
|
|
81
|
+
|
|
82
|
+
| Параметр | По умолчанию | Описание |
|
|
83
|
+
|---|---|---|
|
|
84
|
+
| `url` | `window.location.href` | Адрес запроса |
|
|
85
|
+
| `method` | `'GET'` | HTTP-метод (приводится к верхнему регистру) |
|
|
86
|
+
| `data` | `null` | Тело запроса: объект, `FormData` или `HTMLFormElement` |
|
|
87
|
+
| `headers` | `{}` | Заголовки запроса |
|
|
88
|
+
| `timeout` | `0` | Таймаут в мс (`0` — без таймаута) |
|
|
89
|
+
| `response_type` | `''` | `responseType` для XHR (`'json'`, `'blob'` и т.п.) |
|
|
90
|
+
|
|
91
|
+
**Обработка тела (`data`):**
|
|
92
|
+
|
|
93
|
+
- `FormData` — отправляется как есть.
|
|
94
|
+
- `HTMLFormElement` — `url`/`method` подхватываются из атрибутов формы, тело собирается в `FormData`.
|
|
95
|
+
- Обычный объект при `GET` — сериализуется в query-строку, тело становится `null`.
|
|
96
|
+
- Обычный объект при остальных методах — отправляется как JSON; если `Content-Type` не задан, выставляется `application/json`.
|
|
97
|
+
|
|
98
|
+
**Разбор ответа** — одинаковый для успеха и ошибки: `data` в `on_success`/`on_complete` и `response` в `on_failed` получаются одним и тем же способом.
|
|
99
|
+
|
|
100
|
+
- Задан `response_type` — берётся `request.response` (для `'json'` это уже объект или `null`).
|
|
101
|
+
- Иначе по заголовку `Content-Type`: `*/json` → `JSON.parse` (тело, которое не разобралось, остаётся строкой), `*/xml` → `Document` (XML), `*/html` → `Document` (HTML), иначе — текст.
|
|
102
|
+
|
|
103
|
+
**Колбэки** можно задать как в `params`, так и навесить методами возвращаемого объекта:
|
|
104
|
+
|
|
105
|
+
| Параметр `params` | Метод | Когда вызывается | Payload |
|
|
106
|
+
|---|---|---|---|
|
|
107
|
+
| `before_send` | `.beforeSend(cb)` | Перед отправкой | `params` |
|
|
108
|
+
| `on_send` | `.onSend(cb)` | Сразу после `send()` | `{ detail: params }` |
|
|
109
|
+
| `on_success` | `.onSuccess(cb)` | Статус 2xx | `{ data, request }`, `data` — разобранное тело |
|
|
110
|
+
| `on_complete` | `.onComplete(cb)` | Запрос завершён (`readyState` 4) — при любом статусе, включая сетевую ошибку | `{ data, request }`, `data` — разобранное тело |
|
|
111
|
+
| `on_failed` | `.onFailed(cb)` | Не-2xx, сетевая ошибка, таймаут, исключение при подготовке | `{ status, status_text, response, request }` |
|
|
112
|
+
|
|
113
|
+
Поля payload `on_failed`:
|
|
114
|
+
|
|
115
|
+
- `response` — разобранное тело ответа (см. выше): сервер ответил на 422 JSON-ом — придёт объект, текстом — строка.
|
|
116
|
+
- `status` — HTTP-статус; `0` при сетевой ошибке и таймауте (тело тогда пустое); `undefined`, если исключение случилось до отправки — в этом случае `response` содержит само исключение, а `request` отсутствует.
|
|
117
|
+
|
|
118
|
+
#### Возвращаемый объект (`api`)
|
|
119
|
+
|
|
120
|
+
- `.then(onFulfilled, onRejected)`, `.catch(onRejected)`, `.finally(fn)` - успех резолвит `{ data, request }`, ошибка реджектит payload `on_failed`.
|
|
121
|
+
- `.abort()` - прерывает запрос: промис реджектится со `status: 0`, как при сетевой ошибке, `on_failed` и `on_complete` вызываются.
|
|
122
|
+
- `.beforeSend / .onSend / .onSuccess / .onComplete / .onFailed` - регистрируют дополнительные обработчики, возвращают `api` (можно чейнить).
|
|
123
|
+
|
|
124
|
+
Сам `api` - не `Promise` (`api instanceof Promise === false`), а thenable: объект с методом `then`. Для языка этого достаточно - `await Core.fetch(...)`, `Promise.all([...])` и возврат из `.then` другого промиса работают с ним как с промисом.
|
|
125
|
+
|
|
126
|
+
`.then`, `.catch` и `.finally` возвращают **обычный `Promise`**. Поэтому, чтобы переделать результат - достать `data`, превратить отказ в свою ошибку, - достаточно цепочки; оборачивать вызов в `new Promise((resolve, reject) => ...)` не нужно:
|
|
127
|
+
|
|
128
|
+
```js
|
|
129
|
+
// результат — Promise с телом ответа, отказ — своя ошибка
|
|
130
|
+
const load = url => Core.fetch({ url }).then(
|
|
131
|
+
({ data }) => data,
|
|
132
|
+
({ status, response }) => { throw new ApiError(status, response); },
|
|
133
|
+
);
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
У этого `Promise` уже нет `abort()` и методов событий - они есть только у самого `api`. Нужна отмена - сохранить `api` в переменную до `.then`:
|
|
137
|
+
|
|
138
|
+
```js
|
|
139
|
+
const query = Core.fetch({ url: '/api/search', data: { q } });
|
|
140
|
+
query.then(({ data }) => render(data));
|
|
141
|
+
// ...
|
|
142
|
+
query.abort();
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
`abort()` действует только после того, как запрос ушёл, то есть с микрозадачи. Вызов в том же синхронном коде, что и `Core.fetch(...)`, запрос не отменяет.
|
|
146
|
+
|
|
147
|
+
## Примеры
|
|
148
|
+
|
|
149
|
+
```js
|
|
150
|
+
// Глубокое слияние
|
|
151
|
+
const defaults = { a: 1, b: { c: 10, d: 20 } };
|
|
152
|
+
const overrides = { b: { c: 99 }, e: 5 };
|
|
153
|
+
const result = Core.merge(defaults, overrides);
|
|
154
|
+
// { a: 1, b: { c: 99, d: 20 }, e: 5 }
|
|
155
|
+
|
|
156
|
+
// Случайная строка и UUID
|
|
157
|
+
const id = Core.getRandomChars({ length: 8 }); // 'aB3xKpQm'
|
|
158
|
+
const key = Core.uuid(); // '019a…-…' (v7)
|
|
159
|
+
|
|
160
|
+
// Запрос с колбэками в параметрах
|
|
161
|
+
Core.fetch({
|
|
162
|
+
url: '/api/users',
|
|
163
|
+
method: 'POST',
|
|
164
|
+
data: { name: 'Alex' },
|
|
165
|
+
on_success: ({ data }) => console.log(data),
|
|
166
|
+
// сервер отвечает на 422 JSON-ом { errors: {...} } — response уже объект
|
|
167
|
+
on_failed: ({ status, response }) => status == 422 && show_errors(response.errors),
|
|
168
|
+
});
|
|
169
|
+
|
|
170
|
+
// Цепочка и Promise-интерфейс
|
|
171
|
+
Core.fetch({ url: '/api/users', response_type: 'json' })
|
|
172
|
+
.onSuccess(({ data }) => render(data))
|
|
173
|
+
.catch(({ status_text }) => console.error(status_text));
|
|
174
|
+
|
|
175
|
+
// Отправка формы как есть
|
|
176
|
+
Core.fetch(document.querySelector('form'))
|
|
177
|
+
.then(({ data }) => console.log(data), ({ response }) => console.error(response));
|
|
178
|
+
```
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
# index.js
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
# Loader.js
|
|
2
|
+
|
|
3
|
+
## Описание
|
|
4
|
+
|
|
5
|
+
Загружает список или одиночный контент через `Core.fetch`, нормализует ответ и
|
|
6
|
+
вставляет результат в контейнер. Один инстанс = один механизм: подгрузка
|
|
7
|
+
(«показать ещё»), фильтр, сортировка, детальный контент. Ответ может быть **HTML**
|
|
8
|
+
(`Document`), **JSON** (object/array) или **текст** — `Core.fetch` парсит по
|
|
9
|
+
`Content-Type`, а Loader сам определяет тип и подбирает обработку.
|
|
10
|
+
|
|
11
|
+
Класс ничего не слушает сам (imperative): всё через `load(params)`. Состояние запроса
|
|
12
|
+
не копится — каждый `load()` полностью задаёт параметры. Маппинг ответа описывается
|
|
13
|
+
декларативно (`source` + `multiple` + `render`), поведение — через хуки (`before_*`/`on_*`).
|
|
14
|
+
|
|
15
|
+
## Конструктор
|
|
16
|
+
|
|
17
|
+
```js
|
|
18
|
+
new Loader(params)
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
| Параметр | Тип | По умолчанию | Описание |
|
|
22
|
+
|---|---|---|---|
|
|
23
|
+
| `target` | `string\|Element` | `null` | Контейнер на странице |
|
|
24
|
+
| `source` | `string` | `null` | Где в ответе данные. **HTML** — CSS-селектор; **JSON** — dot-path (`'data.items'`) |
|
|
25
|
+
| `multiple` | `boolean` | `true` | `true` → массив элементов, `render` на каждый; `false` → один элемент, `render` один раз |
|
|
26
|
+
| `mode` | `'append'\|'replace'\|'prepend'` | `'append'` | Режим вставки по умолчанию |
|
|
27
|
+
| `allow_interrupt` | `boolean` | `false` | Разрешить новому `load()` аборт текущего запроса |
|
|
28
|
+
| `render` | `Function` | identity | `render(item, i)` → **Node**. Не-`Node` отбрасывается. Для JSON задаётся обязательно |
|
|
29
|
+
| `formats` | `object` | `{}` | Per-type оверрайды: `{ json:{…}, html:{…}, text:{…} }` (см. ниже) |
|
|
30
|
+
|
|
31
|
+
`this` во всех функциях-параметрах — инстанс `Loader` (доступны `this.params`, `this.html`).
|
|
32
|
+
|
|
33
|
+
### Извлечение данных (`source` + `multiple`)
|
|
34
|
+
|
|
35
|
+
Внутреннее, по типу ответа:
|
|
36
|
+
|
|
37
|
+
- **HTML**, `source` задан: `multiple` → `[...querySelectorAll(source)]`, иначе `querySelector(source)`.
|
|
38
|
+
- **HTML**, `source` пуст: `multiple` → дети корня ответа, иначе первый дочерний элемент.
|
|
39
|
+
- **JSON**, `source` задан: dot-path по объекту (`'products'`, `'data.items'`).
|
|
40
|
+
- **JSON**, `source` пуст: весь ответ.
|
|
41
|
+
- **text**: строка как есть.
|
|
42
|
+
|
|
43
|
+
При `multiple: true` ожидается массив (`render` зовётся `data.length` раз), при `false` —
|
|
44
|
+
`render(data)` один раз. Извлечённые данные живут только в рамках одного `load()` —
|
|
45
|
+
постоянного буфера нет.
|
|
46
|
+
|
|
47
|
+
### Per-type оверрайды (`formats`)
|
|
48
|
+
|
|
49
|
+
`formats[type]` (`type` = `'html' | 'json' | 'text'`) переопределяет параметры под конкретный
|
|
50
|
+
тип ответа. Один инстанс обслуживает оба формата без дублирования.
|
|
51
|
+
|
|
52
|
+
- **`render`, `source`, `mode`, `multiple`** — ветка перекрывает корень.
|
|
53
|
+
- **Хуки `on_load` / `before_paste` / `on_paste`** — *складываются*: сначала корневой, затем веточный.
|
|
54
|
+
|
|
55
|
+
Lifecycle-хуки `before_init` / `on_init` / `before_load` / `on_failed` / `on_complete` —
|
|
56
|
+
только корневые (тип ответа на этих этапах неизвестен).
|
|
57
|
+
|
|
58
|
+
### Поток обработки `load()`
|
|
59
|
+
|
|
60
|
+
`before_load(fetchParams)` → `Core.fetch` → определение типа → `data = extract(response)`
|
|
61
|
+
→ `data = on_load(response, data, request) ?? data` → `render` (`multiple` ? на каждый элемент : один раз)
|
|
62
|
+
→ `before_paste(nodes)` → вставка по `mode` → `on_paste(nodes, response)`;
|
|
63
|
+
`on_failed(payload)` при ошибке, `on_complete(payload)` всегда.
|
|
64
|
+
|
|
65
|
+
## Хуки
|
|
66
|
+
|
|
67
|
+
| Хук | Аргументы | Когда | Per-type |
|
|
68
|
+
|---|---|---|---|
|
|
69
|
+
| `before_init` / `on_init` | `config` | В конструкторе (можно править config до резолва `target`) | — |
|
|
70
|
+
| `before_load` | `fetchParams` | Перед запросом | — |
|
|
71
|
+
| `on_load` | `response, data, request` | После успеха, до рендера. Вернёт значение → заменит `data` (дедуп/фильтр/сорт); иначе сайд-эффекты | ✓ |
|
|
72
|
+
| `before_paste` | `nodes` | После рендера, до вставки | ✓ |
|
|
73
|
+
| `on_paste` | `nodes, response` | После вставки (вешать listeners) | ✓ |
|
|
74
|
+
| `on_failed` | `payload` | При ошибке/таймауте. Payload — как у `Core.fetch`: `{ status, status_text, response, request }`, `response` — разобранное тело ответа (JSON → объект) | — |
|
|
75
|
+
| `on_complete` | `payload` | По завершении (успех или ошибка) | — |
|
|
76
|
+
|
|
77
|
+
## Публичные методы и свойства
|
|
78
|
+
|
|
79
|
+
| Член | Возвращает | Описание |
|
|
80
|
+
|---|---|---|
|
|
81
|
+
| `load(urlOrParams)` | `this` | Запрос + вставка. `params` (кроме `mode`) уходят в `Core.fetch`. Строка = `{ url }` |
|
|
82
|
+
| `abort()` | `this` | Прервать текущий запрос |
|
|
83
|
+
| `clone(params)` | `Loader` | Новый инстанс с унаследованными параметрами (`formats` сливается поверхностно) |
|
|
84
|
+
| `loading` | `boolean` | Идёт ли запрос |
|
|
85
|
+
| `params` | `object` | Текущие не-функциональные параметры (без `formats`) |
|
|
86
|
+
| `Loader.html` | `Element` | Хелпер: html-строка/tagged template → первый Element |
|
|
87
|
+
| `Loader.find(el)` | `Loader` | Инстанс, владеющий элементом |
|
|
88
|
+
|
|
89
|
+
`mode` в `load({ mode })` переопределяет и дефолт, и веточный `mode`. Остальные ключи
|
|
90
|
+
(`url`, `method`, `data`, `headers`, `timeout`, …) идут в `Core.fetch`; фильтр/сортировка/
|
|
91
|
+
страница передаются через `data` (для GET `Core.fetch` сам строит querystring).
|
|
92
|
+
|
|
93
|
+
На `target` выставляется атрибут `state` = `loading` / `loaded` (для CSS-индикации).
|
|
94
|
+
|
|
95
|
+
## Примеры
|
|
96
|
+
|
|
97
|
+
Один инстанс на HTML и JSON одновременно:
|
|
98
|
+
|
|
99
|
+
```js
|
|
100
|
+
let loader = new Loader({
|
|
101
|
+
target: '.cards',
|
|
102
|
+
on_paste: nodes => nodes.forEach(wireCard), // общий для обоих форматов
|
|
103
|
+
formats: {
|
|
104
|
+
html: { source: '.card' }, // render = identity
|
|
105
|
+
json: { source: 'products', render: p => Loader.html`
|
|
106
|
+
<article class="card"><h3>${p.title}</h3><span>${p.price} ₽</span></article>` },
|
|
107
|
+
},
|
|
108
|
+
});
|
|
109
|
+
|
|
110
|
+
loader.load({ url: '/catalog', data: { sort: 'price' }, mode: 'replace' }); // HTML или JSON — по Content-Type
|
|
111
|
+
loader.load({ url: '/catalog', data: { sort: 'price', page: 2 } }); // append
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Детальный контент (один элемент, дописываем в существующий блок):
|
|
115
|
+
|
|
116
|
+
```js
|
|
117
|
+
let detail = new Loader({
|
|
118
|
+
target: '#log',
|
|
119
|
+
multiple: false, // ответ = один элемент
|
|
120
|
+
mode: 'append', // дописываем, не перетираем
|
|
121
|
+
formats: { json: { render: r => Loader.html(`<p>${r.message}</p>`) } },
|
|
122
|
+
});
|
|
123
|
+
|
|
124
|
+
detail.load('/api/next-message');
|
|
125
|
+
```
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
# _engine.js
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
# _groups.js
|