Moodle PHP Documentation 4.5
Moodle 4.5dev (Build: 20240606) (d3ae1391abe)
single_select Class Reference

Simple form with just one select field that gets submitted automatically. More...

Inheritance diagram for single_select:
renderable templatable

Public Member Functions

 __construct (moodle_url $url, $name, array $options, $selected='', $nothing=array(''=> 'choosedots'), $formid=null)
 Constructor.
 
 add_action (component_action $action)
 Add action to the button.
 
 add_confirm_action ($confirmmessage)
 Shortcut for adding a JS confirm dialog when the button is clicked.
 
 export_for_template (renderer_base $output)
 Export data.
 
 set_help_icon ($identifier, $component='moodle')
 Adds help icon.
 
 set_label ($label, $attributes=array())
 Sets select's label.
 
 set_old_help_icon ($helppage, $title, $component='moodle')
 Adds help icon.
 

Public Attributes

component_action[] $actions = []
 component action.
 
array $attributes = array()
 Extra select field attributes.
 
string $class = 'singleselect'
 Wrapping div class.
 
bool $disabled = false
 True if button disabled, false if normal.
 
string $formid = null
 Form id.
 
help_icon $helpicon = null
 The help icon for this element.
 
string $label = ''
 Button label.
 
array $labelattributes = array()
 Button label's attributes.
 
string $method = 'get'
 Form submit method post or get.
 
string $name
 Name of the select element.
 
array $nothing
 Nothing selected.
 
array $options
 $options associative array value=>label ex.: array(1=>'One, 2=>Two) it is also possible to specify optgroup as complex label array ex.: array(array('Odd'=>array(1=>'One', 3=>'Three)), array('Even'=>array(2=>'Two'))) array(1=>'One', '–1uniquekey'=>array('More'=>array(2=>'Two', 3=>'Three')))
 
string $selected
 Selected option.
 
string $tooltip = null
 Button tooltip.
 
moodle_url $url
 Target url - includes hidden fields.
 

Detailed Description

Simple form with just one select field that gets submitted automatically.

If JS not enabled small go button is printed too.

License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
Since
Moodle 2.0

Constructor & Destructor Documentation

◆ __construct()

single_select::__construct ( moodle_url $url,
$name,
array $options,
$selected = '',
$nothing = array('' => 'choosedots'),
$formid = null )

Constructor.

Parameters
moodle_url$urlform action target, includes hidden fields
string$namename of selection field - the changing parameter in url
array$optionslist of options
string$selectedselected element
?array$nothing
string$formid

Member Function Documentation

◆ add_action()

single_select::add_action ( component_action $action)

Add action to the button.

Parameters
component_action$action

◆ add_confirm_action()

single_select::add_confirm_action ( $confirmmessage)

Shortcut for adding a JS confirm dialog when the button is clicked.

The message must be a yes/no question.

Parameters
string$confirmmessageThe yes/no confirmation question. If "Yes" is clicked, the original action will occur.

◆ export_for_template()

single_select::export_for_template ( renderer_base $output)

Export data.

Parameters
renderer_base$outputRenderer.
Return values
stdClass

Implements templatable.

◆ set_help_icon()

single_select::set_help_icon ( $identifier,
$component = 'moodle' )

Adds help icon.

Parameters
string$identifierThe keyword that defines a help page
string$component

◆ set_label()

single_select::set_label ( $label,
$attributes = array() )

Sets select's label.

Parameters
string$label
array$attributes(optional)

◆ set_old_help_icon()

single_select::set_old_help_icon ( $helppage,
$title,
$component = 'moodle' )

Adds help icon.

Deprecated
since Moodle 2.0

The documentation for this class was generated from the following file: