PHP Class Prado\Web\UI\WebControls\TRadioButton

TRadioButton displays a radio button on the page. You can specify the caption to display beside the radio buttonby setting the {@link setText Text} property. The caption can appear either on the right or left of the radio button, which is determined by the {@link setTextAlign TextAlign} property. To determine whether the TRadioButton component is checked, test the {@link getChecked Checked} property. The {@link onCheckedChanged OnCheckedChanged} event is raised when the {@link getChecked Checked} state of the TRadioButton component changes between posts to the server. You can provide an event handler for the {@link onCheckedChanged OnCheckedChanged} event to to programmatically control the actions performed when the state of the TRadioButton component changes between posts to the server. TRadioButton uses {@link setGroupName GroupName} to group together a set of radio buttons. Once the {@link setGroupName GroupName} is set, you can use the {@link getRadioButtonsInGroup} method to get an array of TRadioButtons having the same group name. If {@link setAutoPostBack AutoPostBack} is set true, changing the radio button state will cause postback action. And if {@link setCausesValidation CausesValidation} is true, validation will also be processed, which can be further restricted within a {@link setValidationGroup ValidationGroup}. Note, {@link setText Text} is rendered as is. Make sure it does not contain unwanted characters that may bring security vulnerabilities.

Since: 3.0

Author: Qiang Xue ([email protected])

Inheritance: extends TCheckBox

Afficher le fichier Open project: pradosoft/prado Class Usage Examples

Méthodes publiques

Méthode	Description
__construct ( )	Constructor.
getEnableClientScript ( ) : boolean
getGroupName ( ) : string
getRadioButtonsInGroup ( ) : array	Gets an array of radiobuttons whose group name is the same as this radiobutton's.
getUniqueGroupName ( ) : string
loadPostData ( $key, $values ) : boolean	Loads user input data.
onInit ( $param )	Registers the radio button groupings. If overriding onInit method, ensure to call parent implemenation.
onUnLoad ( $param )	Unregisters the radio button groupings. If overriding onInit method, ensure to call parent implemenation.
setEnableClientScript ( $value )
setGroupName ( $value )	Sets the name of the group that the radio button belongs to.
setUniqueGroupName ( $value )	Sets the unique group name that the radio button belongs to.

Méthodes protégées

Méthode	Description
getClientClassName ( ) : string	Gets the name of the javascript class responsible for performing postback for this control.
getValueAttribute ( ) : string
renderClientControlScript ( $writer )	Renders the client-script code.
renderInputTag ( $writer, $clientID, $onclick )	Renders a radiobutton input element.

Method Details

__construct() public méthode

Registers the radiobutton in a global radiobutton collection. If overridden, the parent implementation must be invoked first.

public __construct ( )

getClientClassName() protected méthode

This method overrides the parent implementation.

protected getClientClassName ( ) : string
Résultat	string	the javascript class name

getEnableClientScript() public méthode

public getEnableClientScript ( ) : boolean
Résultat	boolean	whether to render javascript.

getGroupName() public méthode

public getGroupName ( ) : string
Résultat	string	the name of the group that the radio button belongs to. Defaults to empty.

getRadioButtonsInGroup() public méthode

Note, only those radiobuttons that are on the current page hierarchy may be returned in the result.

public getRadioButtonsInGroup ( ) : array
Résultat	array	list of TRadioButton with the same group

getUniqueGroupName() public méthode

public getUniqueGroupName ( ) : string
Résultat	string	the name used to fetch radiobutton post data

getValueAttribute() protected méthode

protected getValueAttribute ( ) : string
Résultat	string	the value attribute to be rendered

loadPostData() public méthode

This method is primarly used by framework developers.

public loadPostData ( $key, $values ) : boolean
Résultat	boolean	whether the data of the control has been changed

onInit() public méthode

Registers the radio button groupings. If overriding onInit method, ensure to call parent implemenation.

public onInit ( $param )

onUnLoad() public méthode

Unregisters the radio button groupings. If overriding onInit method, ensure to call parent implemenation.

public onUnLoad ( $param )

renderClientControlScript() protected méthode

Renders the client-script code.

protected renderClientControlScript ( $writer )

renderInputTag() protected méthode

Renders a radiobutton input element.

protected renderInputTag ( $writer, $clientID, $onclick )

setEnableClientScript() public méthode

public setEnableClientScript ( $value )

setGroupName() public méthode

The group is unique among the control's naming container.

setUniqueGroupName() public méthode

A unique group is a radiobutton group unique among the whole page hierarchy, while the {@link setGroupName GroupName} specifies a group that is unique among the control's naming container only. For example, each cell of a {@link TDataGrid} is a naming container. If you specify {@link setGroupName GroupName} for a radiobutton in a cell, it groups together radiobutton within a cell, but not the other, even though they have the same {@link setGroupName GroupName}. On the contratry, if {@link setUniqueGroupName UniqueGroupName} is used instead, it will group all appropriate radio buttons on the whole page hierarchy. Note, when both {@link setUniqueGroupName UniqueGroupName} and {@link setGroupName GroupName}, the former takes precedence.