Skip to main content

Ribbon Button properties

type(string) the type of a control, set it to "button". If not specified - the "navItem" type is applied by default.
id(string, number) the id of a control, auto-generated if not set
parent(string) the parent of the button
value(string) a value of the button. You need to set either the value or html property to the button
html(string) optional, a string with HTML that should be inserted into the button
css(string) adds style classes to a button
icon(string) an icon of the button
items(array) an array of nested controls. You can find the full list of all available controls here. If the type of a nested control is not specified, the menuItem type will be applied by default.
twoState(boolean) the flag that defines whether a button can be used in two states: active (pressed) and inactive (unpressed)
group(string) defines the name of a group of controls a button belongs to. If one of the buttons in the group becomes active, all others automatically become inactive.
active(boolean) for twoState buttons, if true, the button is in the active state
hotkey(string) the name of the hot key for the button
tooltip(string) a tooltip for the button
count(number) a badge with a number
countColor(string) the color of a badge with number: "danger" | "secondary" | "primary" | "success"
multiClick(boolean) defines the behavior of the Undo/Redo buttons:
  • true all the actions are reverted/re-applied one by one when the Undo/Redo button is clicked and held
  • false one action is reverted/re-applied on each click of the Undo/Redo button
view(string) defines the look of a button: "flat"|"link"
size(string) defines the size of a button: "small"|"medium"|"auto"

Related Sample: Ribbon. Button height: auto, small, medium
color(string) defines the color scheme of a button: "danger"|"secondary"|"primary"|"success"
full(boolean) extends a button to the full width of a form
circle(boolean) makes the corners of a button round
loading(boolean) adds a spinner into a button
hidden(boolean) defines whether a button is hidden
disabled(boolean) defines whether a button is disabled