All Implemented Interfaces:
Serializable

@Generated(value="This class was generated", comments="Incorrect and missing API should be reported") public class YAxis extends Axis

The Y axis. A Highcharts map has hidden X and Y axes to control layout of the shapes and features like zooming and panning. Zooming is in effect the same as setting the extremes of one of the axes, and Highmaps is set up to make the other axis zoom the same amount.

Highmaps uses the coordinate system of the map points' path configurations.

See the Axis object for programmatic access to the axis.

Version:
$Id: $Id
Author:
Vaadin
See Also:
  • Constructor Details

    • YAxis

      public YAxis()

      Constructor for YAxis.

  • Method Details

    • getAllowDecimals

      public Boolean getAllowDecimals()

      Getter for the field allowDecimals.

      Returns:
      a Boolean object.
      See Also:
    • setAllowDecimals

      public void setAllowDecimals(Boolean allowDecimals)
      Whether to allow decimals in this axis' ticks. Ticks are hidden by default on a Highmaps axis, though they are inherited from Highcharts and can be enabled.

      Defaults to: true

      Parameters:
      allowDecimals - a Boolean object.
    • getAlternateGridColor

      public Color getAlternateGridColor()

      Getter for the field alternateGridColor.

      Returns:
      a Color object.
      See Also:
    • setAlternateGridColor

      public void setAlternateGridColor(Color alternateGridColor)
      When using an alternate grid color, a band is painted across the plot area between every other grid line.
      Parameters:
      alternateGridColor - a Color object.
    • getCrosshair

      public Crosshair getCrosshair()

      Getter for the field crosshair.

      Returns:
      a Crosshair object.
      See Also:
    • setCrosshair

      public void setCrosshair(Crosshair crosshair)
      Configure a crosshair that follows either the mouse pointer or the hovered point.

      Defaults to: false

      Parameters:
      crosshair - a Crosshair object.
    • getEndOnTick

      public Boolean getEndOnTick()

      Getter for the field endOnTick.

      Specified by:
      getEndOnTick in class Axis
      Returns:
      a Boolean object.
      See Also:
    • setEndOnTick

      public void setEndOnTick(Boolean endOnTick)
      Whether to force the axis to end on a tick. Use this option with the maxPadding option to control the axis end.

      Defaults to: false

    • getGridLineColor

      public Color getGridLineColor()

      Getter for the field gridLineColor.

      Specified by:
      getGridLineColor in class Axis
      Returns:
      a Color object.
      See Also:
    • setGridLineColor

      public void setGridLineColor(Color gridLineColor)
      Color of the grid lines extending the ticks across the plot area. Color of the grid lines extending the ticks across the plot area. Highmaps grid lines are hidden by default and can be enabled by setting the gridLineWidth option.

      Defaults to: #D8D8D8

      Specified by:
      setGridLineColor in class Axis
      Parameters:
      gridLineColor - a Color object.
    • getGridLineDashStyle

      public DashStyle getGridLineDashStyle()

      Getter for the field gridLineDashStyle.

      Specified by:
      getGridLineDashStyle in class Axis
      Returns:
      a DashStyle object.
      See Also:
    • setGridLineDashStyle

      public void setGridLineDashStyle(DashStyle gridLineDashStyle)
      The dash or dot style of the grid lines. The dash or dot style of the grid lines. For possible values, see this demonstration.

      Defaults to: Solid

      Specified by:
      setGridLineDashStyle in class Axis
      Parameters:
      gridLineDashStyle - a DashStyle object.
    • getGridLineWidth

      public Number getGridLineWidth()

      Getter for the field gridLineWidth.

      Specified by:
      getGridLineWidth in class Axis
      Returns:
      a Number object.
      See Also:
    • setGridLineWidth

      public void setGridLineWidth(Number gridLineWidth)
      The width of the grid lines extending the ticks across the plot area. The width of the grid lines extending the ticks across the plot area.

      Defaults to: 0

      Specified by:
      setGridLineWidth in class Axis
      Parameters:
      gridLineWidth - a Number object.
    • getId

      public String getId()

      Getter for the field id.

      Specified by:
      getId in class Axis
      Returns:
      a String object.
      See Also:
    • setId

      public void setId(String id)
      An id for the axis. This can be used after render time to get a pointer to the axis object through chart.get(). An id for the axis. This can be used after render time to get a pointer to the axis object through chart.get().
      Specified by:
      setId in class Axis
      Parameters:
      id - a String object.
    • getLabels

      public Labels getLabels()

      Getter for the field labels.

      Specified by:
      getLabels in class Axis
      Returns:
      a Labels object.
      See Also:
    • setLabels

      public void setLabels(Labels labels)
      The axis labels show the number or category for each tick.

      The axis labels show the number or category for each tick. X and Y axis labels are by default disabled in Highmaps, but the functionality is inherited from Highcharts and used on colorAxis, and can be enabled on X and Y axes too.

      For more live examples on label options, see yAxis.labels in the Highcharts API.

      Specified by:
      setLabels in class Axis
      Parameters:
      labels - a Labels object.
    • getLineColor

      public Color getLineColor()

      Getter for the field lineColor.

      Returns:
      a Color object.
      See Also:
    • setLineColor

      public void setLineColor(Color lineColor)
      The color of the line marking the axis itself.

      Defaults to: #C0D0E0

      Parameters:
      lineColor - a Color object.
    • getLineWidth

      public Number getLineWidth()

      Getter for the field lineWidth.

      Returns:
      a Number object.
      See Also:
    • setLineWidth

      public void setLineWidth(Number lineWidth)
      The width of the line marking the axis itself.

      Defaults to: 0

      Parameters:
      lineWidth - a Number object.
    • getMaxPadding

      public Number getMaxPadding()

      Getter for the field maxPadding.

      Specified by:
      getMaxPadding in class Axis
      Returns:
      a Number object.
      See Also:
    • setMaxPadding

      public void setMaxPadding(Number maxPadding)
      Padding of the max value relative to the length of the axis. A padding of 0.05 will make a 100px axis 5px longer. This is useful when you don't want the highest data value to appear on the edge of the plot area. When the axis' max option is set or a max extreme is set using axis.setExtremes(), the maxPadding will be ignored. Padding of the max value relative to the length of the axis. A padding of 0.05 will make a 100px axis 5px longer. This is useful when you don't want the map shapes to touch the plot border. When the axis' max option is set or a max extreme is set using axis.setExtremes(), the maxPadding will be ignored.

      Defaults to: 0

      Specified by:
      setMaxPadding in class Axis
      Parameters:
      maxPadding - a Number object.
    • getMinPadding

      public Number getMinPadding()

      Getter for the field minPadding.

      Specified by:
      getMinPadding in class Axis
      Returns:
      a Number object.
      See Also:
    • setMinPadding

      public void setMinPadding(Number minPadding)
      Padding of the min value relative to the length of the axis. A padding of 0.05 will make a 100px axis 5px longer. This is useful when you don't want the lowest data value to appear on the edge of the plot area. When the axis' min option is set or a min extreme is set using axis.setExtremes(), the minPadding will be ignored. Padding of the min value relative to the length of the axis. A padding of 0.05 will make a 100px axis 5px longer. This is useful when you don't want the map shapes to touch the plot border. When the axis' min option is set or a min extreme is set using axis.setExtremes(), the minPadding will be ignored.

      Defaults to: 0

      Specified by:
      setMinPadding in class Axis
      Parameters:
      minPadding - a Number object.
    • getMinRange

      public Number getMinRange()

      Getter for the field minRange.

      Returns:
      a Number object.
      See Also:
    • setMinRange

      public void setMinRange(Number minRange)

      The minimum range to display on this axis. The entire axis will not be allowed to span over a smaller interval than this, in terms of shape path coordinates. Defaults to 5 times the size of the smallest area.

      Note that the minPadding, maxPadding, startOnTick and endOnTick settings also affect how the extremes of the axis are computed.

      Parameters:
      minRange - a Number object.
    • getMinTickInterval

      public Number getMinTickInterval()

      Getter for the field minTickInterval.

      Returns:
      a Number object.
      See Also:
    • setMinTickInterval

      public void setMinTickInterval(Number minTickInterval)
      The minimum tick interval allowed in axis values. For example on zooming in on an axis with daily data, this can be used to prevent the axis from showing hours. In Highmaps, ticks are hidden by default.
      Parameters:
      minTickInterval - a Number object.
    • getMinorGridLineColor

      public Color getMinorGridLineColor()

      Getter for the field minorGridLineColor.

      Specified by:
      getMinorGridLineColor in class Axis
      Returns:
      a Color object.
      See Also:
    • setMinorGridLineColor

      public void setMinorGridLineColor(Color minorGridLineColor)
      Color of the minor, secondary grid lines. Color of the minor, secondary grid lines.

      Defaults to: #E0E0E0

      Specified by:
      setMinorGridLineColor in class Axis
      Parameters:
      minorGridLineColor - a Color object.
    • getMinorGridLineDashStyle

      public DashStyle getMinorGridLineDashStyle()

      Getter for the field minorGridLineDashStyle.

      Specified by:
      getMinorGridLineDashStyle in class Axis
      Returns:
      a DashStyle object.
      See Also:
    • setMinorGridLineDashStyle

      public void setMinorGridLineDashStyle(DashStyle minorGridLineDashStyle)
      The dash or dot style of the minor grid lines. The dash or dot style of the minor grid lines. For possible values, see this demonstration.

      Defaults to: Solid

      Specified by:
      setMinorGridLineDashStyle in class Axis
      Parameters:
      minorGridLineDashStyle - a DashStyle object.
    • getMinorGridLineWidth

      public Number getMinorGridLineWidth()

      Getter for the field minorGridLineWidth.

      Specified by:
      getMinorGridLineWidth in class Axis
      Returns:
      a Number object.
      See Also:
    • setMinorGridLineWidth

      public void setMinorGridLineWidth(Number minorGridLineWidth)
      Width of the minor, secondary grid lines. Width of the minor, secondary grid lines.

      Defaults to: 1

      Specified by:
      setMinorGridLineWidth in class Axis
      Parameters:
      minorGridLineWidth - a Number object.
    • getMinorTickColor

      public Color getMinorTickColor()

      Getter for the field minorTickColor.

      Specified by:
      getMinorTickColor in class Axis
      Returns:
      a Color object.
      See Also:
    • setMinorTickColor

      public void setMinorTickColor(Color minorTickColor)
      Color for the minor tick marks. Color for the minor tick marks.

      Defaults to: #A0A0A0

      Specified by:
      setMinorTickColor in class Axis
      Parameters:
      minorTickColor - a Color object.
    • getMinorTickInterval

      public String getMinorTickInterval()

      Getter for the field minorTickInterval.

      Specified by:
      getMinorTickInterval in class Axis
      Returns:
      a String object.
      See Also:
    • setMinorTickInterval

      public void setMinorTickInterval(String minorTickInterval)

      Tick interval in scale units for the minor ticks. On a linear axis, if "auto", the minor tick interval is calculated as a fifth of the tickInterval. If null, minor ticks are not shown.

      On logarithmic axes, the unit is the power of the value. For example, setting the minorTickInterval to 1 puts one tick on each of 0.1, 1, 10, 100 etc. Setting the minorTickInterval to 0.1 produces 9 ticks between 1 and 10, 10 and 100 etc. A minorTickInterval of "auto" on a log axis results in a best guess, attempting to enter approximately 5 minor ticks between each major tick.

      If user settings dictate minor ticks to become too dense, they don't make sense, and will be ignored to prevent performance problems.

      On axes using categories, minor ticks are not supported.

      Tick interval in scale units for the minor ticks. On a linear axis, if "auto", the minor tick interval is calculated as a fifth of the tickInterval. If null, minor ticks are not shown.

      On logarithmic axes, the unit is the power of the value. For example, setting the minorTickInterval to 1 puts one tick on each of 0.1, 1, 10, 100 etc. Setting the minorTickInterval to 0.1 produces 9 ticks between 1 and 10, 10 and 100 etc. A minorTickInterval of "auto" on a log axis results in a best guess, attempting to enter approximately 5 minor ticks between each major tick.

      If user settings dictate minor ticks to become too dense, they don't make sense, and will be ignored to prevent performance problems.

      Specified by:
      setMinorTickInterval in class Axis
      Parameters:
      minorTickInterval - a String object.
    • getMinorTickLength

      public Number getMinorTickLength()

      Getter for the field minorTickLength.

      Specified by:
      getMinorTickLength in class Axis
      Returns:
      a Number object.
      See Also:
    • setMinorTickLength

      public void setMinorTickLength(Number minorTickLength)
      The pixel length of the minor tick marks. The pixel length of the minor tick marks.

      Defaults to: 2

      Specified by:
      setMinorTickLength in class Axis
      Parameters:
      minorTickLength - a Number object.
    • getMinorTickPosition

      public TickPosition getMinorTickPosition()

      Getter for the field minorTickPosition.

      Specified by:
      getMinorTickPosition in class Axis
      Returns:
      a TickPosition object.
      See Also:
    • setMinorTickPosition

      public void setMinorTickPosition(TickPosition minorTickPosition)
      The position of the minor tick marks relative to the axis line. Can be one of inside and outside. The position of the minor tick marks relative to the axis line. Can be one of inside and outside.

      Defaults to: outside

      Specified by:
      setMinorTickPosition in class Axis
      Parameters:
      minorTickPosition - a TickPosition object.
    • getMinorTickWidth

      public Number getMinorTickWidth()

      Getter for the field minorTickWidth.

      Specified by:
      getMinorTickWidth in class Axis
      Returns:
      a Number object.
      See Also:
    • setMinorTickWidth

      public void setMinorTickWidth(Number minorTickWidth)
      The pixel width of the minor tick mark. The pixel width of the minor tick mark.

      Defaults to: 0

      Specified by:
      setMinorTickWidth in class Axis
      Parameters:
      minorTickWidth - a Number object.
    • getOffset

      public Number getOffset()

      Getter for the field offset.

      Returns:
      a Number object.
      See Also:
    • setOffset

      public void setOffset(Number offset)
      The distance in pixels from the plot area to the axis line. A positive offset moves the axis with it's line, labels and ticks away from the plot area. This is typically used when two or more axes are displayed on the same side of the plot. With multiple axes the offset is dynamically adjusted to avoid collision, this can be overridden by setting offset explicitly.

      Defaults to: 0

      Parameters:
      offset - a Number object.
    • getOpposite

      public Boolean getOpposite()

      Getter for the field opposite.

      Returns:
      a Boolean object.
      See Also:
    • setOpposite

      public void setOpposite(Boolean opposite)
      Whether to display the axis on the opposite side of the normal. The normal is on the left side for vertical axes and bottom for horizontal, so the opposite sides will be right and top respectively.

      Defaults to: false

      Parameters:
      opposite - a Boolean object.
    • getReversed

      public Boolean getReversed()

      Getter for the field reversed.

      Specified by:
      getReversed in class Axis
      Returns:
      a Boolean object.
      See Also:
    • setReversed

      public void setReversed(Boolean reversed)
      Whether to reverse the axis so that the highest number is closest to the origin. Whether to reverse the axis so that the highest number is closest to the origin.

      Defaults to: false

      Specified by:
      setReversed in class Axis
      Parameters:
      reversed - a Boolean object.
    • getShowEmpty

      public Boolean getShowEmpty()

      Getter for the field showEmpty.

      Returns:
      a Boolean object.
      See Also:
    • setShowEmpty

      public void setShowEmpty(Boolean showEmpty)
      Whether to show the axis line and title when the axis has no data. By default Highmaps X and Y axis don't have visible line and title regardless.

      Defaults to: true

      Parameters:
      showEmpty - a Boolean object.
    • getShowFirstLabel

      public Boolean getShowFirstLabel()

      Getter for the field showFirstLabel.

      Specified by:
      getShowFirstLabel in class Axis
      Returns:
      a Boolean object.
      See Also:
    • setShowFirstLabel

      public void setShowFirstLabel(Boolean showFirstLabel)
      Whether to show the first tick label. If labels are enabled, whether to show the first tick label.

      Defaults to: true

      Specified by:
      setShowFirstLabel in class Axis
      Parameters:
      showFirstLabel - a Boolean object.
    • getShowLastLabel

      public Boolean getShowLastLabel()

      Getter for the field showLastLabel.

      Specified by:
      getShowLastLabel in class Axis
      Returns:
      a Boolean object.
      See Also:
    • setShowLastLabel

      public void setShowLastLabel(Boolean showLastLabel)
      Whether to show the last tick label. If labels are enabled, whether to show the last tick label.

      Defaults to: true

      Specified by:
      setShowLastLabel in class Axis
      Parameters:
      showLastLabel - a Boolean object.
    • getStartOnTick

      public Boolean getStartOnTick()

      Getter for the field startOnTick.

      Specified by:
      getStartOnTick in class Axis
      Returns:
      a Boolean object.
      See Also:
    • setStartOnTick

      public void setStartOnTick(Boolean startOnTick)
      Whether to force the axis to start on a tick. Use this option with the minPadding option to control the axis start. Whether to force the axis to start on a tick. Use this option with the minPadding option to control the axis start.

      Defaults to: false

      Specified by:
      setStartOnTick in class Axis
      Parameters:
      startOnTick - a Boolean object.
    • getTickColor

      public Color getTickColor()

      Getter for the field tickColor.

      Specified by:
      getTickColor in class Axis
      Returns:
      a Color object.
      See Also:
    • setTickColor

      public void setTickColor(Color tickColor)
      Color for the main tick marks. Color for the main tick marks.

      Defaults to: #C0D0E0

      Specified by:
      setTickColor in class Axis
      Parameters:
      tickColor - a Color object.
    • getTickInterval

      public Number getTickInterval()

      Getter for the field tickInterval.

      Specified by:
      getTickInterval in class Axis
      Returns:
      a Number object.
      See Also:
    • setTickInterval

      public void setTickInterval(Number tickInterval)

      The interval of the tick marks in axis units. When null, the tick interval is computed to approximately follow the tickPixelInterval on linear and datetime axes. On categorized axes, a null tickInterval will default to 1, one category. Note that datetime axes are based on milliseconds, so for example an interval of one day is expressed as 24 * 3600 * 1000.

      On logarithmic axes, the tickInterval is based on powers, so a tickInterval of 1 means one tick on each of 0.1, 1, 10, 100 etc. A tickInterval of 2 means a tick of 0.1, 10, 1000 etc. A tickInterval of 0.2 puts a tick on 0.1, 0.2, 0.4, 0.6, 0.8, 1, 2, 4, 6, 8, 10, 20, 40 etc.

      If the tickInterval is too dense for labels to be drawn, Highcharts may remove ticks.

      The interval of the tick marks in axis units. When null, the tick interval is computed to approximately follow the tickPixelInterval.

      Specified by:
      setTickInterval in class Axis
      Parameters:
      tickInterval - a Number object.
    • getTickLength

      public Number getTickLength()

      Getter for the field tickLength.

      Specified by:
      getTickLength in class Axis
      Returns:
      a Number object.
      See Also:
    • setTickLength

      public void setTickLength(Number tickLength)
      The pixel length of the main tick marks. The pixel length of the main tick marks.

      Defaults to: 10

      Specified by:
      setTickLength in class Axis
      Parameters:
      tickLength - a Number object.
    • getTickPixelInterval

      public Number getTickPixelInterval()

      Getter for the field tickPixelInterval.

      Specified by:
      getTickPixelInterval in class Axis
      Returns:
      a Number object.
      See Also:
    • setTickPixelInterval

      public void setTickPixelInterval(Number tickPixelInterval)
      If tickInterval is null this option sets the approximate pixel interval of the tick marks. Not applicable to categorized axis. If tickInterval is null this option sets the approximate pixel interval of the tick marks. Defaults to 72 for the Y axis and 100 for the X axis.
      Specified by:
      setTickPixelInterval in class Axis
      Parameters:
      tickPixelInterval - a Number object.
    • getTickPosition

      public TickPosition getTickPosition()

      Getter for the field tickPosition.

      Specified by:
      getTickPosition in class Axis
      Returns:
      a TickPosition object.
      See Also:
    • setTickPosition

      public void setTickPosition(TickPosition tickPosition)
      The position of the major tick marks relative to the axis line. Can be one of inside and outside. The position of the major tick marks relative to the axis line. Can be one of inside and outside.

      Defaults to: outside

      Specified by:
      setTickPosition in class Axis
      Parameters:
      tickPosition - a TickPosition object.
    • getTickPositions

      public Number[] getTickPositions()

      Getter for the field tickPositions.

      Specified by:
      getTickPositions in class Axis
      Returns:
      an array of Number objects.
      See Also:
    • setTickPositions

      public void setTickPositions(Number[] tickPositions)
      An array defining where the ticks are laid out on the axis. This overrides the default behaviour of tickPixelInterval and tickInterval.
      Specified by:
      setTickPositions in class Axis
      Parameters:
      tickPositions - an array of Number objects.
    • getTickWidth

      public Number getTickWidth()

      Getter for the field tickWidth.

      Specified by:
      getTickWidth in class Axis
      Returns:
      a Number object.
      See Also:
    • setTickWidth

      public void setTickWidth(Number tickWidth)
      The pixel width of the major tick marks. The pixel width of the major tick marks.

      Defaults to: 0

      Specified by:
      setTickWidth in class Axis
      Parameters:
      tickWidth - a Number object.
    • getTitle

      public AxisTitle getTitle()

      Getter for the field title.

      Returns:
      a AxisTitle object.
      See Also:
    • setTitle

      public void setTitle(AxisTitle title)
      The axis title. In Highmaps, the axis is hidden by default, but adding an axis title is still possible. X axis and Y axis titles will appear at the bottom and left by default.
      Parameters:
      title - a AxisTitle object.
    • setTitle

      public void setTitle(String title)

      Setter for the field title.

      Parameters:
      title - a String object.