Установка и подключение
Шаг 1: Скачивание архива
Сгенерируйте и скачайте архив со скриптом на странице Параметры. Распакованный архив содержит три файла:
snowfall.min.js— оптимизированный, обфусцированный скрипт снегопада.LICENSE— текст лицензии GNU AGPLv3.README.txt— краткая инструкция на русском и английском языках для выбранного режима отображения.
Шаг 2: Загрузка на ваш сервер
Загрузите файл snowfall.min.js в директорию вашего сайта на хостинге или сервере (например, в папку /js/ или в корень сайта).
Шаг 3: Подключение в HTML-коде
Способ подключения зависит от выбранного при генерации режима отображения. Замените /path/to/ на реальный путь, куда вы загрузили файл snowfall.min.js на втором шаге.
Снегопад выводится поверх всего содержимого страницы и занимает всю площадь окна браузера. Добавьте строку подключения скрипта перед закрывающим тегом </body>:
<!-- Подключение скрипта снегопада -->
<script data-skip-moving="true" data-cfasync="false" data-noptimize="1" src="/path/to/snowfall.min.js" defer></script>
В этом режиме снегопад выводится не на весь экран, а внутри родительского элемента, в который подключён скрипт.
- Убедитесь, что родительский элемент имеет CSS-свойство
position: relative(илиabsolute/fixed), иначе снегопад будет позиционироваться относительно ближайшего позиционированного предка илиbody. - Подключите скрипт внутри того элемента, в котором должен идти снег, — контейнер строится в месте расположения тега
<script>:
<div style="position: relative;">
<!-- здесь появится снегопад -->
<script data-skip-moving="true" data-cfasync="false" data-noptimize="1" src="/path/to/snowfall.min.js" defer></script>
</div>
::
⚠️ Важно: некоторые CMS и оптимизаторы переносят подключённые скрипты в
<head>или в конец<body>либо переписывают их на лету. Для полноэкранного режима это некритично, но в контейнерном режиме снегопад создаётся в месте расположения тега<script>— из-за переноса снег появится не там, где вы ожидали.
Атрибуты в примерах выше — страховка от таких систем. Все три — обычные data-*, они полностью безвредны там, где не распознаны (браузер их просто игнорирует):
| Атрибут | Действует в | Что делает |
|---|---|---|
data-skip-moving="true" | 1С-Битрикс | запрещает ядру переносить тег в конец страницы |
data-cfasync="false" | Cloudflare Rocket Loader | исключает скрипт из перехвата лоадером (любой сайт за Cloudflare) |
data-noptimize="1" | Autoptimize (WordPress) | исключает тег из агрегации, минификации и defer |
Если ваш оптимизатор не поддерживает теговых атрибутов — добавьте snowfall.min.js в списки исключений в настройках плагина.
Шаг 4: Проверка работоспособности
- Очистите кэш вашего браузера.
- Обновите страницу сайта.
- Наслаждайтесь потрясающим эффектом падающего снега!