API Docs for: 3.18.1

CategoryImpl Class

Defined in: charts/js/CategoryImpl.js:9
Module: axis-category-base
Parent Module: charts

CategoryImpl contains logic for managing category data. CategoryImpl is used by the following classes:

Constructor

CategoryImpl

()

Defined in charts/js/CategoryImpl.js:9

Methods

formatLabel

(
  • value
)

Defined in charts/js/CategoryImpl.js:63

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

Parameters:

Returns:

String

getDataByKey

(
  • value
)

Defined in charts/js/CategoryImpl.js:143

Returns an array of values based on an identifier key.

Parameters:

  • value String

    value used to identify the array

Returns:

Array

getKeyValueAt

(
  • key
  • index
)

Defined in charts/js/CategoryImpl.js:210

Returns a value based of a key value and an index.

Parameters:

  • key String

    value used to look up the correct array

  • index Number

    within the array

Returns:

String

getTotalMajorUnits

(
  • majorUnit
  • len
)

Defined in charts/js/CategoryImpl.js:164

Returns the total number of majorUnits that will appear on an axis.

Parameters:

  • majorUnit Object

    Object containing properties related to the majorUnit.

  • len Number

    Length of the axis.

Returns:

Number

Properties

Attributes

calculateEdgeOffset

Boolean

Defined in charts/js/CategoryImpl.js:39

Determines whether and offset is automatically calculated for the edges of the axis.

Fires event calculateEdgeOffsetChange

Fires when the value for the configuration attribute calculateEdgeOffset 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

Defined in charts/js/CategoryImpl.js:27

Pattern used by the labelFunction to format a label. The default labelFunction values for CategoryAxis and CategoryAxisBase do not accept a format object. This value can be used by a custom method.

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

Defined in charts/js/CategoryImpl.js:49

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 HTMLElement.

val
Label to be formatted. (String)
format
Template for formatting 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.