primeng
Version:
PrimeNG is an open source UI library for Angular featuring a rich set of 80+ components, a theme designer, various theme alternatives such as Material, Bootstrap, Tailwind, premium templates and professional support. In addition, it integrates with PrimeB
492 lines (487 loc) • 18.9 kB
JavaScript
import * as i1 from '@angular/common';
import { CommonModule } from '@angular/common';
import * as i0 from '@angular/core';
import { Injectable, forwardRef, EventEmitter, inject, booleanAttribute, numberAttribute, Output, Input, ViewEncapsulation, ChangeDetectionStrategy, Component, NgModule } from '@angular/core';
import { NG_VALUE_ACCESSOR } from '@angular/forms';
import { $dt } from '@primeuix/styled';
import { SharedModule } from 'primeng/api';
import { BaseEditableHolder } from 'primeng/baseeditableholder';
import { style } from '@primeuix/styles/knob';
import { BaseStyle } from 'primeng/base';
const classes = {
root: ({ instance }) => ['p-knob p-component', { 'p-disabled': instance.$disabled() }],
range: 'p-knob-range',
value: 'p-knob-value',
text: 'p-knob-text'
};
class KnobStyle extends BaseStyle {
name = 'knob';
theme = style;
classes = classes;
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.3", ngImport: i0, type: KnobStyle, deps: null, target: i0.ɵɵFactoryTarget.Injectable });
static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.1.3", ngImport: i0, type: KnobStyle });
}
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.3", ngImport: i0, type: KnobStyle, decorators: [{
type: Injectable
}] });
/**
*
* Knob is a form component to define number inputs with a dial.
*
* [Live Demo](https://www.primeng.org/knob/)
*
* @module knobstyle
*
*/
var KnobClasses;
(function (KnobClasses) {
/**
* Class name of the root element
*/
KnobClasses["root"] = "p-knob";
/**
* Class name of the range element
*/
KnobClasses["range"] = "p-knob-range";
/**
* Class name of the value element
*/
KnobClasses["value"] = "p-knob-value";
/**
* Class name of the text element
*/
KnobClasses["text"] = "p-knob-text";
})(KnobClasses || (KnobClasses = {}));
const KNOB_VALUE_ACCESSOR = {
provide: NG_VALUE_ACCESSOR,
useExisting: forwardRef(() => Knob),
multi: true
};
/**
* Knob is a form component to define number inputs with a dial.
* @group Components
*/
class Knob extends BaseEditableHolder {
/**
* Style class of the component.
* @deprecated since v20.0.0, use `class` instead.
* @group Props
*/
styleClass;
/**
* Defines a string that labels the input for accessibility.
* @group Props
*/
ariaLabel;
/**
* Specifies one or more IDs in the DOM that labels the input field.
* @group Props
*/
ariaLabelledBy;
/**
* Index of the element in tabbing order.
* @group Props
*/
tabindex = 0;
/**
* Background of the value.
* @group Props
*/
valueColor = $dt('knob.value.background').variable;
/**
* Background color of the range.
* @group Props
*/
rangeColor = $dt('knob.range.background').variable;
/**
* Color of the value text.
* @group Props
*/
textColor = $dt('knob.text.color').variable;
/**
* Template string of the value.
* @group Props
*/
valueTemplate = '{value}';
/**
* Size of the component in pixels.
* @group Props
*/
size = 100;
/**
* Mininum boundary value.
* @group Props
*/
min = 0;
/**
* Maximum boundary value.
* @group Props
*/
max = 100;
/**
* Step factor to increment/decrement the value.
* @group Props
*/
step = 1;
/**
* Width of the knob stroke.
* @group Props
*/
strokeWidth = 14;
/**
* Whether the show the value inside the knob.
* @group Props
*/
showValue = true;
/**
* When present, it specifies that the component value cannot be edited.
* @group Props
*/
readonly = false;
/**
* Callback to invoke on value change.
* @param {number} value - New value.
* @group Emits
*/
onChange = new EventEmitter();
radius = 40;
midX = 50;
midY = 50;
minRadians = (4 * Math.PI) / 3;
maxRadians = -Math.PI / 3;
value = 0;
windowMouseMoveListener;
windowMouseUpListener;
windowTouchMoveListener;
windowTouchEndListener;
_componentStyle = inject(KnobStyle);
mapRange(x, inMin, inMax, outMin, outMax) {
return ((x - inMin) * (outMax - outMin)) / (inMax - inMin) + outMin;
}
onClick(event) {
if (!this.$disabled() && !this.readonly) {
this.updateValue(event.offsetX, event.offsetY);
}
}
updateValue(offsetX, offsetY) {
let dx = offsetX - this.size / 2;
let dy = this.size / 2 - offsetY;
let angle = Math.atan2(dy, dx);
let start = -Math.PI / 2 - Math.PI / 6;
this.updateModel(angle, start);
}
updateModel(angle, start) {
let mappedValue;
if (angle > this.maxRadians)
mappedValue = this.mapRange(angle, this.minRadians, this.maxRadians, this.min, this.max);
else if (angle < start)
mappedValue = this.mapRange(angle + 2 * Math.PI, this.minRadians, this.maxRadians, this.min, this.max);
else
return;
let newValue = Math.round((mappedValue - this.min) / this.step) * this.step + this.min;
this.value = newValue;
this.writeModelValue(this.value);
this.onModelChange(this.value);
this.onChange.emit(this.value);
}
onMouseDown(event) {
if (!this.$disabled() && !this.readonly) {
const window = this.document.defaultView || 'window';
this.windowMouseMoveListener = this.renderer.listen(window, 'mousemove', this.onMouseMove.bind(this));
this.windowMouseUpListener = this.renderer.listen(window, 'mouseup', this.onMouseUp.bind(this));
event.preventDefault();
}
}
onMouseUp(event) {
if (!this.$disabled() && !this.readonly) {
if (this.windowMouseMoveListener) {
this.windowMouseMoveListener();
this.windowMouseUpListener = null;
}
if (this.windowMouseUpListener) {
this.windowMouseUpListener();
this.windowMouseMoveListener = null;
}
event.preventDefault();
}
}
onTouchStart(event) {
if (!this.$disabled() && !this.readonly) {
const window = this.document.defaultView || 'window';
this.windowTouchMoveListener = this.renderer.listen(window, 'touchmove', this.onTouchMove.bind(this));
this.windowTouchEndListener = this.renderer.listen(window, 'touchend', this.onTouchEnd.bind(this));
event.preventDefault();
}
}
onTouchEnd(event) {
if (!this.$disabled() && !this.readonly) {
if (this.windowTouchMoveListener) {
this.windowTouchMoveListener();
}
if (this.windowTouchEndListener) {
this.windowTouchEndListener();
}
this.windowTouchMoveListener = null;
this.windowTouchEndListener = null;
event.preventDefault();
}
}
onMouseMove(event) {
if (!this.$disabled() && !this.readonly) {
this.updateValue(event.offsetX, event.offsetY);
event.preventDefault();
}
}
onTouchMove(event) {
if (!this.$disabled() && !this.readonly && event instanceof TouchEvent && event.touches.length === 1) {
const rect = this.el.nativeElement.children[0].getBoundingClientRect();
const touch = event.targetTouches.item(0);
if (touch) {
const offsetX = touch.clientX - rect.left;
const offsetY = touch.clientY - rect.top;
this.updateValue(offsetX, offsetY);
}
}
}
updateModelValue(newValue) {
if (newValue > this.max)
this.value = this.max;
else if (newValue < this.min)
this.value = this.min;
else
this.value = newValue;
this.writeModelValue(this.value);
this.onModelChange(this.value);
this.onChange.emit(this.value);
}
onKeyDown(event) {
if (!this.$disabled() && !this.readonly) {
switch (event.code) {
case 'ArrowRight':
case 'ArrowUp': {
event.preventDefault();
this.updateModelValue(this._value + 1);
break;
}
case 'ArrowLeft':
case 'ArrowDown': {
event.preventDefault();
this.updateModelValue(this._value - 1);
break;
}
case 'Home': {
event.preventDefault();
this.updateModelValue(this.min);
break;
}
case 'End': {
event.preventDefault();
this.updateModelValue(this.max);
break;
}
case 'PageUp': {
event.preventDefault();
this.updateModelValue(this._value + 10);
break;
}
case 'PageDown': {
event.preventDefault();
this.updateModelValue(this._value - 10);
break;
}
}
}
}
rangePath() {
return `M ${this.minX()} ${this.minY()} A ${this.radius} ${this.radius} 0 1 1 ${this.maxX()} ${this.maxY()}`;
}
valuePath() {
return `M ${this.zeroX()} ${this.zeroY()} A ${this.radius} ${this.radius} 0 ${this.largeArc()} ${this.sweep()} ${this.valueX()} ${this.valueY()}`;
}
zeroRadians() {
if (this.min > 0 && this.max > 0)
return this.mapRange(this.min, this.min, this.max, this.minRadians, this.maxRadians);
else
return this.mapRange(0, this.min, this.max, this.minRadians, this.maxRadians);
}
valueRadians() {
return this.mapRange(this._value, this.min, this.max, this.minRadians, this.maxRadians);
}
minX() {
return this.midX + Math.cos(this.minRadians) * this.radius;
}
minY() {
return this.midY - Math.sin(this.minRadians) * this.radius;
}
maxX() {
return this.midX + Math.cos(this.maxRadians) * this.radius;
}
maxY() {
return this.midY - Math.sin(this.maxRadians) * this.radius;
}
zeroX() {
return this.midX + Math.cos(this.zeroRadians()) * this.radius;
}
zeroY() {
return this.midY - Math.sin(this.zeroRadians()) * this.radius;
}
valueX() {
return this.midX + Math.cos(this.valueRadians()) * this.radius;
}
valueY() {
return this.midY - Math.sin(this.valueRadians()) * this.radius;
}
largeArc() {
return Math.abs(this.zeroRadians() - this.valueRadians()) < Math.PI ? 0 : 1;
}
sweep() {
return this.valueRadians() > this.zeroRadians() ? 0 : 1;
}
valueToDisplay() {
return this.valueTemplate.replace('{value}', this._value.toString());
}
get _value() {
return this.value != null ? this.value : this.min;
}
/**
* @override
*
* @see {@link BaseEditableHolder.writeControlValue}
* Writes the value to the control.
*/
writeControlValue(value, setModelValue) {
this.value = value;
setModelValue(this.value);
this.cd.markForCheck();
}
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.3", ngImport: i0, type: Knob, deps: null, target: i0.ɵɵFactoryTarget.Component });
static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "16.1.0", version: "20.1.3", type: Knob, isStandalone: true, selector: "p-knob", inputs: { styleClass: "styleClass", ariaLabel: "ariaLabel", ariaLabelledBy: "ariaLabelledBy", tabindex: ["tabindex", "tabindex", numberAttribute], valueColor: "valueColor", rangeColor: "rangeColor", textColor: "textColor", valueTemplate: "valueTemplate", size: ["size", "size", numberAttribute], min: ["min", "min", numberAttribute], max: ["max", "max", numberAttribute], step: ["step", "step", numberAttribute], strokeWidth: ["strokeWidth", "strokeWidth", numberAttribute], showValue: ["showValue", "showValue", booleanAttribute], readonly: ["readonly", "readonly", booleanAttribute] }, outputs: { onChange: "onChange" }, host: { properties: { "attr.data-pc-name": "'knob'", "attr.data-pc-section": "'root'", "class": "cn(cx('root'), styleClass)" } }, providers: [KNOB_VALUE_ACCESSOR, KnobStyle], usesInheritance: true, ngImport: i0, template: `
<svg
viewBox="0 0 100 100"
role="slider"
[style.width]="size + 'px'"
[style.height]="size + 'px'"
(click)="onClick($event)"
(keydown)="onKeyDown($event)"
(mousedown)="onMouseDown($event)"
(mouseup)="onMouseUp($event)"
(touchstart)="onTouchStart($event)"
(touchend)="onTouchEnd($event)"
[attr.aria-valuemin]="min"
[attr.aria-valuemax]="max"
[attr.required]="required() ? '' : undefined"
[attr.aria-valuenow]="_value"
[attr.aria-labelledby]="ariaLabelledBy"
[attr.aria-label]="ariaLabel"
[attr.tabindex]="readonly || $disabled() ? -1 : tabindex"
[attr.data-pc-section]="'svg'"
>
<path [attr.d]="rangePath()" [attr.stroke-width]="strokeWidth" [attr.stroke]="rangeColor" [class]="cx('range')"></path>
<path [attr.d]="valuePath()" [attr.stroke-width]="strokeWidth" [attr.stroke]="valueColor" [class]="cx('value')"></path>
<text *ngIf="showValue" [attr.x]="50" [attr.y]="57" text-anchor="middle" [attr.fill]="textColor" [class]="cx('text')" [attr.name]="name()">
{{ valueToDisplay() }}
</text>
</svg>
`, isInline: true, dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: SharedModule }], changeDetection: i0.ChangeDetectionStrategy.OnPush, encapsulation: i0.ViewEncapsulation.None });
}
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.3", ngImport: i0, type: Knob, decorators: [{
type: Component,
args: [{
selector: 'p-knob',
standalone: true,
imports: [CommonModule, SharedModule],
template: `
<svg
viewBox="0 0 100 100"
role="slider"
[style.width]="size + 'px'"
[style.height]="size + 'px'"
(click)="onClick($event)"
(keydown)="onKeyDown($event)"
(mousedown)="onMouseDown($event)"
(mouseup)="onMouseUp($event)"
(touchstart)="onTouchStart($event)"
(touchend)="onTouchEnd($event)"
[attr.aria-valuemin]="min"
[attr.aria-valuemax]="max"
[attr.required]="required() ? '' : undefined"
[attr.aria-valuenow]="_value"
[attr.aria-labelledby]="ariaLabelledBy"
[attr.aria-label]="ariaLabel"
[attr.tabindex]="readonly || $disabled() ? -1 : tabindex"
[attr.data-pc-section]="'svg'"
>
<path [attr.d]="rangePath()" [attr.stroke-width]="strokeWidth" [attr.stroke]="rangeColor" [class]="cx('range')"></path>
<path [attr.d]="valuePath()" [attr.stroke-width]="strokeWidth" [attr.stroke]="valueColor" [class]="cx('value')"></path>
<text *ngIf="showValue" [attr.x]="50" [attr.y]="57" text-anchor="middle" [attr.fill]="textColor" [class]="cx('text')" [attr.name]="name()">
{{ valueToDisplay() }}
</text>
</svg>
`,
providers: [KNOB_VALUE_ACCESSOR, KnobStyle],
changeDetection: ChangeDetectionStrategy.OnPush,
encapsulation: ViewEncapsulation.None,
host: {
'[attr.data-pc-name]': "'knob'",
'[attr.data-pc-section]': "'root'",
'[class]': "cn(cx('root'), styleClass)"
}
}]
}], propDecorators: { styleClass: [{
type: Input
}], ariaLabel: [{
type: Input
}], ariaLabelledBy: [{
type: Input
}], tabindex: [{
type: Input,
args: [{ transform: numberAttribute }]
}], valueColor: [{
type: Input
}], rangeColor: [{
type: Input
}], textColor: [{
type: Input
}], valueTemplate: [{
type: Input
}], size: [{
type: Input,
args: [{ transform: numberAttribute }]
}], min: [{
type: Input,
args: [{ transform: numberAttribute }]
}], max: [{
type: Input,
args: [{ transform: numberAttribute }]
}], step: [{
type: Input,
args: [{ transform: numberAttribute }]
}], strokeWidth: [{
type: Input,
args: [{ transform: numberAttribute }]
}], showValue: [{
type: Input,
args: [{ transform: booleanAttribute }]
}], readonly: [{
type: Input,
args: [{ transform: booleanAttribute }]
}], onChange: [{
type: Output
}] } });
class KnobModule {
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.3", ngImport: i0, type: KnobModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.1.3", ngImport: i0, type: KnobModule, imports: [Knob, SharedModule], exports: [Knob, SharedModule] });
static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "20.1.3", ngImport: i0, type: KnobModule, imports: [Knob, SharedModule, SharedModule] });
}
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.3", ngImport: i0, type: KnobModule, decorators: [{
type: NgModule,
args: [{
imports: [Knob, SharedModule],
exports: [Knob, SharedModule]
}]
}] });
/**
* Generated bundle index. Do not edit.
*/
export { KNOB_VALUE_ACCESSOR, Knob, KnobClasses, KnobModule, KnobStyle };
//# sourceMappingURL=primeng-knob.mjs.map