Version 3.17.2
Show:

NumericImpl Class

Module: axis-numeric-base
Parent Module: charts

NumericImpl contains logic for numeric data. NumericImpl is used by the following classes:

Constructor

NumericImpl

()

Methods

_getCoordFromValue

(
  • min
  • max
  • length
  • dataValue
  • offset
  • reverse
)
private

Returns a coordinate corresponding to a data values.

Parameters:

  • min Number

    The minimum for the axis.

  • max Number

    The maximum for the axis.

  • length Number

    The distance that the axis spans.

  • dataValue Number

    A value used to ascertain the coordinate.

  • offset Number

    Value in which to offset the coordinates.

  • reverse Boolean

    Indicates whether the coordinates should start from the end of an axis. Only used in the numeric implementation.

Returns:

Number

_getMinimumUnit

(
  • max
  • min
  • units
)
private

Helper method for getting a roundingUnit when calculating the minimum and maximum values.

Parameters:

  • max Number

    Maximum number

  • min Number

    Minimum number

  • units Number

    Number of units on the axis

Returns:

Number

_getNiceNumber

(
  • roundingUnit
)
private

Calculates a nice rounding unit based on the range.

Parameters:

  • roundingUnit Number

    The calculated rounding unit.

Returns:

Number

_roundDownToNearest

(
  • number
  • nearest
)
private

Rounds a Number down to the nearest multiple of an input. For example, by rounding 16 down to the nearest 10, you will receive 10. Similar to the built-in function Math.floor().

Parameters:

  • number Number

    Number to round

  • nearest Number

    Multiple to round towards.

Returns:

Number

_roundMinAndMax

(
  • min
  • max
)
private

Rounds the mimimum and maximum values based on the roundingUnit attribute.

Parameters:

_roundToNearest

(
  • number
  • nearest
)
private

Rounds a Number to the nearest multiple of an input. For example, by rounding 16 to the nearest 10, you will receive 20. Similar to the built-in function Math.round().

Parameters:

  • number Number

    Number to round

  • nearest Number

    Multiple to round towards.

Returns:

Number

_roundToPrecision

(
  • number
  • precision
)
private

Rounds a number to a certain level of precision. Useful for limiting the number of decimal places on a fractional number.

Parameters:

  • number Number

    Number to round

  • precision Number

    Multiple to round towards.

Returns:

Number

_roundUpToNearest

(
  • number
  • nearest
)
private

Rounds a Number up to the nearest multiple of an input. For example, by rounding 16 up to the nearest 10, you will receive 20. Similar to the built-in function Math.ceil().

Parameters:

  • number Number

    Number to round

  • nearest Number

    Multiple to round towards.

Returns:

Number

(
  • value
  • format
)

Formats a label based on the axis type and optionally specified format.

Parameters:

  • value Object
  • format Object

    Pattern used to format the value.

Returns:

String

_updateMinAndMax

() private

Calculates the maximum and minimum values for the Data.

getOrigin

()

Returns the value corresponding to the origin on the axis.

Returns:

Number

getTotalByKey

(
  • key
)

Returns the sum of all values per key.

Parameters:

  • key String

    The identifier for the array whose values will be calculated.

Returns:

Number

initializer

() private

Properties

_type

Unknown private

Type of data used in Data.

Attributes

alwaysShowZero

Boolean

Indicates whether 0 should always be displayed.

Fires event alwaysShowZeroChange

Fires when the value for the configuration attribute alwaysShowZero is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

labelFormat

Object

Object containing properties used by the labelFunction to format a label.

Fires event labelFormatChange

Fires when the value for the configuration attribute labelFormat is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

labelFunction

Function

Method used for formatting a label. This attribute allows for the default label formatting method to overridden. The method use would need to implement the arguments below and return a String or an HTMLElement. The default implementation of the method returns a String. The output of this method will be rendered to the DOM using appendChild. If you override the labelFunction method and return an html string, you will also need to override the Data' appendLabelFunction to accept html as a String.

val
Label to be formatted. (String)
format
Object containing properties used to format the label. (optional)

Fires event labelFunctionChange

Fires when the value for the configuration attribute labelFunction is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

roundingMethod

String

Indicates how to round unit values.

niceNumber
Units will be smoothed based on the number of ticks and data range.
auto
If the range is greater than 1, the units will be rounded.
numeric value
Units will be equal to the numeric value.
null
No rounding will occur.

Default: niceNumber

Fires event roundingMethodChange

Fires when the value for the configuration attribute roundingMethod is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

String

Indicates the scaling for the chart. The default value is linear. For a logarithmic axis, set the value to logarithmic.

Default: linear

Fires event Change

Fires when the value for the configuration attribute `` is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.