Icard/angular-clarity-master(work.../node_modules/highcharts/modules/accessibility.src.d.ts

212 lines
7.2 KiB
TypeScript
Raw Permalink Normal View History

2024-07-16 14:55:36 +00:00
/*!*
*
* Copyright (c) Highsoft AS. All rights reserved.
*
*!*/
import * as globals from "../globals.src";
import * as _Highcharts from "../highcharts.src";
/**
* Adds the module to the imported Highcharts namespace.
*
* @param highcharts
* The imported Highcharts namespace to extend.
*/
export function factory(highcharts: typeof Highcharts): void;
declare module "../highcharts.src" {
interface Chart {
/**
* Apply context to a format string from lang options of the chart.
*
* @param langKey
* Key (using dot notation) into lang option structure.
*
* @param context
* Context to apply to the format string.
*
* @return The formatted string.
*/
langFormat(langKey: string, context: Dictionary<any>): string;
}
/**
* Options for the keyboard navigation handler.
*/
interface KeyboardNavigationHandlerOptionsObject {
/**
* Function to run on initialization of module.
*/
init: Function;
/**
* An array containing pairs of an array of keycodes, mapped to a
* handler function. When the keycode is received, the handler is called
* with the keycode as parameter.
*/
keyCodeMap: Array<[Array<number>, Function]>;
/**
* Function to run before moving to next/prev module. Receives moving
* direction as parameter: +1 for next, -1 for previous.
*/
terminate?: Function;
/**
* Function to run to validate module. Should return false if module
* should not run, true otherwise. Receives chart as parameter.
*/
validate?: Function;
}
interface PointAccessibilityOptionsObject {
/**
* Provide a description of the data point, announced to screen readers.
*/
description?: string;
/**
* Enable or disable exposing the point to assistive technology
*/
enabled?: boolean;
}
interface PointOptionsObject {
accessibility?: PointAccessibilityOptionsObject;
}
/**
* The AccessibilityComponent base class, representing a part of the chart
* that has accessibility logic connected to it. This class can be inherited
* from to create a custom accessibility component for a chart.
*
* Components should take care to destroy added elements and unregister
* event handlers on destroy. This is handled automatically if using
* this.addEvent and this.createElement.
*/
class AccessibilityComponent {
/**
* Called when accessibility is disabled or chart is destroyed.
*/
static destroy(): void;
/**
* Called on component initialization.
*/
static init(): void;
/**
* Called on every chart render.
*/
static onChartRender(): void;
/**
* Called on updates to the chart, including options changes. Note that
* this is also called on first render of chart.
*/
static onChartUpdate(): void;
}
/**
* Define a keyboard navigation handler for use with a
* Highcharts.AccessibilityComponent instance. This functions as an
* abstraction layer for keyboard navigation, and defines a map of keyCodes
* to handler functions.
*/
class KeyboardNavigationHandler {
/**
* Define a keyboard navigation handler for use with a
* Highcharts.AccessibilityComponent instance. This functions as an
* abstraction layer for keyboard navigation, and defines a map of
* keyCodes to handler functions.
*
* @param chart
* The chart this module should act on.
*
* @param options
* Options for the keyboard navigation handler.
*/
constructor(chart: Chart, options: KeyboardNavigationHandlerOptionsObject);
}
/**
* i18n formatting function. Extends Highcharts.format() functionality by
* also handling arrays and plural conditionals. Arrays can be indexed as
* follows:
*
* - Format: 'This is the first index: {myArray[0]}. The last:
* {myArray[-1]}.'
*
* - Context: { myArray: [0, 1, 2, 3, 4, 5] }
*
* - Result: 'This is the first index: 0. The last: 5.'
*
* They can also be iterated using the #each() function. This will repeat
* the contents of the bracket expression for each element. Example:
*
* - Format: 'List contains: {#each(myArray)cm }'
*
* - Context: { myArray: [0, 1, 2] }
*
* - Result: 'List contains: 0cm 1cm 2cm '
*
* The #each() function optionally takes a length parameter. If positive,
* this parameter specifies the max number of elements to iterate through.
* If negative, the function will subtract the number from the length of the
* array. Use this to stop iterating before the array ends. Example:
*
* - Format: 'List contains: {#each(myArray, -1) }and {myArray[-1]}.'
*
* - Context: { myArray: [0, 1, 2, 3] }
*
* - Result: 'List contains: 0, 1, 2, and 3.'
*
* Use the #plural() function to pick a string depending on whether or not a
* context object is 1. Arguments are #plural(obj, plural, singular).
* Example:
*
* - Format: 'Has {numPoints} {#plural(numPoints, points, point}.'
*
* - Context: { numPoints: 5 }
*
* - Result: 'Has 5 points.'
*
* Optionally there are additional parameters for dual and none:
* #plural(obj, plural, singular, dual, none). Example:
*
* - Format: 'Has {#plural(numPoints, many points, one point, two points,
* none}.'
*
* - Context: { numPoints: 2 }
*
* - Result: 'Has two points.'
*
* The dual or none parameters will take precedence if they are supplied.
*
* @param formatString
* The string to format.
*
* @param context
* Context to apply to the format string.
*
* @param chart
* A `Chart` instance with a time object and numberFormatter, passed
* on to format().
*
* @return The formatted string.
*/
function i18nFormat(formatString: string, context: Dictionary<any>, chart: Chart): string;
/**
* When we have vertical scrollbar, rifles and arrow in buttons should be
* rotated. The same method is used in Navigator's handles, to rotate them.
*
* @param path
* Path to be rotated.
*
* @param vertical
* If vertical scrollbar, swap x-y values.
*
* @return Rotated path.
*/
function swapXY(path: SVGPathArray, vertical?: boolean): SVGPathArray;
/**
* If we have a clear root option node for old and new options and a mapping
* between, we can use this generic function for the copy and warn logic.
*/
function deprecateFromOptionsMap(): void;
/**
* Put accessible info on series and points of a series.
*
* @param series
* The series to add info on.
*/
function describeSeries(series: Series): void;
}
export default factory;
export let Highcharts: typeof _Highcharts;