victory-tooltip
Advanced tools
victory-tooltip@^30.0.0 exports VictoryTooltip and Flyout components
View these docs at https://formidable.com/open-source/victory/docs/victory-tooltip to see live examples.
VictoryTooltip renders a tooltip component with a set of default events. When VictoryTooltip is used as a label component for any Victory component that renders data, it will attach events to rendered data components that will activate the tooltip when hovered. VictoryTooltip renders text as well as a configurable Flyout container.
type: boolean
The active prop specifies whether the tooltip component should be displayed.
type: boolean
When true, tooltip events will set the active prop on both data and label elements.
default: activateData={false}
type: number
The angle prop specifies the angle to rotate the tooltip around its origin point.
type: number || function
The cornerRadius prop determines corner radius of the flyout container. This prop may be given as a positive number or a function of datum.
type: array[object]
Victory components can pass a data prop to their label component. This can be useful in custom components that need to make use of the entire dataset.
type: object
Victory components can pass a datum prop to their label component. This can
be used to calculate functional styles, and determine text.
type: number || function
The dx prop defines a horizontal shift from the x coordinate.
type: number || function
The dy prop defines a vertical shift from the y coordinate.
type: object
The events prop attaches arbitrary event handlers to the label component. This prop should be given as an object of event names and corresponding event handlers. When events are provided via Victory's event system, event handlers will be called with the event, the props of the component is attached to, and an eventKey.
examples: events={{onClick: (evt) => alert("x: " + evt.clientX)}}
type: object
The style prop applies SVG style properties to the rendered flyout container. These props will be passed to the flyoutComponent.
type: element
The flyoutComponent prop takes a component instance which will be used to create the flyout path for each tooltip. The new element created from the passed flyoutComponent will be supplied with the following properties: x, y, dx, dy, index, datum, cornerRadius, pointerLength, pointerWidth, width, height, orientation, style, and events. Any of these props may be overridden by passing in props to the supplied component, or modified or ignored within the custom component itself. If flyoutComponent is omitted, a default Flyout component will be created with props described above.
examples: flyoutComponent={<Flyout x={50} y={50}/>}, flyoutComponent={<MyCustomFlyout/>}
default: <Flyout/>
type: element
The groupComponent prop takes a component instance which will be used to create group elements for use within container elements. This prop defaults to a <g> tag.
default: groupComponent={<g/>}
type: number || function
The height prop defines the height of the tooltip flyout. This prop may be given as a positive number or a function of datum. If this prop is not set, height will be determined based on an approximate text size calculated from the text and style props provided to VictoryTooltip.
type: boolean
The horizontal prop determines whether to plot the flyouts to the left / right of the (x, y) coordinate rather than top / bottom. This is useful when an orientation prop is not provided, and data will determine the default orientation. i.e. negative values result in a left orientation and positive values will result in a right orientation by default.
type: number || string
The index prop represents the index of the datum in the data array.
type: element
The labelComponent prop takes a component instance which will be used to render each tooltip label. The new element created from the passed labelComponent will be supplied with the following properties: x, y, index, datum, verticalAnchor, textAnchor, style, text, and events. Any of these props may be overridden by passing in props to the supplied component, or modified or ignored within the custom component itself. If labelComponent is omitted, a new VictoryLabel will be created with the props described above.
examples: labelComponent={<VictoryLabel dy={20}/>}, labelComponent={<MyCustomLabel/>}
default: <VictoryLabel/>
type: function || "top" || "bottom" || "left" || "right"
The orientation prop determines which side of the (x, y) coordinate the tooltip should be rendered on. This prop can be given as "top", "bottom", "left", "right", or as a function of datum that returns one of these values. If this prop is not provided it will be determined from the sign of the datum, and the value of the horizontal prop.
type: number || function
The pointerLength prop determines the length of the triangular pointer extending from the flyout. This prop may be given as a positive number or a function of datum.
type: number || function
The pointerWidth prop determines the width of the base of the triangular pointer extending from the flyout. This prop may be given as a positive number or a function of datum.
type: boolean
When renderInPortal is true, rendered tooltips will be wrapped in VictoryPortal and rendered within the Portal element within VictoryContainer. Note: This prop should not be set to true when using a custom container element.
type: object
The style prop applies SVG style properties to the rendered <text> element.
type: string || number || function || array[string || number]
The text prop defines the text VictoryTooltip will render. The text prop may be given as a string, number, or function of datum. When VictoryLabel is used as the labelComponent, strings may include newline characters, which VictoryLabel will split in to separate <tspan/> elements.
type: number || function
The width prop defines the width of the tooltip flyout. This prop may be given as a positive number or a function of datum. If this prop is not set, width will be determined based on an approximate text size calculated from the text and style props provided to VictoryTooltip.
type: number
The x prop defines the x coordinate to use as a basis for positioning the tooltip element.
type: number
The y prop defines the y coordinate to use as a basis for positioning the tooltip element.
30.0.0 (2018-07-17)
Victory is becoming a monorepo!
This will not be a breaking change for the majority of users, especially those importing all components from the main victory npm package
Breaking Changes
Axis / Grid primitive component has been renamed LineSegmentvictory-chart and victory-core packages export different sets of packages than they used to. See the complete list belowNew Package Organization
victory exports everything exported from the packages belowvictory-axis@30.0.0 exports VictoryAxisvictory-area@30.0.0 exports VictoryArea and Areavictory-bar@30.0.0 exports VictoryBar and Barvictory-box-plot@30.0.0 exports VictoryBoxPlotvictory-brush-container@30.0.0 exports VictoryBrushContainer, BrushHelpers and brushContainerMixinvictory-brush-line@30.0.0 exports VictoryBrushLinevictory-candlestick@30.0.0 exports VictoryCandlestick and Candlevictory-chart@30.0.0 exports VictoryChartvictory-core@30.0.0 still exports several packages that are used by several Victory components:
VictoryAnimationVictoryClipContainerVictoryContainerVictoryLabelVictoryPortal and PortalVictoryThemeVictoryTransitionArc, Border / Box, Circle, ClipPath, LineSegment (formerly Axis / Grid), Line, Path, Point, Rect, Text, TSpan, WhiskeraddEvents, Axis, Collection, CommonProps, Data, DefaultTransitions, Domain, Events, Helpers, Immutable, LabelHelpers, Log, PropTypes, Scale, Selection, Style, TextSize, Timer, Transitions, Wrappervictory-create-container@30.0.0 exports createContainer, combineContainerMixins and makeCreateContainerFunctionvictory-cursor-container@30.0.0 exports VictoryCursorContainer, CursorHelpers and cursorContainerMixinvictory-errorbar@30.0.0 exports VictoryErrorBar and ErrorBarvictory-group@30.0.0 exports VictoryGroupvictory-legend@30.0.0 exports VictoryLegendvictory-line@30.0.0 exports VictoryLine and Curvevictory-pie@30.0.0 exports VictoryPie and Slicevictory-scatter@30.0.0 exports VictoryScattervictory-selection-container@30.0.0 exports VictorySelectionContainer, SelectionHelpers and selectionContainerMixinvictory-shared-events@30.0.0 exports VictorySharedEventsvictory-stack@30.0.0 exports VictoryStackvictory-tooltip@30.0.0 exports VictoryTooltip and Flyoutvictory-voronoi@30.0.0 exports VictoryVoronoi and Voronoivictory-voronoi-container@30.0.0 exports VictoryVoronoiContainer, VoronoiHelpers and voronoiContainerMixinvictory-zoom-container@30.0.0 exports VictoryZoomContainer, RawZoomHelpers, ZoomHelpers and zoomContainerMixinFAQs
Tooltip Component for Victory
The npm package victory-tooltip receives a total of 193,799 weekly downloads. As such, victory-tooltip popularity was classified as popular.
We found that victory-tooltip demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 16 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
ESLint has added JSON and Markdown linting support with new officially-supported plugins, expanding its versatility beyond JavaScript.
Security News
Members Hub is conducting large-scale campaigns to artificially boost Discord server metrics, undermining community trust and platform integrity.
Security News
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.