SpwAjaxSender — это класс на нативном JS, который превращает HTML-разметку в AJAX-интерфейс. Всё через as-* атрибуты — никакой JS-обвязки, никаких data-controller, никакого x-data. Сервер возвращает JSON-массив команд, клиент их выполняет.
Лицензия: MIT
Зависимости: нет
Сервер: любой (PHP, Node, Python, Go) — формат ответа — обычный JSON
Что внутри
- Декларативные триггеры —
click,submit,input,change,visible,ready, кастомные события. as-confirmс поддержкойconfirm()илиfn:— своей функции сawait.as-poll— периодический опрос с остановкой при уходе со страницы.as-delay— debounce в миллисекундах, прямо в атрибуте.as-abort-key— декларативная отмена предыдущего запроса по ключу (live-search без кода).as-prevent-duplicate—per-button/global/false.as-then— цепочка: следующий AJAX-запрос, вызовfn:, или событиеevent:.as-loading—self/target/html/ селекторы, с классом.as-loadingиdisabledдля кнопок.as-timeout,as-method,as-body-type="json",as-data— всё на элементе.- 14 команд с сервера —
html,append,prepend,attr,toggle,val,focus,alert,console,redirect,refresh,remove,replace,reset,call. - События —
ajax:before,ajax:success,ajax:error,ajax:cancel,ajax:complete, плюс по каждому действию (ajax:success:actionName).
Пример: форма в одну строку
<form as-action="save" as-trigger="submit" as-target="#status">
<input name="title">
<button type="submit">Сохранить</button>
</form>
<div id="status"></div> На сервере:
$r->html('#status', 'Сохранено!');
$r->attr('#status', 'class', 'alert alert-success');
$r->send(); Клиент получит JSON [{"type":"html","data":["#status","Сохранено!"]},{...}] и выполнит обе команды.
Ключевые особенности
- JSON-команды вместо HTML-шаблонов на клиенте. Сервер говорит что сделать (
html,attr,alert,redirect), а не какой HTML отдать. Шаблоны остаются на сервере — их не надо дублировать на клиенте. - Один ответ — несколько действий. Массив команд в одном JSON: можно вставить HTML, поменять атрибут, показать alert, вызвать функцию — за один запрос.
- Полностью декларативные атрибуты.
as-abort-key,as-prevent-duplicate,as-confirmсfn:,as-then— то, что обычно требует отдельных обработчиков или плагинов, здесь пишется в разметке. - Ноль зависимостей и ноль сборки. Один JS-файл. Подключил — работает.
- Серверо-агностичность. Формат ответа — обычный JSON. PHP-обработчик идёт в комплекте, но при желании на любом языке можно отдавать массив команд.
| № | Файл | Формат | Размер | ||
|---|---|---|---|---|---|
| 1 | spw.ajax-sender | js | 0.02 | 9 | |
| 2 | spw.ajax-response | txt | 0 | 9 |
Комментариев пока нет.