Hint Dot
A decorative indicator to either call attention to an item or highlight it's status.
#
Importimport { HintDot } from '@volue/wave-react';
#
Examples#
BasicHintDot
is just a small decorative indicator often used as a more compact alternative for a Label.
It can be used to point out that something has changed or grab user's attention without giving a count.
#
SizesBy default HintDot
will inherit its size from the parent element's text size.
Use size
prop to pick one of the predefined sizes: medium
and small
.
#
ToneUse the tone
property to indicate the intent. Default tones correspond with functional color tokens roles.
#
PlacementHintDot
is typically placed on the trailing end of icons, components or text.
With help of Anchor component you can attach HintDot
to a corner of an element to indicate the status of that element.
#
Accessible labelWhen the intent isn't provided by accompanying text, it's highly recommended to provide an aria-label
for assistive tech users.
#
Cut-out effectWhen HintDot
is overlapping with other element, you can simulate a cut-out effect with an outline ring by using the showOutlineRing
property.
#
Custom toneYou can provide a custom tone by using tone="custom"
property and setting the color
property to one of the color tokens.
#
Status listHintDot
enables creating statuses tailored to your app's need.
#
On dark backgroundWhen using dot indicator on a dark background, it can be given a thin outline border for better constrast by setting the outline
property to true
#
App header status#
API ReferenceProp | Type | Default |
---|---|---|
as | enum | span |
css | StitchesCss | No default value |
tone | enum | "neutral" |
outlined | boolean | No default value |
showOutlineRing | boolean | false |
color | ColorToken | No default value |
size | enum | No default value |