HomeGuidesRecipesAPI
HomeGuidesAPILog In
Guides
These docs are for v16. Click to read the latest docs for v31.

Button questions types have been added to Design and to Produce, windows app and mobile apps, there is a Button icon in the toolbar and a tile icon in the tree view on the right-hand side in Design.

152

Options and features:

339 563
OptionDescription
Text positionTop, Left, none as standard.
Display TypeTile (default) or Button.
Note: Selecting Button disables the Icon and Badge inputs of these will not be used by the Button display.
Selecting Button also enables the Button Style input, which is not used by the Tile display.
SizeSmall, Medium, Wide and Large are the options. They appear in the preview so the user can see how they will look.
Title(optional) This is text that appears on the bottom right of the button. This shows in the preview. If the title is too long it will just be cut off - it does not wrap.
Badge(optional) This is small text (75% of the title size) with a dark background that appears at the top right of the button. This shows in the preview. If the badge is too long it will just be cut off - it does not wrap.
IconThis is an image that appears in the center of the button - if the image loaded is too large it will not appear centered and may overlap the title or not fit on the button at all. It is visible in the preview.
Button Style(Shown for "Button" display type only)
Displays style entries from the appsettings file which are marked as applying to "button".
If no style is selected, or none are available, the question will use a default style matching what is shown in the Design preview.
567

Type Options

OptionDescription
Toggle Allows for actions based on whether the button answer is selected or not.
Button toggle color -** will replace the default blue of the button when selected - you cannot toggle the button in the preview, so you cannot preview this setting.
Open URL Allows a URL to be entered, this URL will be opened in a browser when the button is clicked.
Open In New Tab - Will open the URL in a new tab, if selected or will open the URL in the current tab if not selected.
Go To PageAllows a page within the same project to be selected. The page will be redirected to when the button is clicked.
Go To ProjectAllows a folder and then a project to be selected. The page will be redirected to the selected project when the button is clicked.
Include Project PropertiesAllows passing project properties to the destination form.
RefreshAllows to perform a PostBack when clicked.
Background colorThis will replace the default blue of the button - shows in the preview.
Border color on focusThis will replace the default blue of the button border change on hover - shows in the preview. This color does not show on mobile devices as there is no such thing as "hover" on a mobile app.
StyleThis will insert a background behind the button. Styles can vary in color and size.

📘

Note

  1. A color picker is used to select and show the colors for properties 6.1, 7 and 8 or you can enter a manual hex code.

  2. If a custom CSS file is used with the various tile classes changed but using the same format as the default .css, then the default colors specified in the .css file for the buttons will replace the default system colors but will still allow the individual property settings for the question to apply. Applicable classes are .tile, .tile:hover, .tile-sm, .tile-md, .tile-wd, .tile-lg, .tile-badge, .tile-content, and .tile-icon.

  3. When setting the button background in a CSS file you should include a gradient as per the following example background-image: linear-gradient (to bottom, #0078D7 0%, #0045A4 100%). If no actual gradient is to be shown, set the two colors to be the same e.g.: background-image: linear-gradient (to bottom, #0078D7 0%, #0078D7 100%).

Blurry Text

You might notice that some of the text on your buttons is blurry.

537

This can happen because there's a text shadow from the original base style. Adding the following to the CSS for that button will fix it.

text-shadow: none;

🚧

Conditions

Button Question Type cannot be used as a Condition