PHPackages                             owl/knob - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. owl/knob

AbandonedArchivedLibrary[Utility & Helpers](/categories/utility)

owl/knob
========

Knob widget for OctoberCMS.

32.0k1PHP

Since Jun 30Pushed 10y ago1 watchersCompare

[ Source](https://github.com/october-widgets/knob)[ Packagist](https://packagist.org/packages/owl/knob)[ RSS](/packages/owl-knob/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Knob
====

[](#knob)

A touch friendly widget to handle numeric fields.

[jQuery Knob](https://github.com/aterrien/jQuery-Knob) is © 2012 Anthony Terrien under the MIT license. OctoberCMS widget created by [Keios Solutions](http://keios.eu).

[![Packagist](https://camo.githubusercontent.com/4274fc871d69c824df85d798638e74df2087feb429f7f57d274c1df2ea3bd832/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f776c2f6b6e6f622e737667)](https://camo.githubusercontent.com/4274fc871d69c824df85d798638e74df2087feb429f7f57d274c1df2ea3bd832/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6f776c2f6b6e6f622e737667)

### Installation

[](#installation)

To install the Knob widget, add the following to your plugin's `composer.json` file.

```
"require": {
    "owl/knob": "~1.0@dev"
}
```

Next, register the widget in your plugin's `Plugin.php` file.

```
public function registerFormWidgets()
{
    return [
        'Owl\FormWidgets\Knob\Widget' => [
            'label' => 'Knob',
            'code'  => 'owl-knob'
        ],
    ];
}
```

### Usage

[](#usage)

To use the Knob widget, simply declare a field type as `owl-knob`

```
knob:
    label: Knob
    type: owl-knob
```

The following options are supported :

**Behaviors:**

```
min : min value | default=0.
max : max value | default=100.
step : step size | default=1.
angleOffset : starting angle in degrees | default=0.
angleArc : arc size in degrees | default=360.
stopper : stop at min & max on keydown/mousewheel | default=true.
readOnly : disable input and events | default=false.
rotation : direction of progression | default=clockwise.

```

**UI:**

```
cursor : display mode "cursor", cursor size could be changed passing a numeric value to the option, default width is used when passing boolean value "true" | default=gauge.
thickness : gauge thickness.
lineCap : gauge stroke endings. | default=butt, round=rounded line endings
width : dial width.
displayInput : default=true | false=hide input.
displayPrevious : default=false | true=displays the previous value with transparency.
fgColor : foreground color.
inputColor : input value (number) color.
font : font family.
fontWeight : font weight.
bgColor : background color.

```

**October UI related:**

```
knobLabel: label to display on right side of the knob, can be translation string
knobComment: comment to display on right side of the knob, can be translation string

```

**Form configuration example**

```
fields:
    age:
      knobLabel: Your current age
      knobComment: We need to know, really.
      type: owl-knob
      span: right
      min: 1
      default: 23
      max: 100
      angleOffset: -125
      angleArc: 250
```

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/904cc72c102eb3725fdc5191aaf7519724839af6feb847dc20dfa138f37e50b2?d=identicon)[scottbedard](/maintainers/scottbedard)

---

Top Contributors

[![scottbedard](https://avatars.githubusercontent.com/u/7980426?v=4)](https://github.com/scottbedard "scottbedard (3 commits)")

### Embed Badge

![Health badge](/badges/owl-knob/health.svg)

```
[![Health](https://phpackages.com/badges/owl-knob/health.svg)](https://phpackages.com/packages/owl-knob)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)