Moodle APIs 3.9
Moodle 3.9.13+ (Build: 20220325)
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
core\chart_pie Class Reference

Chart pie class. More...

Inheritance diagram for core\chart_pie:
core\chart_base renderable

Public Member Functions

 add_series (chart_series $serie)
 Add a series to the chart. More...
 
 get_doughnut ()
 Get whether the chart should be displayed as doughnut. More...
 
 get_labels ()
 Get the labels of the X axis. More...
 
 get_legend_options ()
 Get an array of options for the chart legend. More...
 
 get_series ()
 Get the series. More...
 
 get_title ()
 Get the title. More...
 
 get_type ()
 Get the chart type. More...
 
 get_xaxes ()
 Get the X axes. More...
 
 get_xaxis ($index=0, $createifnotexists=false)
 Get an X axis. More...
 
 get_yaxes ()
 Get the Y axes. More...
 
 get_yaxis ($index=0, $createifnotexists=false)
 Get a Y axis. More...
 
 jsonSerialize ()
 Get parent JSON and add specific pie related attributes and values. More...
 
 set_doughnut ($doughnut)
 Set whether the chart should be displayed as doughnut. More...
 
 set_labels (array $labels)
 Set the chart labels. More...
 
 set_legend_options (array $legendoptions)
 Set options for the chart legend. More...
 
 set_title ($title)
 Set the title. More...
 
 set_xaxis (chart_axis $axis, $index=0)
 Set an X axis. More...
 
 set_yaxis (chart_axis $axis, $index=0)
 Set an Y axis. More...
 

Protected Member Functions

 set_defaults ()
 Set the defaults for this chart type. More...
 
 validate_axis ($xy, chart_axis $axis, $index=0)
 Validate an axis. More...
 

Protected Attributes

bool $doughnut = null
 $doughnut Whether the chart should be displayed as doughnut.
 
string[] $labels = []
 The labels for the X axis when categorised.
 
array $legendoptions = []
 Options for the chart legend.
 
chart_series[] $series = []
 The series constituting this chart.
 
string $title = null
 The title of the chart.
 
chart_axis[] $xaxes = []
 The X axes.
 
chart_axis[] $yaxes = []
 The Y axes.
 

Detailed Description

Chart pie class.

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

Member Function Documentation

◆ add_series()

core\chart_base::add_series ( chart_series  $serie)
inherited

Add a series to the chart.

Parameters
chart_series$serieThe serie.

◆ get_doughnut()

core\chart_pie::get_doughnut ( )

Get whether the chart should be displayed as doughnut.

Return values
bool

◆ get_labels()

core\chart_base::get_labels ( )
inherited

Get the labels of the X axis.

Return values
string[]

◆ get_legend_options()

core\chart_base::get_legend_options ( )
inherited

Get an array of options for the chart legend.

Return values
array

◆ get_series()

core\chart_base::get_series ( )
inherited

Get the series.

Return values
chart_series[]

◆ get_title()

core\chart_base::get_title ( )
inherited

Get the title.

Return values
string

◆ get_type()

core\chart_base::get_type ( )
inherited

Get the chart type.

Return values
string

◆ get_xaxes()

core\chart_base::get_xaxes ( )
inherited

Get the X axes.

Return values
chart_axis[]

◆ get_xaxis()

core\chart_base::get_xaxis (   $index = 0,
  $createifnotexists = false 
)
inherited

Get an X axis.

Parameters
int$indexThe index of the axis.
bool$createifnotexistsWhen true, create an instance of the axis if none exist at this index yet.
Return values
chart_axis

◆ get_yaxes()

core\chart_base::get_yaxes ( )
inherited

Get the Y axes.

Return values
chart_axis[]

◆ get_yaxis()

core\chart_base::get_yaxis (   $index = 0,
  $createifnotexists = false 
)
inherited

Get a Y axis.

Parameters
int$indexThe index of the axis.
bool$createifnotexistsWhen true, create an instance of the axis if none exist at this index yet.
Return values
chart_axis

◆ jsonSerialize()

core\chart_pie::jsonSerialize ( )

Get parent JSON and add specific pie related attributes and values.

Return values
array

Reimplemented from core\chart_base.

◆ set_defaults()

core\chart_base::set_defaults ( )
protectedinherited

Set the defaults for this chart type.

Child classes can extend this to set default values on instantiation.

In general the constructor could be used, but this method is here to emphasize and self-document the default values set by the chart type.

Return values
void

Reimplemented in core\chart_bar.

◆ set_doughnut()

core\chart_pie::set_doughnut (   $doughnut)

Set whether the chart should be displayed as doughnut.

Parameters
bool$doughnutTrue for doughnut type, false for pie.

◆ set_labels()

core\chart_base::set_labels ( array  $labels)
inherited

Set the chart labels.

Parameters
string[]$labelsThe labels.

◆ set_legend_options()

core\chart_base::set_legend_options ( array  $legendoptions)
inherited

Set options for the chart legend.

See https://www.chartjs.org/docs/2.7.0/configuration/legend.html for options.

Note: Setting onClick and onHover events is not directly supported through this method. These config options must be set directly within Javascript on the page.

Parameters
array$legendoptionsWhether or not to display the chart's legend.

◆ set_title()

core\chart_base::set_title (   $title)
inherited

Set the title.

Parameters
string$titleThe title.

◆ set_xaxis()

core\chart_base::set_xaxis ( chart_axis  $axis,
  $index = 0 
)
inherited

Set an X axis.

Note that this will override any predefined axis without warning.

Parameters
chart_axis$axisThe axis.
int$indexThe index of the axis.

◆ set_yaxis()

core\chart_base::set_yaxis ( chart_axis  $axis,
  $index = 0 
)
inherited

Set an Y axis.

Note that this will override any predefined axis without warning.

Parameters
chart_axis$axisThe axis.
int$indexThe index of the axis.

◆ validate_axis()

core\chart_base::validate_axis (   $xy,
chart_axis  $axis,
  $index = 0 
)
protectedinherited

Validate an axis.

We validate this from PHP because not doing it here could result in errors being hard to trace down. For instance, if we were to add axis at keys without another axis preceding, we would effectively contain the axes in an associative array rather than a simple array, and that would have consequences on serialisation.

Parameters
string$xyAccepts x or y.
chart_axis$axisThe axis to validate.
index$indexThe index of the axis.

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