Generates the output for drag-and-drop onto image questions. More...

Inheritance diagram for qtype_ddtoimage_renderer_base:

Public Member Functions
	__call ($method, $arguments)
	Magic method used to pass calls otherwise meant for the standard renderer to it to ensure we don't go causing unnecessary grief.

	add_action_handler (component_action $action, $id=null)
	Adds a JS action for the element with the provided id.

	clear_wrong (question_attempt $qa)
	Output hidden form fields to clear any wrong parts of the student's response.

	correct_response (question_attempt $qa)
	Gereate an automatic description of the correct response to this question.

	feedback (question_attempt $qa, question_display_options $options)
	Generate the display of the outcome part of the question.

	formulation_and_controls (question_attempt $qa, question_display_options $options)
	Generate the display of the formulation part of the question.

	formulation_heading ()
	In the question output there are some class="accesshide" headers to help screen-readers.

	get_compact_logo_url ($maxwidth=300, $maxheight=300)
	Return the site's compact logo URL, if any.

	get_logo_url ($maxwidth=null, $maxheight=200)
	Return the site's logo URL, if any.

	get_page ()
	Returns the moodle page object.

	has_started ()
	Returns true is output has already started, and false if not.

	head_code (question_attempt $qa)
	Return any HTML that needs to be included in the page's <head> when this question is used.

	image_url ($imagename, $component='moodle')
	Return the moodle_url for an image.

	manual_comment (question_attempt $qa, question_display_options $options)
	Display any extra question-type specific content that should be visible when grading, if appropriate.

	pix_url ($imagename, $component='moodle')
	Return the direct URL for an image from the pix folder.

	render (renderable $widget)
	Renders the provided widget and returns the HTML to display it.

	render_from_template ($templatename, $context)
	Renders a template by name with the given context.

	should_display_main_logo ()

	should_display_navbar_logo ()
	Whether we should display the logo in the navbar.

	specific_feedback (question_attempt $qa)
	Generate the specific feedback.

Static Public Member Functions
static	prepare_classes ($classes)
	Given an array or space-separated list of classes, prepares and returns the HTML class attribute value.

Protected Member Functions
	combined_feedback (question_attempt $qa)

	feedback_class ($fraction)

	feedback_image ($fraction, $selected=true)
	Return an appropriate icon (green tick, red cross, etc.) for a grade.

	general_feedback (question_attempt $qa)
	Gereate the general feedback.

	get_mustache ()
	Return an instance of the mustache class.

	hidden_field_for_qt_var (question_attempt $qa, $varname, $value=null, $classes=null)
	Returns a hidden field for a qt variable.

	hint (question_attempt $qa, question_hint $hint)
	Gereate the specific feedback.

	num_parts_correct (question_attempt $qa)
	Gereate a brief statement of how many sub-parts of this question the student got right.

Static Protected Member Functions
static	get_url_for_image (question_attempt $qa, $filearea, $itemid=0)
	Returns the URL for an image.

Protected Attributes
xhtml_container_stack	$opencontainers
	The xhtml_container_stack to use.

renderer_base core_renderer	$output
	A reference to the current renderer.

moodle_page	$page
	The Moodle page the renderer has been created to assist with.

string	$target
	The requested rendering target.

array	$templatecache = []
	$templatecache The mustache template cache.

Detailed Description

Generates the output for drag-and-drop onto image questions.

Copyright: 2010 The Open University

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

Member Function Documentation

◆ clear_wrong()

qtype_ddtoimage_renderer_base::clear_wrong ( question_attempt $qa )

Output hidden form fields to clear any wrong parts of the student's response.

This method will only be called if the question is in read-only mode.

Parameters

question_attempt $qa the question attempt to display.

Return values

string HTML fragment.

Reimplemented from qtype_renderer.

◆ correct_response()

qtype_ddtoimage_renderer_base::correct_response ( question_attempt $qa )

Gereate an automatic description of the correct response to this question.

Not all question types can do this. If it is not possible, this method should just return an empty string.

Parameters

question_attempt $qa the question attempt to display.

Return values

string HTML fragment.

Reimplemented from qtype_renderer.

◆ feedback()

qtype_renderer::feedback	(	question_attempt	$qa,
		question_display_options	$options )

inherited

Generate the display of the outcome part of the question.

This is the area that contains the various forms of feedback. This function generates the content of this area belonging to the question type.

Subclasses will normally want to override the more specific methods {specific_feedback()}, {general_feedback()} and {correct_response()} that this method calls.

Parameters

question_attempt	$qa	the question attempt to display.
question_display_options	$options	controls what should and should not be displayed.

Return values

string HTML fragment.

Reimplemented in qtype_ordering_renderer.

◆ feedback_image()

qtype_renderer::feedback_image	(		$fraction,
			$selected = true )

protectedinherited

Return an appropriate icon (green tick, red cross, etc.) for a grade.

Parameters

float	$fraction	grade on a scale 0..1.
bool	$selected	whether to show a big or small icon. (Deprecated)

Return values

string html fragment.

Reimplemented in qtype_ordering_renderer.

◆ formulation_and_controls()

qtype_ddtoimage_renderer_base::formulation_and_controls	(	question_attempt	$qa,
		question_display_options	$options )

Generate the display of the formulation part of the question.

This is the area that contains the quetsion text, and the controls for students to input their answers. Some question types also embed bits of feedback, for example ticks and crosses, in this area.

Parameters

question_attempt	$qa	the question attempt to display.
question_display_options	$options	controls what should and should not be displayed.

Return values

string HTML fragment.

Reimplemented from qtype_renderer.

Reimplemented in qtype_ddmarker_renderer.

◆ formulation_heading()

qtype_renderer::formulation_heading ( )

inherited

In the question output there are some class="accesshide" headers to help screen-readers.

This method returns the text to use for the heading above the formulation_and_controls section.

Return values

string to use as the heading.

Reimplemented in qtype_description_renderer.

◆ general_feedback()

qtype_renderer::general_feedback ( question_attempt $qa )

protectedinherited

Gereate the general feedback.

This is feedback is shown ot all students.

Parameters

question_attempt $qa the question attempt to display.

Return values

string HTML fragment.

◆ get_url_for_image()

static qtype_ddtoimage_renderer_base::get_url_for_image	(	question_attempt	$qa,
			$filearea,
			$itemid = 0 )

staticprotected

Returns the URL for an image.

Parameters

object	$qa	Question attempt object
string	$filearea	File area descriptor
int	$itemid	Item id to get

Return values

string Output url, or null if not found

◆ head_code()

qtype_renderer::head_code ( question_attempt $qa )

inherited

Return any HTML that needs to be included in the page's <head> when this question is used.

Parameters

$qa	the question attempt that will be displayed on the page.

Return values

string HTML fragment.

◆ hidden_field_for_qt_var()

qtype_ddtoimage_renderer_base::hidden_field_for_qt_var	(	question_attempt	$qa,
			$varname,
			$value = null,
			$classes = null )

protected

Returns a hidden field for a qt variable.

Parameters

object	$qa	Question attempt object
string	$varname	The hidden var name
string	$value	The hidden value
array	$classes	Any additional css classes to apply

Return values

array Array with field name and the html of the tag

◆ hint()

qtype_renderer::hint	(	question_attempt	$qa,
		question_hint	$hint )

protectedinherited

Gereate the specific feedback.

This is feedback that varies according to the response the student gave.

Parameters

question_attempt $qa the question attempt to display.

Return values

string HTML fragment.

Reimplemented in qtype_ddmarker_renderer.

◆ manual_comment()

qtype_renderer::manual_comment	(	question_attempt	$qa,
		question_display_options	$options )

inherited

Display any extra question-type specific content that should be visible when grading, if appropriate.

Parameters

question_attempt	$qa	a question attempt.
question_display_options	$options	controls what should and should not be displayed.

Return values

string HTML fragment.

Reimplemented in qtype_essay_renderer.

◆ num_parts_correct()

qtype_renderer::num_parts_correct ( question_attempt $qa )

protectedinherited

Gereate a brief statement of how many sub-parts of this question the student got right.

Parameters

question_attempt $qa the question attempt to display.

Return values

string HTML fragment.

Reimplemented in qtype_multichoice_multi_renderer, and qtype_ordering_renderer.

◆ specific_feedback()

qtype_ddtoimage_renderer_base::specific_feedback ( question_attempt $qa )

Generate the specific feedback.

This is feedback that varies according to the response the student gave.

Parameters

question_attempt $qa the question attempt to display.

Return values

string HTML fragment.

Reimplemented from qtype_renderer.

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

question/type/ddimageortext/rendererbase.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ clear_wrong()

◆ correct_response()

◆ feedback()

◆ feedback_image()

◆ formulation_and_controls()

◆ formulation_heading()

◆ general_feedback()

◆ get_url_for_image()

◆ head_code()

◆ hidden_field_for_qt_var()

◆ hint()

◆ manual_comment()

◆ num_parts_correct()

◆ specific_feedback()