Документация

Быстрый старт

Если хочешь сразу подключить моды к своему сайту — зайди в пошаговую инструкцию. Там 6 шагов со скриншотами и готовым кодом для вставки.

Содержание

Установка bundle на Tilda-сайт
Активация конкретного мода
Конфигурация через data-атрибуты
Использование в Zero Block
Chrome-плагин
JS-API ksMods
Решение проблем

1. Установка bundle

Чтобы все 211 модов стали доступны на твоём Tilda-сайте, нужно один раз вставить скрипт в HEAD:

Тильда → Настройки сайта → «Вставка кода» → «Html-код для вставки внутрь HEAD» — и туда:

<script src="https://cdn.ksmods.ru/v1/bundle.min.js"></script>

Сохрани, нажми «Опубликовать страницы». Bundle весит 30 KB gzip — загружается мгновенно.

2. Активация мода

Bundle подключён — теперь чтобы какой-то мод заработал, надо поставить его CSS-класс на нужный элемент.

Способы:

Через HEAD-код

<script>
document.addEventListener('DOMContentLoaded',function(){
  document.body.classList.add('ks-up-button', 'ks-noise', 'ks-smooth-scroll');
});
</script>

Через Zero Block

В Zero-блоке: настройки блока → CSS класс → вписать ks-X. Например ks-3d-card-hover-effect — карточка наклоняется как 3D при hover.

3. Конфигурация через data-атрибуты

Каждый мод поддерживает настройку через data-ks-{slug}-{param}:

<div class="ks-noise" data-ks-noise-opacity="0.08"></div>

Полный список параметров — на странице каждого мода (каталог).

4. Zero Block

Около 30 модов работают именно в Zero Block — они меняют поведение Zero-элементов: слайдеры, табы, попапы, drag&drop, лупы, искажения.

Ставь класс на Zero-блок целиком или на конкретный элемент внутри него.

5. Chrome-плагин

Скачай и установи плагин — получишь быстрый доступ к каталогу прямо в Tilda-редакторе. Кнопка «K&S» появится в углу страницы.

6. JS-API ksMods

После загрузки bundle — доступен глобальный объект window.ksMods:

Метод	Что делает
`ksMods.modules`	Map всех зарегистрированных модов
`ksMods.apply()`	Re-scan DOM и применить моды (полезно после динамических изменений)
`ksMods.boot()`	Полная инициализация (вызывается автоматически)
`ksMods.register(name, def)`	Зарегистрировать свой мод

7. Решение проблем

Мод не работает

Открой DevTools → Console и проверь window.ksMods?.modules?.size — должно быть 211
Проверь что класс ks-X реально стоит на элементе через Elements panel
Попробуй ksMods.apply() в консоли — принудительный re-scan
Для Tilda — проверь что страница опубликована, а не только сохранена

Bundle не загружается

Проверь что cdn.ksmods.ru доступен — открой https://cdn.ksmods.ru/v1/bundle.min.js. Если 200 OK — bundle живой. Если 503/504 — подожди минуту, идёт деплой.

Конфликт с другим скриптом

Bundle не использует jQuery и не трогает глобальные переменные кроме window.ksMods. Конфликт почти невозможен, но если есть — напиши @ksmods_support.

Не нашёл ответа?

Telegram: @ksmods_support
Email: hi@ksmods.ru
Roadmap (предложи фичу): roadmap.ksmods.ru

ДокументацияK&S Mods