PHP Class Prado\Web\UI\WebControls\TKeyboard

TKeyboard displays a virtual keyboard that users can click on to enter input in an associated text box. It helps to reduce the keyboard recording hacking. To use TKeyboard, write a template like following:

A TKeyboard control is associated with a {@link TTextBox} control by specifying {@link setForControl ForControl} to be the ID of that control. When the textbox is in focus, a virtual keyboard will pop up; and when the text box is losing focus, the keyboard will hide automatically. Set {@link setAutoHide AutoHide} to false to keep the keyboard showing all the time. The appearance of the keyboard can also be changed by specifying a customized CSS file via {@link setCssUrl CssUrl}. By default, the CSS class name for the keyboard is 'Keyboard'. This may also be changed by specifying {@link setKeyboardCssClass KeyboardCssClass}.

Since: 3.1.1

Inheritance: extends TWebControl

Afficher le fichier Open project: pradosoft/prado

Méthodes publiques

Méthode	Description
getAutoHide ( ) : boolean
getCssUrl ( ) : string
getForControl ( ) : string
getKeyboardCssClass ( ) : string
onPreRender ( $param )	Registers CSS and JS.
setAutoHide ( $value )
setCssUrl ( $value )
setForControl ( $value )	Sets the ID path of the {@link TTextBox} control.
setKeyboardCssClass ( $value )	Sets a value indicating the CSS class name for the keyboard element.

Méthodes protégées

Méthode	Description
addAttributesToRender ( $writer )	Adds attribute name-value pairs to renderer.
getClientClassName ( ) : string
getClientOptions ( ) : array
registerClientScript ( )	Registers the relevant JavaScript.
registerStyleSheet ( )	Registers the CSS relevant to the TKeyboard.

Method Details

addAttributesToRender() protected méthode

This method overrides the parent implementation with additional TKeyboard specific attributes.

protected addAttributesToRender ( $writer )

getAutoHide() public méthode

public getAutoHide ( ) : boolean
Résultat	boolean	whether the keyboard should be hidden when the textbox is not in focus. Defaults to true.

getClientClassName() protected méthode

protected getClientClassName ( ) : string
Résultat	string	the Javascript class name for this control

getClientOptions() protected méthode

protected getClientOptions ( ) : array
Résultat	array	the JavaScript options for this control

getCssUrl() public méthode

public getCssUrl ( ) : string
Résultat	string	the URL for the CSS file to customize the appearance of the keyboard.

getForControl() public méthode

public getForControl ( ) : string
Résultat	string	the ID path of the {@link TTextBox} control

getKeyboardCssClass() public méthode

public getKeyboardCssClass ( ) : string
Résultat	string	the CSS class name for the keyboard element. Defaults to 'Keyboard'.

onPreRender() public méthode

This method is invoked right before the control rendering, if the control is visible.

public onPreRender ( $param )

registerClientScript() protected méthode

Registers the relevant JavaScript.

protected registerClientScript ( )

registerStyleSheet() protected méthode

It will register the CSS file specified by {@link getCssUrl CssUrl}. If that is not set, it will use the default CSS.

protected registerStyleSheet ( )

setAutoHide() public méthode

public setAutoHide ( $value )

setCssUrl() public méthode

public setCssUrl ( $value )

setForControl() public méthode

The ID path is the dot-connected IDs of the controls reaching from the keyboard's naming container to the target control.

public setForControl ( $value )

setKeyboardCssClass() public méthode

Note, if you change this property, make sure you also supply a customized CSS file by specifying {@link setCssUrl CssUrl} which uses the new CSS class name for styling.

public setKeyboardCssClass ( $value )