@webeach/gl-circular-progress
v0.2.2
Published
Beautiful WebGL circular progress bars library (Fire and Liquid effects).
Maintainers
Readme
💎 Особенности
- WebGL Рендеринг. Высокая производительность и плавные анимации шейдеров.
- Эффектные стили. Готовые пресеты для имитации огня (
Fire) и жидкости (Liquid). - Полная кастомизация. Настройка цветов, толщины, скорости, интенсивности и других параметров.
- Легковесность. Полное отсутствие зависимостей (Zero dependencies), оптимизированный код.
- TypeScript. Полная типизация "из коробки".
📦 Установка
npm install @webeach/gl-circular-progressили
pnpm install @webeach/gl-circular-progressили
yarn add @webeach/gl-circular-progress📥 Использование
import { CircularProgressFire } from '@webeach/gl-circular-progress';
// Находим canvas элемент
const canvas = document.getElementById('my-canvas');
// Инициализируем прогресс-бар
const instance = new CircularProgressFire(canvas, {
colors: [0xff5a00, 0xff9a00],
progress: 0.5, // Начальное значение
speed: 1.5,
thickness: 15,
});
// Не забываем очищать при удалении компонента
// instance.destroy();🛠 Классы и Документация
Библиотека предоставляет два основных класса с различными визуальными эффектами:
🔥 CircularProgressFire
Круговой прогресс с динамичным эффектом пламени. Поддерживает настройку интенсивности огня и цветовых градиентов.
💧 CircularProgressLiquid
Круговой прогресс с эффектом текучей жидкости и метаболлов. Поддерживает настройку "объема" (volume) для создания 3D-эффекта линзы.
🧩 Зависимости
Библиотека не имеет внешних зависимостей (Zero dependencies) и написана на нативном WebGL.
🔖 Выпуск новой версии
Релизы обрабатываются автоматически с помощью semantic-release.
Перед публикацией новой версии убедись, что:
- Все изменения закоммичены и запушены в ветку
main. - Сообщения коммитов соответствуют формату Conventional Commits:
feat: ...— для новых фичfix: ...— для исправлений баговchore: ...,refactor: ...и другие типы — по необходимости
- Версионирование определяется автоматически на основе типа коммитов (
patch,minor,major).
👨💻 Автор
Разработка и поддержка: Руслан Мартынов
Если у тебя есть предложения или найден баг, открывай issue или отправляй pull request.
📄 Лицензия
Этот пакет распространяется под лицензией MIT.
