openHAB

This page is part of archived documentation for openHAB 3.1. Go to the current stable version

# oh-knob-cell - Knob Cell

A cell expanding to a knob control

# Configuration

# Cell

General settings of the cell

Header of the cell

# title Title TEXT

Title of the cell

# subtitle Subtitle TEXT

Subtitle of the cell

Footer of the cell

# icon Icon TEXT

Use oh:iconName (openHAB icon), f7:iconName (Framework7 icon) or material:iconName (Material icon)

# color Highlight Color TEXT

Color to use when highlighted

# on "On" expression TEXT

Expression to determine when the card should be highlighted. If blank, determine automatically from the primary bound item if applicable.

# Knob

# item Item TEXT item

Item to control

# min Min INTEGER

Minimum value (default 0)

# max Max INTEGER

Maximum value (default 100)

# stepSize Step DECIMAL

Minimum interval between values (default 1)

# disabled Disabled BOOLEAN

Disable the slider (usually set via an expression since the value will not be displayed when disabled)

# size Size INTEGER

Visual size of the control in px (or % if responsive is true)

# primaryColor Primary Color TEXT

Color of the value arc (HTML value, default #409eff)

# secondaryColor Secondary Color TEXT

Color of the rest of the control (HTML value, default #dcdfe6)

# textColor Text Color TEXT

Color of the value text (HTML value, default #000000)

# strokeWidth Stroke Width TEXT

Thickness of the arcs, default 17

# responsive Responsive BOOLEAN

Size the control using percentages instead of pixels

# releaseOnly Send command only on release BOOLEAN

If enabled, no commands are sent during sliding

# commandInterval Command Interval INTEGER

Time to wait between subsequent commands in ms (default 200)

# delayStateDisplay Delay State Display INTEGER

Time to wait before switching from displaying user input to displaying item state in ms (default 2000)

# Action

Action to perform when the element is clicked

# action Action TEXT

Type of action to perform

Options:
navigate
Navigate to page
command
Send command
toggle
Toggle item
options
Command options
rule
Run rule
popup
Open popup
popover
Open popover
sheet
Open sheet
photos
Open photo browser
group
Group details
analyzer
Analyze item(s)
url
External URL
variable
Set Variable

# actionUrl Action URL TEXT url

URL to navigate to

# actionUrlSameWindow Open in same tab/window BOOLEAN

Open the URL in the same tab/window instead of a new one. This will exit the app.

# actionItem Action Item TEXT item

Item to perform the action on

# actionCommand Action Command TEXT

Command to send to the item. If "toggle item" is selected as the action, only send the command when the state is different

# actionCommandAlt Action Toggle Command TEXT

Command to send to the item when "toggle item" is selected as the action, and the item's state is equal to the command above

# actionOptions Command Options TEXT

Comma-separated list of options; if omitted, retrieve the command options from the item dynamically. Use value=label format to provide a label different than the option.

# actionRule Rule TEXT rule

Rule to run

# actionPage Page TEXT page

Page to navigate to

# actionPageTransition Transition Effect TEXT

Use a specific page transition animation

Options:
f7-circle
Circle
f7-cover
Cover
f7-cover-v
Cover from bottom
f7-dive
Dive
f7-fade
Fade
f7-flip
Flip
f7-parallax
Parallax
f7-push
Push

# actionModal Modal Page or Widget TEXT pagewidget

Page or widget to display in the modal

# actionModalConfig Modal component configuration TEXT props

Configuration (prop values) for the target modal page or widget

# actionPhotos Images to show TEXT

Array of URLs or objects representing the images. Auto-refresh is not supported.
Edit in YAML or provide a JSON array, e.g.
[ "url1", { "item": "ImageItem1", "caption": "Camera" } ]
Objects are in the photos array format with an additional item property to specify an item to view.

# actionPhotoBrowserConfig Photo browser configuration TEXT

Configuration for the photo browser.
Edit in YAML or provide a JSON object, e.g.
{ "exposition": false, "type": "popup", "theme": "dark" }
See photo browser parameters (not all are supported).

# actionGroupPopupItem Group Popup Item TEXT item

Group item whose members to show in a popup

# actionAnalyzerItems Item(s) to Analyze TEXT item

Start analyzing with the specified (set of) item(s)

# actionAnalyzerChartType Chart Type TEXT

The initial analyzing period - dynamic or a predefined fixed period: day, week, month or year

Options:
(empty)
Dynamic
day
Day
isoWeek
Week (starting on Mondays)
month
Month
year
Year

# actionAnalyzerCoordSystem Initial Coordinate System TEXT

The initial coordinate system of the analyzer - time, aggregate or calendar (only time is supported for dynamic periods)

Options:
time
Time
aggregate
Aggregate
calendar
Calendar

# actionFeedback Action feedback TEXT

Shows a toast popup when the action has been executed. Can either be a text to show or a JSON object including some of the supported parameters

# actionVariable Variable TEXT

The variable name to set

# actionVariableValue Variable Value TEXT

The value to set the variable to

Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)

←