Difference between revisions of "Widget Editor Theme Tab"

From dataZoa Wiki
Jump to: navigation, search
m
m
Line 3: Line 3:
 
=== Themes: ===
 
=== Themes: ===
 
<div style="margin: 2em; margin-left: 6em;">
 
<div style="margin: 2em; margin-left: 6em;">
Select a theme to use in applying colors and style to the Widget. There are a handful of preconfigured themes to choose from with their basic affects displayed in the <i>Theme Preview</i> to the right. The <i>Theme Preview</i> can also be used to view the source code of the applied theme which can be useful for learning how to construct a custom themes or specific enhancements.
+
Select a theme to use in applying colors and style to the Widget. There are a handful of preconfigured themes to choose from with their basic affects visible in the <i>Theme Preview</i> to the right.
 +
<br><div class="imgGlyph24 imgIdea"></div> The <i>Theme Preview</i> can also be used to view the source code of the applied theme which can be useful for learning how to construct custom themes or specific enhancements.
 
</div>
 
</div>
  
Line 16: Line 17:
 
* Namespace your theme object as: <i>Highchart.theme = {...}</i>
 
* Namespace your theme object as: <i>Highchart.theme = {...}</i>
 
* After creation, apply your theme via: <i>Highcharts.setOptions(Highcharts.theme);</i>
 
* After creation, apply your theme via: <i>Highcharts.setOptions(Highcharts.theme);</i>
 +
 +
<br><div class="imgGlyph24 imgIdea"></div> Can be used to load Highcharts plugins and modules in addition to custom themes.
 
</div>
 
</div>
  
Line 23: Line 26:
 
* Enhancements must be entered as a valid [[Javascript Object Literal|JavaScript object literal]] which will be applied after the applied theme and a handful of preset dataZoa options for full flexability.
 
* Enhancements must be entered as a valid [[Javascript Object Literal|JavaScript object literal]] which will be applied after the applied theme and a handful of preset dataZoa options for full flexability.
 
* Only options and properties recognized by Highcharts will have an affect... [https://api.highcharts.com/highcharts/ Highcharts Options Reference]
 
* Only options and properties recognized by Highcharts will have an affect... [https://api.highcharts.com/highcharts/ Highcharts Options Reference]
 +
* Widgets are loaded with the following Highcharts modules in affect: <i>Data, 3D, Boots, More and Exporting</i>
 
* <div class="imgGlyph24 imgNote"></div> Use the full <b>Preview</b> tan to visualize the affects of enhancements. Such changes are <i>not</i> reflected in the <i>Theme Preview</i>.
 
* <div class="imgGlyph24 imgNote"></div> Use the full <b>Preview</b> tan to visualize the affects of enhancements. Such changes are <i>not</i> reflected in the <i>Theme Preview</i>.
  
<br>Examples:
+
<br>Enhancement Examples:
 
<table class="Gbb1" style="width:100%;">
 
<table class="Gbb1" style="width:100%;">
 
  <tr><td>Description or enhancement</td><td>Code for enhancement</td></tr>
 
  <tr><td>Description or enhancement</td><td>Code for enhancement</td></tr>

Revision as of 06:57, 11 September 2018

Themes:

Select a theme to use in applying colors and style to the Widget. There are a handful of preconfigured themes to choose from with their basic affects visible in the Theme Preview to the right.


The Theme Preview can also be used to view the source code of the applied theme which can be useful for learning how to construct custom themes or specific enhancements.


  Advanced Options

Remote Theme:

Optionally bypass all the preconfigured themes by linking to a custom remote theme file.

  • Using https is required to ensure proper loading of themes
  • Themes are JavaScript files which set and apply Highchart options
  • Namespace your theme object as: Highchart.theme = {...}
  • After creation, apply your theme via: Highcharts.setOptions(Highcharts.theme);

Can be used to load Highcharts plugins and modules in addition to custom themes.

Enhancements:

Enhance or override any setting of the applied theme (e.g. add a subtitle, change fonts, refine tooltip behavior...)

  • Enhancements must be entered as a valid JavaScript object literal which will be applied after the applied theme and a handful of preset dataZoa options for full flexability.
  • Only options and properties recognized by Highcharts will have an affect... Highcharts Options Reference
  • Widgets are loaded with the following Highcharts modules in affect: Data, 3D, Boots, More and Exporting
  • Use the full Preview tan to visualize the affects of enhancements. Such changes are not reflected in the Theme Preview.


Enhancement Examples:

Description or enhancementCode for enhancement
Move legend to right of chart (particularly useful for pie type displays).
{
   legend: { layout:'vertical', align:'right', verticalAlign:'middle' }
}
Enable crosshairs on hover for x axis only.
{
   tooltip: { crosshairs:[true] }
}
Enable crosshairs on hover for y axis only.
{
   tooltip: { crosshairs:[false, true] }
}
Enable crosshairs on hover for both axes.
{
   tooltip: { crosshairs:[true,true] }
}
Change y axis to logarithmic scale.
{
   yAxis: { type:'logarithmic' }
}
Display y axis on opposite (right) side.
{
   yAxis: { opposite:true }
}
Add prefix/suffix to y axis labels.
{
   yAxis: { labels: { format:'${value} USD' } }
}
Add prefix/suffix to y axis labels while maintaining normal value decimating.
{
   yAxis: { labels: { formatter:function(){ return '$'+this.axis.defaultLabelFormatter.call(this)+' USD'; } } }
}
Force y axis labels to use 2 decimal points of precision.
{
   yAxis: { labels: { format:'{value:.2f}' } }
}