If using the new style context, re-declare this in your class to be the
React.ContextType
of your static contextType
.
Should be used with type annotation or static contextType.
static contextType = MyContext
// For TS pre-3.7:
context!: React.ContextType<typeof MyContext>
// For TS 3.7 and above:
declare context: React.ContextType<typeof MyContext>
Readonly
propsStatic
Optional
contextIf set, this.context
will be set at runtime to the current value of the given Context.
Usage:
type MyContext = number
const Ctx = React.createContext<MyContext>(0)
class Foo extends React.Component {
static contextType = Ctx
context!: React.ContextType<typeof Ctx>
render () {
return <>My context's value: {this.context}</>;
}
}
A boolean indicating whether or not to abbreviate large numbers.
Gets or sets the label format string to use for the label.
Gets or sets the format specifiers to use with the AbbreviatedLabelFormat string.
Gets the effective value for the current Interval.
let effectiveInterval: number = yAxis.actualInterval;
Determines if the axis has a valid logarithmic scale.
let effectiveLogarithmic: boolean = this.yAxis.actualIsLogarithmic
Gets or sets the ActualMajorStroke property.
The ActualMajorStroke
property is used for ActualMajorStroke of the axis.
Gets the effective maximum value for the current numeric axis object.
let effectiveMaxValue: number = yAxis.actualMaximumValue;
Gets the effective minimum value for the current numeric axis object.
let effectiveMinValue: number = yAxis.actualMinimumValue;
Gets the effective value for the current MinorInterval.
let effectiveMinorInterval: number = yAxis.actualMinorInterval;
Gets or sets the ActualMinorStroke property.
The ActualMinorStroke
property is used for ActualMinorStroke of the axis.
Gets or sets the effective stroke used for the axis.
Gets the effective visible maximum value for the current numeric axis object.
The ActualVisibleMaximumValue
is used to get the current visible maximum value for the a numeric axis. Note, at times the ActualVisibleMaximumValue
may differ from the ActualMaximumValue
, for example when the chart is zoomed.
let effectiveVisibleMaxValue: number = yAxis.actualVisibleMaximumValue;
Gets the effective minimum value for the current numeric axis object.
The actualVisibleMinimumValue
is used to get the current visible maximum value for the a numeric axis. Note, at times the actualVisibleMinimumValue
may differ from the actualMinimumValue
, for example when the chart is zoomed.
let effectiveVisibleMinValue: number = yAxis.actualVisibleMinimumValue;
Gets the current annotations for the axis.
Gets or sets how the numeric axis will adjust its range buffer to less closely fix the data from the series.
Gets or sets the coercion methods to use when loading data from data sources. Should be specified before setting any member paths, if being used. Setting it later will not cause data to be re-imported into the chart.
The coercionMethods
methods is to use when loading data from data sources. Should be specified before setting any member paths, if being used.
Setting it later will not cause data to be reimported into the chart.
Gets or sets the CrossingAxis property.
The CrossingAxis
property is used for CrossingAxis .
<IgrDataChart
dataSource={this.state.dataSource} >
<IgrNumericXAxis name="xAxis" />
<IgrNumericYAxis name="yAxis"
crossingAxisName= "xAxis"
crossingValue= {700}/>
</IgrDataChart>
Gets or sets the name to use to resolve crossingAxis from markup.
Gets or sets the CrossingValue property.
The CrossingValue
property is used for CrossingValue of the axis.
<IgrDataChart
dataSource={this.state.dataSource} >
<IgrNumericXAxis name="xAxis" />
<IgrNumericYAxis name="yAxis"
crossingAxis= "xAxis"
crossingValue= {700}/>
</IgrDataChart>
Gets or sets the minimum desired characters to be displayed for horizontal axes when using advanced label heuristics. -1 will attempt to adjust the interval to precisely fit the horizontal labels.
The EnhancedIntervalMinimumCharacters
property is used to set the mininum desired characters to be displayed for horizontal axes when using advanced label heuristics.
Gets or sets whether the enhanced interval management should prefer to show all the labels if possible without collisions for supported types of category axes. This is for use with EnhancedIntervalMinimumCharacters = -1 and axes that have an integral interval.
Gets or sets whether the series should expect that properties in its items source may be functions that need to be evaluated to yield their value. This defaults to false, as there will be a subtle performance impact to using this feature. This value must be set before assigning an item's source to take effect.
Gets or sets whether the axis should favor emitting a label at the end of the scale.
Sets or gets a function which takes an object that produces a formatted label for displaying in the chart.
Sets or gets a function which takes an object that produces a formatted label for displaying in the chart.
Sets or gets a function which takes an object that produces a formatted label for displaying in the chart.
The FormatLabel
function takes an object that produces a formatted label for displaying in the chart.
<IgrDataChart dataSource={this.data} >
<IgrCategoryXAxis
name="xAxis"
FormatLabel="xAxis_FormatLabel" />
</IgrDataChart>
Sets or gets a function which takes an object that produces a formatted label for displaying in the chart.
The FormatLabel
function takes an object that produces a formatted label for displaying in the chart.
<IgrDataChart dataSource={this.data} >
<IgrCategoryXAxis
name="xAxis"
FormatLabel="xAxis_FormatLabel" />
</IgrDataChart>
Determines if the axis has a user-defined maximum.
HasUserMinimum
is used to determine if a numeric axis has a user definied minium value.
let hasSetMinimum: boolean = this.yAxis.hasUserMinimum;
Determines if the axis has a user-defined minimum.
HasUserMaximum
is used to determine if a numeric axis has a user definied maximum value.
let hasSetMaximum: boolean = this.yAxis.hasUserMaximum;
Gets or sets the Interval property.
The Interval
is used to get or set the numeric axis major interval which specifies how frequent major gridlines and axis labels are rendered on an axis.
this.yAxis.interval = 20;
<IgrDataChart >
<IgrCategoryXAxis name="xAxisYears"
interval={12} labelLocation="OutsideBottom"
label="Year" overlap={1} gap={0.4} />
<IgrNumericYAxis name="yAxisLeft"
title="Expanse | Revenue"
minimumValue={-900}
labelLocation="OutsideLeft"
maximumValue={900}
interval={300} />
<IgrLineSeries name="series1"
valueMemberPath="Revenue"
xAxisName="xAxisMonths"
yAxisName="yAxisLeft" />
</IgrDataChart>
Gets if the current axis is of angular axis type
Gets or sets if the current axis is of category axis type
Gets if the current axis is of category date time axis type
Gets if the current axis is a continuous rather than a discrete scale
Gets or sets if the current axis is of date time axis type
Gets or sets the IsDisabled property. If true, the axis will not be rendered.
The IsDisabled
property is used to decide if the axis will not be rendered.
Gets or sets the IsInverted property.
Gets or sets the IsInverted
property.
Gets or sets the IsLogarithmic property.
IsLogarithmic
is used to get or set whether the numeric axis scaler is in linear or logarithmic mode. For logarithmic scaling, this can be used in conjunction with LogarithmBase
to further define the logarithmic scale.
this.yAxis.isLogarithmic= true;
this.yAxis.logarithmBase = 2;
<IgrDataChart >
<IgrCategoryXAxis name="xAxisYears"
interval={12} labelLocation="OutsideBottom"
label="Year" overlap={1} gap={0.4} />
<IgrNumericYAxis name="yAxisLeft"
title="Expanse | Revenue"
IsLogarithmic="True"
LogarithmBase={2}/>
<IgrLineSeries name="series1"
valueMemberPath="Revenue"
xAxisName="xAxisMonths"
yAxisName="yAxisLeft" />
</IgrDataChart>
Gets or sets if the current axis is of numeric axis type
Gets or sets if the current axis is of ordinal axis type
Gets or sets if the axis is a piecewise scaling function.
Gets or sets if the current axis is of radial axis type
Gets or sets if the current axis is sorting data items
Gets if the current axis is a vertical axis.
Gets or sets the axis label format string.
The Label
property is used for label mapping of the axis labels.
<IgrCategoryXAxis name="xAxis"
label="Country"
labelTextStyle="9pt Verdana"
labelTopMargin={5}
labelTextColor="gray" />
Gets or sets the angle of the {0}.
The Angle
property is used to set the angle of the axis.
<IgrDataChart
dataSource={this.state.dataSource}
width="700px"
height="500px">
<IgrCategoryXAxis name="xAxis"
label="Year"
titleAngle={90} />
<IgrNumericYAxis name="yAxis" />
</IgrDataChart>
<IgrCategoryXAxis name="xAxis"
title="Country"
titleTextColor="gray"
titleTextStyle="12pt Verdana"
titleAngle={90} />
Margin applied below the {0}.
The labelBottomMargin
is used to set the bottom margin of the labels.
Distance between the axis and the edge of the control.
The Extent
property is used for the extent.
<IgrDataChart
dataSource={this.state.dataSource}
width="700px"
height="500px">
<IgrCategoryXAxis name="xAxis"
label="Year"/>
<IgrNumericYAxis name="yAxis" />
</IgrDataChart>
Gets or sets the label format string to use for the label.
Gets or sets the format specifiers to use with the LabelFormat string.
Gets or sets the horizontal alignment of the {0}.
The HorizontalAlignment
property is used for the horizontal alignment.
Margin applied to the left of the {0}.
The labelLeftMargin
property is used for the left margin of the labels.
Gets or sets the location of the {0}.
The Location
property is used for the location.
Indicates the mode axis labels will operate in.
Margin applied to the right of the {0}.
The labelRightMargin
property is used for the right margin of the labels.
Gets or sets whether the first label is displayed when the zoom level is set to 1.
The ShowFirstLabel
is used to check whether the first label is displayed when the zoom level is set to 1.
The color of the {0}.
The labelTextColor
property Overrides the color of the text used for the axis labels.
<IgrDataChart
dataSource={this.state.dataSource}
width="700px"
height="500px">
<IgrCategoryXAxis name="xAxis"
label="Year"
labelTextColor="gray" />
<IgrNumericYAxis name="yAxis" />
</IgrDataChart>
<IgrCategoryXAxis name="xAxis"
title="Country"
titleTextColor="gray"
titleTextStyle="12pt Verdana"
titleAngle={90} />
Gets or sets the text style to use for axis labels.
The labelTextStyle
property Overrides the style of the text used for the axis labels.
<IgrDataChart
dataSource={this.state.dataSource}
width="700px"
height="500px">
<IgrCategoryXAxis name="xAxis"
label="Year"
titleTextStyle="12pt Verdana" />
<IgrNumericYAxis name="yAxis" />
</IgrDataChart>
<IgrCategoryXAxis name="xAxis"
title="Country"
titleTextColor="gray"
titleTextStyle="12pt Verdana"
titleAngle={90} />
Margin applied above the {0}.
The labelTopMargin
property is used for the top margin of the labels.
<IgrCategoryXAxis name="xAxis"
label="Country"
labelTextStyle="9pt Verdana"
labelTopMargin={5}
labelTextColor="gray" />
Gets or sets the vertical alignment of the {0}.
The VerticalAlignment
property is used for the vertical alignment of the axis.
Gets or sets the visibility of the {0}.
The Visibility
property is used for the visibility of the axis.
Gets or sets the LogarithmBase property.
LogarithmBase
is used to get or set logarithm base when a numeric axis is in Logarithmic scale mode. For logarithmic scaling, this is used in conjunction with IsLogarithmic
or ScaleMode
to set logarithmic scaling.
this.yAxis.scaleMode = NumericScaleMode.Logarithmic;
this.yAxis.logarithmBase = 2;
<IgrDataChart >
<IgrCategoryXAxis name="xAxisYears"
interval={12} labelLocation="OutsideBottom"
label="Year" overlap={1} gap={0.4} />
<IgrNumericYAxis name="yAxisLeft"
title="Expanse | Revenue"
ScaleMode="Logarithmic"
LogarithmBase={2}/>
<IgrLineSeries name="series1"
valueMemberPath="Revenue"
xAxisName="xAxisMonths"
yAxisName="yAxisLeft" />
</IgrDataChart>
Gets or sets the MajorStroke property. Null is treated as auto. Major lines will be displayed or not based on the axis type and series used with it.
Gets or sets the MajorStroke
using this property.
<IgrNumericYAxis name="yAxis"
interval={100}
majorStroke="black"
majorStrokeThickness={1}
minorInterval={25}
minorStroke="gray"
minorStrokeThickness={0.5} />
Gets or sets the MajorStrokeDashArray property.
Gets or sets the MajorStrokeThickness property.
Gets or sets the MajorStrokeThickness
using this property.
<IgrNumericYAxis name="yAxis"
interval={100}
majorStroke="black"
majorStrokeThickness={1}
minorInterval={25}
minorStroke="gray"
minorStrokeThickness={0.5} />
Gets or sets the MaximumValue property.
Used to set the maximum value of a numeric axis. To get the maximum value in effect on a numeric axis use ActualMaximumValue
.
this.yAxis.maximumValue = 80;
<IgrDataChart >
<IgrCategoryXAxis name="xAxisYears"
interval={12} labelLocation="OutsideBottom"
label="Year" overlap={1} gap={0.4} />
<IgrNumericYAxis name="yAxisLeft"
title="Expanse | Revenue"
minimumValue={-900}
labelLocation="OutsideLeft"
interval={300} />
<IgrLineSeries name="series1"
valueMemberPath="Revenue"
xAxisName="xAxisMonths"
yAxisName="yAxisLeft" />
</IgrDataChart>
Gets or sets the MinimumValue property.
Used to set the minimum value of a numeric axis. To get the minimum value in effect on a numeric axis use ActualMinimumValue
.
this.yAxis.minimumValue = 0;
<IgrDataChart >
<IgrCategoryXAxis name="xAxisYears"
interval={12} labelLocation="OutsideBottom"
label="Year" overlap={1} gap={0.4} />
<IgrNumericYAxis name="yAxisLeft"
title="Expanse | Revenue"
minimumValue={-900}
labelLocation="OutsideLeft"
maximumValue={900}
interval={300} />
<IgrLineSeries name="series1"
valueMemberPath="Revenue"
xAxisName="xAxisMonths"
yAxisName="yAxisLeft" />
</IgrDataChart>
Gets or sets the MinorInterval property.
The MinorInterval
is used to get or set the numeric axis minor interval which specifies how frequent minor gridlines are rendered on an axis. Please note, in order for minor gridlines to be displayed the following may also need to be set: MinorStroke
, MinorStrokeThickness
.
this.yAxis.minorInterval = 2.5;
this.yAxis.minorStroke = 'blue';
this.yAxis.minorStrokeThickness = 1;
<IgrDataChart >
<IgrCategoryXAxis name="xAxisYears"
interval={12} labelLocation="OutsideBottom"
label="Year" overlap={1} gap={0.4} />
<IgrNumericYAxis name="yAxisLeft"
title="Expanse | Revenue"
minimumValue={-900}
minorInterval= 2.5
minorStroke="blue" />
<IgrLineSeries name="series1"
valueMemberPath="Revenue"
xAxisName="xAxisMonths"
yAxisName="yAxisLeft" />
</IgrDataChart>
Gets or sets the MinorStroke property.
Gets or sets the minorStroke thickness using MinorStrokeThickness
property.
<IgrNumericYAxis name="yAxis"
interval={100}
majorStroke="black"
majorStrokeThickness={1}
minorInterval={25}
minorStroke="gray"
minorStrokeThickness={0.5} />
Gets or sets the MinorStrokeDashArray property.
Gets or sets the MinorStrokeThickness property.
Occurs when the axis range changes.
Occurs when the axis range changes.
Gets or sets the ReferenceValue property.
Used to get or set a reference value on a numeric axis which when used with an area, bar, or column series will result in the series shapes being drawn above or below the specified value.
this.yAxis.referenceValue = 30;
<IgrDataChart >
<IgrCategoryXAxis name="xAxisYears"
interval={12} labelLocation="OutsideBottom"
label="Year" overlap={1} gap={0.4} />
<IgrNumericYAxis name="yAxisLeft"
title="Expanse | Revenue"
referenceValue= {30} />
<IgrLineSeries name="series1"
valueMemberPath="Revenue"
xAxisName="xAxisMonths"
yAxisName="yAxisLeft" />
</IgrDataChart>
This event is raised every time a render has been requested from a series.
This event is raised every time a render has been requested from a series.
Gets or sets whether annotations should be shifted to avoid collision, even if this would result in them appearing where they shouldn't be along the scale.
ets or sets whether annotations should be kept in view, even if they aren't positioned where they should appear on the scale.
Indicates the angle in degress that the chart's 0th angle should be offset.
Gets or sets the Strip property.
Use Strip
property to set the strip of the chart.
<IgrCategoryChart
ref={this.onChartRef}
width="100%"
height="100%"
dataSource={this.data}
titleTopMargin={5}
xAxisStrip="gray"/>
Gets or sets the Stroke property. Null is treated as auto. The axis stroke will be displayed or not based on the axis type and series used with it.
Use Stroke
property to set the stroke of the chart.
<IgrCategoryChart
ref={this.onChartRef}
width="100%"
height="100%"
dataSource={this.data}
titleTopMargin={5}
xAxisStroke="gray"/>
Gets or sets the StrokeDashArray property.
Gets or sets the StrokeThickness property.
Use StrokeThickness
property for the thickness of the stroke.
<IgrCategoryChart
ref={this.onChartRef}
width="100%"
height="100%"
dataSource={this.data}
titleTopMargin={5}
xAxisStrokeThickness={2}>
Gets or sets the TickLength property.
Use TickLength
property for The length of the tickmarks to display for this axis.
<IgrCategoryXAxis name="xAxis"
tickLength={10}
tickStrokeThickness={0.5}
tickStroke="black" />
Gets or sets the TickStroke property.
Use TickStroke
property for the color of the tickmarks.
<IgrCategoryXAxis name="xAxis"
tickLength={10}
tickStrokeThickness={0.5}
tickStroke="black" />
Gets or sets the TickStrokeDashArray property.
Gets or sets the TickStrokeThickness property.
Use TickStrokeThickness
property for thickness of the stroke tickmarks.
<IgrCategoryXAxis name="xAxis"
tickLength={10}
tickStrokeThickness={0.5}
tickStroke="black" />
Gets or sets the Title property.
Use Title
property to display the title of the component.
<IgrCategoryXAxis name="xAxis"
title="Country"
titleTextColor="gray"
titleTextStyle="12pt Verdana"
titleAngle={90} />
Gets or sets the angle of the {0}.
The Angle
property is used to set the angle of the axis.
<IgrDataChart
dataSource={this.state.dataSource}
width="700px"
height="500px">
<IgrCategoryXAxis name="xAxis"
label="Year"
titleAngle={90} />
<IgrNumericYAxis name="yAxis" />
</IgrDataChart>
<IgrCategoryXAxis name="xAxis"
title="Country"
titleTextColor="gray"
titleTextStyle="12pt Verdana"
titleAngle={90} />
Margin applied below the {0}.
The labelBottomMargin
is used to set the bottom margin of the labels.
Distance between the axis and the edge of the control.
The Extent
property is used for the extent.
<IgrDataChart
dataSource={this.state.dataSource}
width="700px"
height="500px">
<IgrCategoryXAxis name="xAxis"
label="Year"/>
<IgrNumericYAxis name="yAxis" />
</IgrDataChart>
Gets or sets the horizontal alignment of the {0}.
The HorizontalAlignment
property is used for the horizontal alignment.
Margin applied to the left of the {0}.
The labelLeftMargin
property is used for the left margin of the labels.
Gets or sets the location of the {0}.
The Location
property is used for the location.
Gets or sets the title position relative to the axis labels.
Margin applied to the right of the {0}.
The labelRightMargin
property is used for the right margin of the labels.
Gets or sets whether the first label is displayed when the zoom level is set to 1.
The ShowFirstLabel
is used to check whether the first label is displayed when the zoom level is set to 1.
The color of the {0}.
The labelTextColor
property Overrides the color of the text used for the axis labels.
<IgrDataChart
dataSource={this.state.dataSource}
width="700px"
height="500px">
<IgrCategoryXAxis name="xAxis"
label="Year"
labelTextColor="gray" />
<IgrNumericYAxis name="yAxis" />
</IgrDataChart>
<IgrCategoryXAxis name="xAxis"
title="Country"
titleTextColor="gray"
titleTextStyle="12pt Verdana"
titleAngle={90} />
Gets or sets the text style to use for axis labels.
The labelTextStyle
property Overrides the style of the text used for the axis labels.
<IgrDataChart
dataSource={this.state.dataSource}
width="700px"
height="500px">
<IgrCategoryXAxis name="xAxis"
label="Year"
titleTextStyle="12pt Verdana" />
<IgrNumericYAxis name="yAxis" />
</IgrDataChart>
<IgrCategoryXAxis name="xAxis"
title="Country"
titleTextColor="gray"
titleTextStyle="12pt Verdana"
titleAngle={90} />
Margin applied above the {0}.
The labelTopMargin
property is used for the top margin of the labels.
<IgrCategoryXAxis name="xAxis"
label="Country"
labelTextStyle="9pt Verdana"
labelTopMargin={5}
labelTextColor="gray" />
Gets or sets the vertical alignment of the {0}.
The VerticalAlignment
property is used for the vertical alignment of the axis.
Gets or sets the visibility of the {0}.
The Visibility
property is used for the visibility of the axis.
Gets or sets whether to use more advanced heuristics when determining the initial number of labels to render, before resolving collisions, etc.
Use UseEnhancedIntervalManagement
property to gets/sets whether to use more advanced heuristics when determining the initial number of labels to render,
before resolving collisions, etc.
Gets or sets whether to use label height measurement when determining the initial number of labels to render, before resolving collisions, etc.
Optional
UNSAFE_Called immediately before mounting occurs, and before Component#render
.
Avoid introducing any side-effects or subscriptions in this method.
This method will not stop working in React 17.
Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.
16.3, use componentDidMount or the constructor instead
Optional
UNSAFE_Called when the component may be receiving new props. React may call this even if props have not changed, so be sure to compare new and existing props if you only want to handle changes.
Calling Component#setState
generally does not trigger this method.
This method will not stop working in React 17.
Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.
16.3, use static getDerivedStateFromProps instead
Optional
UNSAFE_Called immediately before rendering when new props or state is received. Not called for the initial render.
Note: You cannot call Component#setState
here.
This method will not stop working in React 17.
Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.
16.3, use getSnapshotBeforeUpdate instead
Optional
componentOptional
componentCalled immediately after updating occurs. Not called for the initial render.
The snapshot is only present if getSnapshotBeforeUpdate is present and returns non-null.
Optional
componentCalled immediately before mounting occurs, and before Component#render
.
Avoid introducing any side-effects or subscriptions in this method.
Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.
16.3, use componentDidMount or the constructor instead; will stop working in React 17
Optional
componentCalled when the component may be receiving new props. React may call this even if props have not changed, so be sure to compare new and existing props if you only want to handle changes.
Calling Component#setState
generally does not trigger this method.
Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.
16.3, use static getDerivedStateFromProps instead; will stop working in React 17
Optional
componentOptional
componentCalled immediately before rendering when new props or state is received. Not called for the initial render.
Note: You cannot call Component#setState
here.
Note: the presence of getSnapshotBeforeUpdate or getDerivedStateFromProps prevents this from being invoked.
16.3, use getSnapshotBeforeUpdate instead; will stop working in React 17
Optional
getRuns before React applies the result of render
to the document, and
returns an object to be given to componentDidUpdate. Useful for saving
things such as scroll position before render
causes changes to it.
Note: the presence of getSnapshotBeforeUpdate prevents any of the deprecated lifecycle events from running.
Unscales a value from screen space into axis space.
Unscales a value from screen space into axis space.
let dataValue: number = this.yAxis.unscaleValue(pixel);
Static
_create
Represents a IgxDataChartComponent angle based axis for polar series.