.vertical_line
class: VerticalLineTypeOptions
- class VerticalLineTypeOptions(**kwargs)
Configuration options for the vertical line stock tool type annotation.
Class Inheritance
- copy(other=None, overwrite=True, **kwargs)
Copy the configuration settings from this instance to the
other
instance.- Parameters:
other (
HighchartsMeta
) – The target instance to which the properties of this instance should be copied. IfNone
, will create a new instance and populate it with properties copied fromself
. Defaults toNone
.overwrite (
bool
) – ifTrue
, properties inother
that are already set will be overwritten by their counterparts inself
. Defaults toTrue
.kwargs – Additional keyword arguments. Some special descendents of
HighchartsMeta
may have special implementations of this method which rely on additional keyword arguments.
- Returns:
A mutated version of
other
with new property values
- classmethod from_dict(as_dict: dict, allow_snake_case: bool = True)
Construct an instance of the class from a
dict
object.
- classmethod from_js_literal(as_str_or_file, allow_snake_case: bool = True, _break_loop_on_failure: bool = False)
Return a Python object representation of a Highcharts JavaScript object literal.
- Parameters:
as_str_or_file (
str
) – The JavaScript object literal, represented either as astr
or as a filename which contains the JS object literal.allow_snake_case (
bool
) – IfTrue
, interpretssnake_case
keys as equivalent tocamelCase
keys. Defaults toTrue
._break_loop_on_failure (
bool
) – IfTrue
, will break any looping operations in the event of a failure. Otherwise, will attempt to repair the failure. Defaults toFalse
.
- Returns:
A Python object representation of the Highcharts JavaScript object literal.
- Return type:
HighchartsMeta
- classmethod from_json(as_json_or_file, allow_snake_case: bool = True)
Construct an instance of the class from a JSON string.
- Parameters:
as_json_or_file – The JSON string for the object or the filename of a file that contains the JSON string.
allow_snake_case (
bool
) – IfTrue
, interpretssnake_case
keys as equivalent tocamelCase
keys. Defaults toTrue
.
- Returns:
A Python objcet representation of
as_json
.- Return type:
HighchartsMeta
- to_dict() dict
Generate a
dict
representation of the object compatible with the Highcharts JavaScript library.Note
The
dict
representation has a property structure and naming convention that is intentionally consistent with the Highcharts JavaScript library. This is not Pythonic, but it makes managing the interplay between the two languages much, much simpler.
- to_js_literal(filename=None, encoding='utf-8') str | None
Return the object represented as a
str
containing the JavaScript object literal.
- to_json(filename=None, encoding='utf-8')
Generate a JSON string/byte string representation of the object compatible with the Highcharts JavaScript library.
Note
This method will either return a standard
str
or abytes
object depending on the JSON serialization library you are using. For example, if your environment has orjson, the result will be abytes
representation of the string.- Parameters:
- Returns:
A JSON representation of the object compatible with the Highcharts library.
- Return type:
- static trim_dict(untrimmed: dict, to_json: bool = False) dict
Remove keys from
untrimmed
whose values areNone
and convert values that have.to_dict()
methods.
- static trim_iterable(untrimmed, to_json=False)
Convert any
EnforcedNullType
values inuntrimmed
to'null'
.
- property connector: VerticalLineConnector | None
Connector options.
- Return type:
VerticalLineConnector
orNone
- property label: LabelOptions | None
Label options.
- Return type:
LabelOptions <highcharts_stock.options.annotations.label_options.LabelOptions> or
None
- property line: LineFillOnly | None
Line configuration settings.
- Return type:
LineFillOnly
orNone
- property points: List[StockToolsPoint] | None
Collection of annotation points for the stock tool type.
- Return type:
list
ofStockToolsPoint
instances, orNone
- property x_axis: str | int | None
This number defines which xAxis the point is connected to.
It refers to either the axis id (as a
str
) or the index of the axis in the xAxis array (as anint
).If the option is not configured or the axis is not found the point’s x coordinate refers to the chart pixels.
- property y_axis: str | int | None
This number defines which yAxis the point is connected to.
It refers to either the axis id (as a
str
) or the index of the axis in the yAxis array (as anint
).If the option is not configured or the axis is not found the point’s y coordinate refers to the chart pixels.
class: VerticalLineConnector
- class VerticalLineConnector(**kwargs)
Configuration for a vertical line connector.
Class Inheritance
- copy(other=None, overwrite=True, **kwargs)
Copy the configuration settings from this instance to the
other
instance.- Parameters:
other (
HighchartsMeta
) – The target instance to which the properties of this instance should be copied. IfNone
, will create a new instance and populate it with properties copied fromself
. Defaults toNone
.overwrite (
bool
) – ifTrue
, properties inother
that are already set will be overwritten by their counterparts inself
. Defaults toTrue
.kwargs – Additional keyword arguments. Some special descendents of
HighchartsMeta
may have special implementations of this method which rely on additional keyword arguments.
- Returns:
A mutated version of
other
with new property values
- classmethod from_dict(as_dict: dict, allow_snake_case: bool = True)
Construct an instance of the class from a
dict
object.
- classmethod from_js_literal(as_str_or_file, allow_snake_case: bool = True, _break_loop_on_failure: bool = False)
Return a Python object representation of a Highcharts JavaScript object literal.
- Parameters:
as_str_or_file (
str
) – The JavaScript object literal, represented either as astr
or as a filename which contains the JS object literal.allow_snake_case (
bool
) – IfTrue
, interpretssnake_case
keys as equivalent tocamelCase
keys. Defaults toTrue
._break_loop_on_failure (
bool
) – IfTrue
, will break any looping operations in the event of a failure. Otherwise, will attempt to repair the failure. Defaults toFalse
.
- Returns:
A Python object representation of the Highcharts JavaScript object literal.
- Return type:
HighchartsMeta
- classmethod from_json(as_json_or_file, allow_snake_case: bool = True)
Construct an instance of the class from a JSON string.
- Parameters:
as_json_or_file – The JSON string for the object or the filename of a file that contains the JSON string.
allow_snake_case (
bool
) – IfTrue
, interpretssnake_case
keys as equivalent tocamelCase
keys. Defaults toTrue
.
- Returns:
A Python objcet representation of
as_json
.- Return type:
HighchartsMeta
- to_dict() dict
Generate a
dict
representation of the object compatible with the Highcharts JavaScript library.Note
The
dict
representation has a property structure and naming convention that is intentionally consistent with the Highcharts JavaScript library. This is not Pythonic, but it makes managing the interplay between the two languages much, much simpler.
- to_js_literal(filename=None, encoding='utf-8') str | None
Return the object represented as a
str
containing the JavaScript object literal.
- to_json(filename=None, encoding='utf-8')
Generate a JSON string/byte string representation of the object compatible with the Highcharts JavaScript library.
Note
This method will either return a standard
str
or abytes
object depending on the JSON serialization library you are using. For example, if your environment has orjson, the result will be abytes
representation of the string.- Parameters:
- Returns:
A JSON representation of the object compatible with the Highcharts library.
- Return type:
- static trim_dict(untrimmed: dict, to_json: bool = False) dict
Remove keys from
untrimmed
whose values areNone
and convert values that have.to_dict()
methods.
- static trim_iterable(untrimmed, to_json=False)
Convert any
EnforcedNullType
values inuntrimmed
to'null'
.
- property dash_style: str | None
Name of the dash style to use for the shape’s stroke.
Accepts the following values:
'Solid'
'ShortDash'
'ShortDot'
'ShortDashDot'
'ShortDashDotDot'
'Dot'
'Dash'
'LongDash'
'DashDot'
'LongDashDot'
'LongDashDotDot'
- property fill: str | Gradient | Pattern | None
The color of the shape’s fill. Defaults to
'rgba(0, 0, 0, 0.75)'
.
- property height: int | float | Decimal | None
The height of the shape in pixels.
- Return type:
numeric or
None
- property marker_end: str | None
ID of the marker which will be drawn at the final vertex of the path.
Note
Custom markers can be defined in the
Options.defs()
property.
- property r: int | float | Decimal | None
The radius of the shape in pixels. Defaults to
0
.- Return type:
numeric or
None
- property ry: int | float | Decimal | None
The radius of the shape along the vertical dimension. Used to draw ellipses.
- Return type:
numeric or
None
- property snap: int | float | Decimal | None
Defines additional snapping area around an annotation making this annotation to focus. Defined in pixels.
Defaults to
2
.- Return type:
numeric or
None
- property src: str | None
The URL for an image to use as the annotation shape.
Note
ShapeOptions.type()
has to be set to'image'
.- Return type:
- Raises:
HighchartsValueError – if a value is supplied that is not a URL or not path-like
- property stroke_width: int | float | Decimal | None
The pixel stroke width of the shape. Defaults to
1
.- Return type:
numeric or
None
- property type: str | None
The type of the shape. Defaults to
'rect'
.Accepts:
'rect'
'circle'
'ellipse'
'image'
- Returns:
- Raises:
HighchartsValueError – if type not supported
- property width: int | float | Decimal | None
The width of the shape, expressed in pixels.
- Return type:
numeric or
None
- property x_axis: int | None
The X-Axis index to which the points should be attached.
Note
Used for the
ellipse
type
- Return type:
- Raises:
ValueError – if set to a negative value