MoodleQuickForm_group Class Reference

Inheritance diagram for MoodleQuickForm_group:

Public Member Functions
	__construct ($elementName=null, $elementLabel=null, $elements=null, $separator=null, $appendName=true)
	constructor More...
	accept (&$renderer, $required=false, $error=null)
	Accepts a renderer. More...
	createFormElement ()
	Creates an element to add to the group Expects the same arguments as MoodleQuickForm::createElement()
	export_for_template (renderer_base $output)
	Function to export the renderer data in a format that is suitable for a mustache template. More...
	getElementTemplateType ()
	Returns element template, nodisplay/static/fieldset. More...
string	getHelpButton ()
	template type, would cause problems with client side validation so will leave for now More...
	MoodleQuickForm_group ($elementName=null, $elementLabel=null, $elements=null, $separator=null, $appendName=true)
	Old syntax of class constructor. More...
	onQuickFormEvent ($event, $arg, &$caller)
	Called by HTML_QuickForm whenever form event is made on this element. More...
	setElements ($elements)
	Sets the grouped elements and hides label. More...
	setMoodleForm ($mform)
	Stores the form this element was added to This object is later used by MoodleQuickForm_group::createElement(). More...
	validateSubmitValue ($values)
	Calls the validateSubmitValue function for the containing elements and returns an error string as soon as it finds one. More...

Public Attributes
string	$_helpbutton =''
	html for help button, if empty then no help

Protected Attributes
MoodleQuickForm	$_mform = null
	$_renderedfromtemplate = false

Constructor & Destructor Documentation

__construct()

MoodleQuickForm_group::__construct	(		$elementName = null,
			$elementLabel = null,
			$elements = null,
			$separator = null,
			$appendName = true
	)

constructor

Parameters

string	$elementName	(optional) name of the group
string	$elementLabel	(optional) group label
array	$elements	(optional) array of HTML_QuickForm_element elements to group
string	$separator	(optional) string to seperate elements.
string	$appendName	(optional) string to appened to grouped elements.

Member Function Documentation

accept()

MoodleQuickForm_group::accept	(	&	$renderer,
			$required = false,
			$error = null
	)

Accepts a renderer.

Parameters

object	An HTML_QuickForm_Renderer object
bool	Whether a group is required
string	An error message associated with a group

Return values

void

Reimplemented in MoodleQuickForm_filetypes, MoodleQuickForm_duration, MoodleQuickForm_defaultcustom, MoodleQuickForm_date_time_selector, and MoodleQuickForm_date_selector.

export_for_template()

MoodleQuickForm_group::export_for_template

(

renderer_base

$output

)

Function to export the renderer data in a format that is suitable for a mustache template.

This means:

1. No complex types - only stdClass, array, int, string, float, bool
2. Any additional info that is required for the template is pre-calculated (e.g. capability checks).

Parameters

renderer_base

$output

Used to do a final render of any components that need to be rendered for export.

Return values

stdClass|array

Implements templatable.

Reimplemented in MoodleQuickForm_date_time_selector, and MoodleQuickForm_date_selector.

getElementTemplateType()

MoodleQuickForm_group::getElementTemplateType

(

)

Returns element template, nodisplay/static/fieldset.

Return values

string

getHelpButton()

string MoodleQuickForm_group::getHelpButton

(

)

template type, would cause problems with client side validation so will leave for now

set html for help button

MoodleQuickForm_group()

MoodleQuickForm_group::MoodleQuickForm_group	(		$elementName = null,
			$elementLabel = null,
			$elements = null,
			$separator = null,
			$appendName = true
	)

Old syntax of class constructor.

Deprecated in PHP7.

Deprecated:

since Moodle 3.1

onQuickFormEvent()

MoodleQuickForm_group::onQuickFormEvent	(		$event,
			$arg,
		&	$caller
	)

Called by HTML_QuickForm whenever form event is made on this element.

If this function is overridden and parent is not called the element must be responsible for storing the MoodleQuickForm object, see MoodleQuickForm_group::setMoodleForm()

Parameters

string	$event	Name of event
mixed	$arg	event arguments
mixed	$caller	calling object

Reimplemented in MoodleQuickForm_modgrade, MoodleQuickForm_filetypes, MoodleQuickForm_duration, MoodleQuickForm_defaultcustom, MoodleQuickForm_date_time_selector, and MoodleQuickForm_date_selector.

setElements()

MoodleQuickForm_group::setElements

(

$elements

)

Sets the grouped elements and hides label.

Parameters

array

$elements

setMoodleForm()

MoodleQuickForm_group::setMoodleForm

(

$mform

)

Stores the form this element was added to This object is later used by MoodleQuickForm_group::createElement().

Parameters

null | MoodleQuickForm

$mform

validateSubmitValue()

MoodleQuickForm_group::validateSubmitValue

(

$values

)

Calls the validateSubmitValue function for the containing elements and returns an error string as soon as it finds one.

Parameters

array

$values

Values of the containing elements.

Return values

string|null

Validation error message or null.

Reimplemented in MoodleQuickForm_filetypes.

---

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

• lib/form/group.php