Button (Bootstrap)

From NSB App Studio
Jump to navigation Jump to search

Description

Buttons can be clicked on by users to initiate actions.

By setting the appearance, buttons can have different colors.

Buttons can be grouped into horizontal and vertical groups.

The color of a Bootstrap button is set by its appearance property. Possible values are

default, primary, success, info, warning, danger and link

To change a button from primary to danger, do this:

$( "#Button6" ).removeClass( "btn-primary" );
$( "#Button6" ).addClass( "btn-danger" );

The colors for each of each of the appearance settings is defined in the Bootstrap them you use. This provides your app with a consistant look and feel throughout.

To change the icon and text at runtime, do this:

Button1.innerHTML = "<span id='Button1_icon' class='fa fa-bus'></span> Button"
Button1_icon.title = "New Title"

Popovers and Tooltips are supported.

Add Icons to Right of Button Text

When adding icons to buttons, icons will display to the left of the button text by default. Helper classes can be added to the button's class and value properties to place the icon to the right of the text.

Bootstrap 3

Add span with a class of .pull-left to the button's value field in the Properties Grid. You can add a non-breaking space to add room between the icon and the button text.

Button1.value = "<span class="pull-left">Example Button Text</span>"

Bootstrap 4 and 5

Add Bootstrap's .d-flex, .flex-row-reverse, and .justify-content-center classes to the button's class field in the Properties Grid. In the button's value field in the Properties Grid, add a span with one of Bootstrap's spacing helper classes (e.g., m*-1, m*-2, m*-3, etc.) to add a margin to the right side of the button's text and put some space between the button text and the icon.

Add these classes to the button's class field:

Button1.class = "d-flex flex-row-reverse justify-content-center"

Add a span like the following to the button's value field. Note that mr-2 is the correct syntax for Bootstrap 4. If you are adding a Bootstrap 5 button, the class would be me-2:

Button1.value = "<span class="mr-2">Example Button Text</span>"

Properties and Methods

Standard properties are supported, plus:

appearance Appearance of the alert. For example: success, info, warning, danger.
badge Adds a Badge to the alert.
blocklevel Make the button full width of parent?
ChangeForm id of the form to change to if clicked. Optional.
grouping Is this button part of a group? Choices are No, Start Horizontal, Start Vertical, Middle and End.
groupStyle The styling to apply to the entire group.
icon Optional. Icon to put at right of control. Bootstrap 3 uses the Font Awesome set. Examples: trash, check. Bootstrap 4 uses Open Iconic. Examples trash, check, circle-check.
iconTitle Optional. Text to display when hovering cursor over icon. Bootstrap 4.
Outline Display button with an outline, instead of solid color. Bootstrap 4.
toggleControl Supply the name of another control here, like a Card or Image. Clicking the button will show or hide the other control.
size The size of the button. Can be large, medium, small or extra small (Bootstrap 3 only).
value The title of the button. Design time or runtime.
hide() Hide the button. Runtime.
show() Show the button. Runtime.

Events

Standard events are supported. For this control, the onclick event will be most useful.

Example

// JavaScript
Button1.onclick = function() {
  NSB.MsgBox("You can display a message or take other action when clicked");
};

' Basic
Function Button1_onclick()
  MsgBox "You can display a message or take other action when clicked"
End Function

Output