0.0.1 • Published 8 years ago

dn-gauge.js v0.0.1

Weekly downloads
1
License
ISC
Repository
github
Last release
8 years ago

Gauge.js

Pure Javascript компонент, отрисовывающий круговую шкалу через canvas. Без использования каких-либо библиотек, фреймворков, спрайтов - он весит всего 2.58 Кб. Имеет множество настроек для кастомизации внешнего вида, прост в использовании.

Демонстрация работы

npm.io

Установка

Скачайте gauge.min.js или полную версию gauge.js и вставьте при помощи тега script:

<script src="gauge.min.js"></script>

Использование

Пример вызова без параметров:

gauge = new Gauge({},document.getElementById("container"));

Вызов с параметрами:

gauge = new Gauge({
width: 500,
height:500,
aperture: 240,
radius: 175,
areas:[
	{
		color: '#ffa500',
		start: 150,
		end: 190
	},
	{
		color: 'red',
		start: 190,
		end: 210
	}
],
values:[0,1,2,3,4,5,6],
angle: 2/3,
scaleInside : false,
arrowColor: '#1e98e4',
dotColor: '#777',
font: '18px Arial',
textColor: '#777',
arcWidth: 3
}, 
document.getElementById("container"));

Параметры

ПараметрОписаниеЗначение
widthШирина canvasЧисло(300, 500 и т.д.)
heightВысота canvasЧисло(300, 500 и т.д.)
apertureАпертура(в градусах)Число(180, 270 и т.д.)
radiusРадиус шкалы(в градусах)Число(50, 100 и т.д.)
areasЦветные областиМасив областей. Каждая область должна иметь следующие свойства:
start - начало области в градусах
end - конец области в градусах
color - цвет области (любое css-значение цвета)
valuesМассив значений на шкалеМассив чисел или строк. 0, 'min', 20, 30, 40, 50, 60, 70, 80, 90, 'max'
arrowColorЦвет стрелкиЦвет в css - hex, rgba или название цвета. Например 'red', '#ccc', '#00ff00', 'rgba(0,0,0,0.5)'
arcColorЦвет дуги шкалыЦвет в css - hex, rgba или название цвета. Например 'red', '#ccc', '#00ff00', 'rgba(0,0,0,0.5)'
textColorЦвет текста и насечек под текстомЦвет в css - hex, rgba или название цвета. Например 'red', '#ccc', '#00ff00', 'rgba(0,0,0,0.5)'
dotColorЦвет точек между значениямиЦвет в css - hex, rgba или название цвета. Например 'red', '#ccc', '#00ff00', 'rgba(0,0,0,0.5)'
angleПозиция стрелкиЧисло от 0 до 1 (0 - крайнее минимальное положение, 1 - крайнее максимальное). Например: 0, 0.5, 0.999, 1/3, 2/5 и т.д.
scaleInsideВывести значения внутрь шкалыtrue или false. По умолчанию - false
fontШрифт, размер, начертание - через css'12px Arial', 'italic 10px Tahoma' и т.д.
checkAreasПроверка цветных областей на вхождение в границы дуги. Если установлен в true, то области, выходящие за пределы дуги будут обрезаны.true или false. По умолчанию - false
arcWidthШирина дугиЧисло(1, 2, 5 и т.д.)