	Language
	English
	English
	English
	French
	German
	German
	German
	Italian
	Korean
	Spanish
	Catalan
	Dutch
	Portuguese
	Portuguese
	Arabic
	Arabic
	Bulgarian
	Bangla
	Bosnian
	Czech
	Greek
	Estonian
	Persian
	Finnish
	Danish
	Hindi
	Indonesian
	Icelandic
	Croatian
	Japanese
	Hungarian
	Hebrew
	Georgian
	Central Kurdish
	Khmer
	Kyrgyz
	Kazakh
	Lithuanian
	Latvian
	Malay
	Norwegian
	Polish
	Romanian
	Russian
	Slovak
	Slovenian
	Serbian
	Serbian
	Swedish
	Thai
	Turkish
	Ukrainian
	Uzbek
	Vietnamese
	Chinese
	Chinese

Knob

Knob's useful to insert numeric values in a range.

Knob Tag Documentation

Knob is a form component to define a number with a dial.

Name	Type	Required	Default	Description
id	String	false	generated	Unique identifier of the component in a namingContainer.
rendered	boolean	false	true	Boolean value to specify the rendering of the component, when set to false component will not be rendered.
binding	UIComponent	false	generated	An EL expression referring to a server side UIComponent instance in a backing bean.
widgetVar	String	false	generated ('widget_' + componentClientId)	Name of the client side widget.
backgroundColor	Object	false		Background color of the knob.
colorTheme	String	false		Color theme for the knob.
converter	Converter	false		EL expression resolves to a converter instance or literal converter ID defining a component converter.
converterMessage	String	false
cursor	boolean	false	false	Shows a cursor.
disabled	boolean	false	false	Disables the component.
foregroundColor	Object	false		Foreground color of the knob.
height	Object	false		Height of the knob.
immediate	boolean	false	false	When set true, process validations logic is executed at apply request values phase for this component.
labelTemplate	String	false	{value}	Template for the label.
lineCap	String	false	butt	Line cap style, valid values are "butt" and "round".
max	int	false	100	Maximum value.
min	int	false	0	Minimum value.
onchange	String	false		Client side callback to execute when value changes.
required	boolean	false	false	Marks component as required.
requiredMessage	String	false
showLabel	boolean	false	true	Shows the label.
step	int	false	1	Step size.
style	String	false		Inline style of the component.
styleClass	String	false		Style class of the component.
submittedValue	Object	false
thickness	Float	false		Thickness of the knob arc.
validator	Validator	false		A method expression referring to a method validating the input.
validatorMessage	String	false
value	Object	false		Value of the component.
valueChangeListener	ValueChangeListener	false		A method binding expression referring to a method for handling a valuchangeevent.
width	Object	false		Width of the knob.

Name	Description
No records found.

Name	Type	Default	Description
change	BehaviorEvent	true	Fires when the knob value changes.

Name	Library	Target
components.css	primefaces
knob/knob.css	primefaces
jquery/jquery.js	primefaces
jquery/jquery-plugins.js	primefaces
core.js	primefaces
components.js	primefaces
knob/knob.js	primefaces

Family org.primefaces.component

Type org.primefaces.component.Knob

Class org.primefaces.component.knob.Knob

Renderer Type org.primefaces.component.KnobRenderer

Renderer Class org.primefaces.component.knob.KnobRenderer

RESOURCES

Tag DocumentationNew DocumentationNew Documentation JSDoc

Basic

Max-Min and Step

Show-Hide Label

Label template

Disabled

Cursor

Thickness

Theme

Colors


<p:growl>
    <p:autoUpdate/>
</p:growl>

<h:form>
    <div class="card">
        <div class="grid text-center">
            <div class="field col-12 md:col-4">
                <h5 style="margin-top:0">Basic</h5>
                <p:knob value="#{knobView.value}">
                    <p:ajax listener="#{knobView.onChange}"/>
                </p:knob>
            </div>

            <div class="field col-12 md:col-4">
                <h5>Max-Min and Step</h5>
                <div class="knob-container  ui-corner-all">
                    <p:knob max="1000" step="50" value="950"/>
                </div>
            </div>

            <div class="field col-12 md:col-4">
                <h5>Show-Hide Label</h5>
                <div class="knob-container ui-corner-all">
                    <p:knob showLabel="false" value="65"/>
                </div>
            </div>

            <div class="field col-12 md:col-4">
                <h5>Label template</h5>
                <div class="knob-container  ui-corner-all">
                    <p:knob labelTemplate="{value}%" value="35"/>
                </div>
            </div>

            <div class="field col-12 md:col-4">
                <h5>Disabled</h5>
                <div class="knob-container ui-corner-all">
                    <p:knob disabled="true" value="85"/>
                </div>
            </div>

            <div class="field col-12 md:col-4">
                <h5>Cursor</h5>
                <div class="knob-container ui-corner-all">
                    <p:knob cursor="true" value="0"/>
                </div>
            </div>

            <div class="field col-12 md:col-4">
                <h5>Thickness</h5>
                <div class="knob-container ui-corner-all">
                    <p:knob thickness=".5" value="50"/>
                </div>
            </div>

            <div class="field col-12 md:col-4">
                <h5>Theme</h5>
                <div class="knob-container ui-corner-all">
                    <p:knob colorTheme="hot-sneaks" value="45"/>
                </div>
            </div>

            <div class="field col-12 md:col-4">
                <h5>Colors</h5>
                <div class="knob-container ui-corner-all">
                    <p:knob foregroundColor="#2196F3" backgroundColor="#495057" value="25"/>
                </div>
            </div>
        </div>
    </div>
</h:form>


package org.primefaces.showcase.view.input;

import java.io.Serializable;

import jakarta.enterprise.context.RequestScoped;
import jakarta.faces.application.FacesMessage;
import jakarta.faces.context.FacesContext;
import jakarta.inject.Named;

@Named
@RequestScoped
public class KnobView implements Serializable {

    private int value = 50;

    public int getValue() {
        return value;
    }

    public void setValue(int value) {
        this.value = value;
    }

    public void onChange() {
        FacesContext.getCurrentInstance().addMessage(null, new FacesMessage(FacesMessage.SEVERITY_INFO, "You have selected: " + value, null));
    }
}