Установка и подключение

Bliss.js — это легковесная библиотека JavaScript, упрощающая работу с DOM, событиями и AJAX. Для начала работы с библиотекой необходимо правильно установить и подключить её к проекту.

Подключение через CDN

Наиболее простой способ начать использовать Bliss.js — подключение через CDN. Это позволяет подключать библиотеку без необходимости установки через пакетный менеджер.

<!DOCTYPE html>
<html lang="ru">
<head>
    <meta charset="UTF-8">
    <title>Пример Bliss.js</title>
    <script src="https://cdn.jsdelivr.net/npm/blissfuljs@1.0.4/bliss.min.js"></script>
</head>
<body>
    <script>
        // Пример использования
        $$(document).ready(function() {
            console.log("Bliss.js подключен и готов к работе");
        });
    </script>
</body>
</html>

Ключевые моменты при подключении через CDN:

  • Всегда проверять актуальную версию на официальном CDN или в документации.
  • Скрипт подключается в <head> или перед закрывающим тегом </body>. Размещение перед </body> уменьшает вероятность ошибок при обращении к DOM.

Установка через npm

Для проектов на Node.js и сборщиков модулей (Webpack, Parcel, Vite) рекомендуется установка через npm:

npm install blissfuljs

После установки библиотеку можно подключать в модульном формате:

import { $$ } from 'blissfuljs';

$$(() => {
    console.log("Bliss.js работает через модульный импорт");
});

Особенности модульного подключения:

  • Позволяет использовать tree-shaking для уменьшения конечного размера бандла.
  • Обеспечивает совместимость с современными системами сборки и TypeScript.

Локальное подключение

Для оффлайн-проектов или внутренней разработки можно скачать файл библиотеки и подключить его локально:

  1. Скачать bliss.min.js с официального репозитория.
  2. Поместить файл в директорию проекта, например /js/lib/.
  3. Подключить в HTML:
<script src="js/lib/bliss.min.js"></script>

Преимущества локального подключения:

  • Не зависит от внешнего CDN и сетевого соединения.
  • Удобно для внутренних корпоративных проектов.

Проверка корректного подключения

После подключения рекомендуется убедиться, что библиотека работает корректно. Самый простой способ — вызвать метод $$(document).ready() или проверить глобальную переменную $$.

if (typeof $$ !== 'undefined') {
    console.log("Bliss.js успешно подключен");
} else {
    console.error("Bliss.js не загружен");
}

Рекомендации по организации подключения

  • Подключение должно выполняться до всех скриптов, использующих Bliss.js.
  • Для динамически загружаемых страниц или SPA рекомендуется использовать модульный подход через import.
  • Версия библиотеки должна фиксироваться для стабильности работы проекта.

Подключение Bliss.js является базовым шагом для использования всех возможностей библиотеки: работы с DOM, событий, AJAX и утилитарных функций. Правильная установка гарантирует корректное взаимодействие с HTML-документом и предотвращает ошибки при инициализации скриптов.

Оглавление