Search

Module: Editor

Version: 2.2.1 +

User: Developer

Object Type: Output Object

Child of:

- WebPage

- WebPanel

Description

A RadioButton object provides output on a website. A RadioButton is displayed as an option within a RadioGroup.
The RadioButton can only be used in combination with the RadioGroup object. A RadioGroup is a list of options, of which a user can choose only one, by clicking the bullet in front of the options. Within the RadioGroup a list of RadioButtons should be created, each representing a different option.

For example, the RadioButtons can be used to create the answers for a multiple choice question, where only one answer is possible.

Properties

AutoPostBack

A postback is an action taken by an interactive webpage, when the entire page and its contents are sent to the server for processing some (submitted) information and then, the server posts the same page back to the browser. Possible values of the AutoPostBack property are 'True' or 'False'. If the value is 'True', then the Index of the RadioButton will be used directly in the calculation after selecting it. If the value is 'False', then the input will not directly be processed.

DebugLogMode (from version 4.1)

Indicates the level of detail of debug information that is logged during runtime of the website to the trace, a logfile, a database etc. The possible values are:

  • None: no debug information is logged
  • Simple: only basic information is given
  • Extended: in addition to the information in the Simple mode the values of all the properties of the object are shown

Enabled

Possible values are 'True' or 'False'. If the value is 'False', then the object can not be used within the application.

Group

Here you should select the RadioGroup that the RadioButton is part of. This property is required.

Index

Here you should enter a number of the Type 'Long'. The UserVariable that is referred to in the RadioGroup belonging to this RadioButton, will obtain the value of the Index property. From Futurama 19.04 + this parameter is only visible when the property IndexType of a RadioGroup has value Custom. 

IsPublic

Possible values are 'True' or 'False'. If the value is 'False', then the object can only be used within the document where it is created. If the value is 'True', then also from other Futurama documents can be referred to this object. This means that changes in the object also affect the document in which is referred to this object. If the value is 'True' and you attempt to move or delete the object, a warning will be given. To limit these warnings to a minimum it is recommended to set IsPublic to 'True' only when necessary.

ToolTip

In the property Tooltip a text can be entered that is shown in the application when a cursor is moved across the RadioButton. In this way information about the usage of the RadioButton can be given to the user.

Visible

Possible values are 'True' or 'False'. If the value is 'True', the object will be rendered and therefore displayed in your application. If the value is 'False', the object will not be rendered.

XmlName

The name of the object as it is shown in the source of the website. By default the XmlName is equal to the name given in the property (Name) with spaces replaced by underscores, but you are free to change it.

(Name)

The name of the object.

Comment

Here a comment can be entered. For example a short description of the object.

ID

The unique identification number of the object. This number is automatically generated by Futurama on the moment of creation. This number can be used when searching for a certain object in the Find Window.

CssClass

Here the CssClass can be entered. In the stylesheet you can define the style elements that belong to this class.

Text

Here you can enter the text that will be displayed next to the bullet, explaining the option that the RadioButton represents. From Futurama version 18.02 it is also possible to define the texts within a ResourceDocument. See the page Text management and Multi-language.

Rendering

A RadioButton object is rendered as follows:




Within the label element, the text entered in the Text property is rendered. If you've entered a classname in the CssClass property, this will be added as a class attribute in the span element.

Beware that the rendering of objects depends on the DocType selected for your Futurama Document. The rendering mentioned above is based on the DocType XHTML_1_0. If your using the old DocType HMTL4_Transitional, please consult the Document page for further information.

Example

This example shows the usage of the RadioGroup and RadioButton object.

Download

Download the Futurama Document RadioGroup Example.

Description

  1. Open the XML-document which is contained in the zip-file in the Futurama Editor (Version 4.2.1 or later).
  2. Here a RadioGroup object can be seen within the WebPage and WebPanel construction, as well as two RadioButton objects.
  3. By running this 'application' in your browser, you can see how the RadioGroup is displayed.

Related Topics

- Futurama Objects: The Atlas chapter that describes all Futurama objects. See the Output-section for a description of the type of objects this object belongs to.

- UserVariable

- RadioGroup

Updated: 2019-04-15