npm package: @govuk-react/tag
Description: Badge with solid background and bold text, rendered from children.
Author: Alasdair McLeay
Latest version: 0.10.7

Tag
===

### Import
```js
  import Tag from '@govuk-react/tag';
```
<!-- STORY -->

Use the tag component to show users the status of something.

- https://govuk-react.github.io/govuk-react/?path=/docs/tag
- https://design-system.service.gov.uk/components/tag/

### Properties
Prop | Required | Default | Type | Description
:--- | :------- | :------ | :--- | :----------
 `about` |  |  | string | 
 `accessKey` |  |  | string | 
 `aria-activedescendant` |  |  | string | Identifies the currently active element when DOM focus is on a composite widget, textbox, group, or application.
 `aria-atomic` |  |  | boolean \| "true" \| "false" | Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute.
 `aria-autocomplete` |  |  | "inline" \| "none" \| "list" \| "both" | Indicates whether inputting text could trigger display of one or more predictions of the user's intended value for an input and specifies how predictions would be<br/>presented if they are made.
 `aria-busy` |  |  | boolean \| "true" \| "false" | Indicates an element is being modified and that assistive technologies MAY want to wait until the modifications are complete before exposing them to the user.
 `aria-checked` |  |  | boolean \| "true" \| "false" \| "mixed" | Indicates the current "checked" state of checkboxes, radio buttons, and other widgets.<br/>@see aria-pressed<br/>@see aria-selected.
 `aria-colcount` |  |  | number | Defines the total number of columns in a table, grid, or treegrid.<br/>@see aria-colindex.
 `aria-colindex` |  |  | number | Defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid.<br/>@see aria-colcount<br/>@see aria-colspan.
 `aria-colspan` |  |  | number | Defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid.<br/>@see aria-colindex<br/>@see aria-rowspan.
 `aria-controls` |  |  | string | Identifies the element (or elements) whose contents or presence are controlled by the current element.<br/>@see aria-owns.
 `aria-current` |  |  | boolean \| "time" \| "true" \| "false" \| "page" \| "step" \| "location" \| "date" | Indicates the element that represents the current item within a container or set of related elements.
 `aria-describedby` |  |  | string | Identifies the element (or elements) that describes the object.<br/>@see aria-labelledby
 `aria-details` |  |  | string | Identifies the element that provides a detailed, extended description for the object.<br/>@see aria-describedby.
 `aria-disabled` |  |  | boolean \| "true" \| "false" | Indicates that the element is perceivable but disabled, so it is not editable or otherwise operable.<br/>@see aria-hidden<br/>@see aria-readonly.
 `aria-dropeffect` |  |  | "link" \| "none" \| "copy" \| "execute" \| "move" \| "popup" | Indicates what functions can be performed when a dragged object is released on the drop target.<br/>@deprecated in ARIA 1.1
 `aria-errormessage` |  |  | string | Identifies the element that provides an error message for the object.<br/>@see aria-invalid<br/>@see aria-describedby.
 `aria-expanded` |  |  | boolean \| "true" \| "false" | Indicates whether the element, or another grouping element it controls, is currently expanded or collapsed.
 `aria-flowto` |  |  | string | Identifies the next element (or elements) in an alternate reading order of content which, at the user's discretion,<br/>allows assistive technology to override the general default of reading in document source order.
 `aria-grabbed` |  |  | boolean \| "true" \| "false" | Indicates an element's "grabbed" state in a drag-and-drop operation.<br/>@deprecated in ARIA 1.1
 `aria-haspopup` |  |  | boolean \| "dialog" \| "menu" \| "grid" \| "true" \| "false" \| "listbox" \| "tree" | Indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element.
 `aria-hidden` |  |  | boolean \| "true" \| "false" | Indicates whether the element is exposed to an accessibility API.<br/>@see aria-disabled.
 `aria-invalid` |  |  | boolean \| "true" \| "false" \| "grammar" \| "spelling" | Indicates the entered value does not conform to the format expected by the application.<br/>@see aria-errormessage.
 `aria-keyshortcuts` |  |  | string | Indicates keyboard shortcuts that an author has implemented to activate or give focus to an element.
 `aria-label` |  |  | string | Defines a string value that labels the current element.<br/>@see aria-labelledby.
 `aria-labelledby` |  |  | string | Identifies the element (or elements) that labels the current element.<br/>@see aria-describedby.
 `aria-level` |  |  | number | Defines the hierarchical level of an element within a structure.
 `aria-live` |  |  | "off" \| "assertive" \| "polite" | Indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region.
 `aria-modal` |  |  | boolean \| "true" \| "false" | Indicates whether an element is modal when displayed.
 `aria-multiline` |  |  | boolean \| "true" \| "false" | Indicates whether a text box accepts multiple lines of input or only a single line.
 `aria-multiselectable` |  |  | boolean \| "true" \| "false" | Indicates that the user may select more than one item from the current selectable descendants.
 `aria-orientation` |  |  | "horizontal" \| "vertical" | Indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous.
 `aria-owns` |  |  | string | Identifies an element (or elements) in order to define a visual, functional, or contextual parent/child relationship<br/>between DOM elements where the DOM hierarchy cannot be used to represent the relationship.<br/>@see aria-controls.
 `aria-placeholder` |  |  | string | Defines a short hint (a word or short phrase) intended to aid the user with data entry when the control has no value.<br/>A hint could be a sample value or a brief description of the expected format.
 `aria-posinset` |  |  | number | Defines an element's number or position in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM.<br/>@see aria-setsize.
 `aria-pressed` |  |  | boolean \| "true" \| "false" \| "mixed" | Indicates the current "pressed" state of toggle buttons.<br/>@see aria-checked<br/>@see aria-selected.
 `aria-readonly` |  |  | boolean \| "true" \| "false" | Indicates that the element is not editable, but is otherwise operable.<br/>@see aria-disabled.
 `aria-relevant` |  |  | "text" \| "additions" \| "additions removals" \| "additions text" \| "all" \| "removals" \| "removals additions" \| "removals text" \| "text additions" \| "text removals" | Indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified.<br/>@see aria-atomic.
 `aria-required` |  |  | boolean \| "true" \| "false" | Indicates that user input is required on the element before a form may be submitted.
 `aria-roledescription` |  |  | string | Defines a human-readable, author-localized description for the role of an element.
 `aria-rowcount` |  |  | number | Defines the total number of rows in a table, grid, or treegrid.<br/>@see aria-rowindex.
 `aria-rowindex` |  |  | number | Defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid.<br/>@see aria-rowcount<br/>@see aria-rowspan.
 `aria-rowspan` |  |  | number | Defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid.<br/>@see aria-rowindex<br/>@see aria-colspan.
 `aria-selected` |  |  | boolean \| "true" \| "false" | Indicates the current "selected" state of various widgets.<br/>@see aria-checked<br/>@see aria-pressed.
 `aria-setsize` |  |  | number | Defines the number of items in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM.<br/>@see aria-posinset.
 `aria-sort` |  |  | "none" \| "ascending" \| "descending" \| "other" | Indicates if items in a table or grid are sorted in ascending or descending order.
 `aria-valuemax` |  |  | number | Defines the maximum allowed value for a range widget.
 `aria-valuemin` |  |  | number | Defines the minimum allowed value for a range widget.
 `aria-valuenow` |  |  | number | Defines the current value for a range widget.<br/>@see aria-valuetext.
 `aria-valuetext` |  |  | string | Defines the human readable text alternative of aria-valuenow for a range widget.
 `as` |  |  | undefined | 
 `autoCapitalize` |  |  | string | 
 `autoCorrect` |  |  | string | 
 `autoSave` |  |  | string | 
 `backgroundColor` |  |  | string | Custom colour to override the tag background color
 `className` |  |  | string | 
 `color` |  |  | string | Custom colour to override the tag text color
 `contentEditable` |  |  | "inherit" \| Booleanish | 
 `contextMenu` |  |  | string | 
 `dangerouslySetInnerHTML` |  |  | { __html: string; } | 
 `datatype` |  |  | string | 
 `defaultChecked` |  |  | boolean | 
 `defaultValue` |  |  | string \| number \| readonly string[] | 
 `dir` |  |  | string | 
 `draggable` |  |  | Booleanish | 
 `forwardedAs` |  |  | undefined | 
 `hidden` |  |  | boolean | 
 `id` |  |  | string | 
 `inactive` |  | ```undefined``` | boolean | Deprecated: use grey tint instead
 `inlist` |  |  | any | 
 `inputMode` |  |  | "text" \| "none" \| "search" \| "tel" \| "url" \| "email" \| "numeric" \| "decimal" | Hints at the type of data that might be entered by the user while editing the element or its contents<br/>@see https://html.spec.whatwg.org/multipage/interaction.html#input-modalities:-the-inputmode-attribute
 `is` |  |  | string | Specify that a standard HTML element should behave like a defined custom built-in element<br/>@see https://html.spec.whatwg.org/multipage/custom-elements.html#attr-is
 `itemID` |  |  | string | 
 `itemProp` |  |  | string | 
 `itemRef` |  |  | string | 
 `itemScope` |  |  | boolean | 
 `itemType` |  |  | string | 
 `key` |  |  | Key | 
 `lang` |  |  | string | 
 `onAbort` |  |  | ReactEventHandler<HTMLElement> | 
 `onAbortCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onAnimationEnd` |  |  | AnimationEventHandler<HTMLElement> | 
 `onAnimationEndCapture` |  |  | AnimationEventHandler<HTMLElement> | 
 `onAnimationIteration` |  |  | AnimationEventHandler<HTMLElement> | 
 `onAnimationIterationCapture` |  |  | AnimationEventHandler<HTMLElement> | 
 `onAnimationStart` |  |  | AnimationEventHandler<HTMLElement> | 
 `onAnimationStartCapture` |  |  | AnimationEventHandler<HTMLElement> | 
 `onAuxClick` |  |  | MouseEventHandler<HTMLElement> | 
 `onAuxClickCapture` |  |  | MouseEventHandler<HTMLElement> | 
 `onBeforeInput` |  |  | FormEventHandler<HTMLElement> | 
 `onBeforeInputCapture` |  |  | FormEventHandler<HTMLElement> | 
 `onBlur` |  |  | FocusEventHandler<HTMLElement> | 
 `onBlurCapture` |  |  | FocusEventHandler<HTMLElement> | 
 `onCanPlay` |  |  | ReactEventHandler<HTMLElement> | 
 `onCanPlayCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onCanPlayThrough` |  |  | ReactEventHandler<HTMLElement> | 
 `onCanPlayThroughCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onChange` |  |  | FormEventHandler<HTMLElement> | 
 `onChangeCapture` |  |  | FormEventHandler<HTMLElement> | 
 `onClick` |  |  | MouseEventHandler<HTMLElement> | 
 `onClickCapture` |  |  | MouseEventHandler<HTMLElement> | 
 `onCompositionEnd` |  |  | CompositionEventHandler<HTMLElement> | 
 `onCompositionEndCapture` |  |  | CompositionEventHandler<HTMLElement> | 
 `onCompositionStart` |  |  | CompositionEventHandler<HTMLElement> | 
 `onCompositionStartCapture` |  |  | CompositionEventHandler<HTMLElement> | 
 `onCompositionUpdate` |  |  | CompositionEventHandler<HTMLElement> | 
 `onCompositionUpdateCapture` |  |  | CompositionEventHandler<HTMLElement> | 
 `onContextMenu` |  |  | MouseEventHandler<HTMLElement> | 
 `onContextMenuCapture` |  |  | MouseEventHandler<HTMLElement> | 
 `onCopy` |  |  | ClipboardEventHandler<HTMLElement> | 
 `onCopyCapture` |  |  | ClipboardEventHandler<HTMLElement> | 
 `onCut` |  |  | ClipboardEventHandler<HTMLElement> | 
 `onCutCapture` |  |  | ClipboardEventHandler<HTMLElement> | 
 `onDoubleClick` |  |  | MouseEventHandler<HTMLElement> | 
 `onDoubleClickCapture` |  |  | MouseEventHandler<HTMLElement> | 
 `onDrag` |  |  | DragEventHandler<HTMLElement> | 
 `onDragCapture` |  |  | DragEventHandler<HTMLElement> | 
 `onDragEnd` |  |  | DragEventHandler<HTMLElement> | 
 `onDragEndCapture` |  |  | DragEventHandler<HTMLElement> | 
 `onDragEnter` |  |  | DragEventHandler<HTMLElement> | 
 `onDragEnterCapture` |  |  | DragEventHandler<HTMLElement> | 
 `onDragExit` |  |  | DragEventHandler<HTMLElement> | 
 `onDragExitCapture` |  |  | DragEventHandler<HTMLElement> | 
 `onDragLeave` |  |  | DragEventHandler<HTMLElement> | 
 `onDragLeaveCapture` |  |  | DragEventHandler<HTMLElement> | 
 `onDragOver` |  |  | DragEventHandler<HTMLElement> | 
 `onDragOverCapture` |  |  | DragEventHandler<HTMLElement> | 
 `onDragStart` |  |  | DragEventHandler<HTMLElement> | 
 `onDragStartCapture` |  |  | DragEventHandler<HTMLElement> | 
 `onDrop` |  |  | DragEventHandler<HTMLElement> | 
 `onDropCapture` |  |  | DragEventHandler<HTMLElement> | 
 `onDurationChange` |  |  | ReactEventHandler<HTMLElement> | 
 `onDurationChangeCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onEmptied` |  |  | ReactEventHandler<HTMLElement> | 
 `onEmptiedCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onEncrypted` |  |  | ReactEventHandler<HTMLElement> | 
 `onEncryptedCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onEnded` |  |  | ReactEventHandler<HTMLElement> | 
 `onEndedCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onError` |  |  | ReactEventHandler<HTMLElement> | 
 `onErrorCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onFocus` |  |  | FocusEventHandler<HTMLElement> | 
 `onFocusCapture` |  |  | FocusEventHandler<HTMLElement> | 
 `onGotPointerCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onGotPointerCaptureCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onInput` |  |  | FormEventHandler<HTMLElement> | 
 `onInputCapture` |  |  | FormEventHandler<HTMLElement> | 
 `onInvalid` |  |  | FormEventHandler<HTMLElement> | 
 `onInvalidCapture` |  |  | FormEventHandler<HTMLElement> | 
 `onKeyDown` |  |  | KeyboardEventHandler<HTMLElement> | 
 `onKeyDownCapture` |  |  | KeyboardEventHandler<HTMLElement> | 
 `onKeyPress` |  |  | KeyboardEventHandler<HTMLElement> | 
 `onKeyPressCapture` |  |  | KeyboardEventHandler<HTMLElement> | 
 `onKeyUp` |  |  | KeyboardEventHandler<HTMLElement> | 
 `onKeyUpCapture` |  |  | KeyboardEventHandler<HTMLElement> | 
 `onLoad` |  |  | ReactEventHandler<HTMLElement> | 
 `onLoadCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onLoadStart` |  |  | ReactEventHandler<HTMLElement> | 
 `onLoadStartCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onLoadedData` |  |  | ReactEventHandler<HTMLElement> | 
 `onLoadedDataCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onLoadedMetadata` |  |  | ReactEventHandler<HTMLElement> | 
 `onLoadedMetadataCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onLostPointerCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onLostPointerCaptureCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onMouseDown` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseDownCapture` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseEnter` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseLeave` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseMove` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseMoveCapture` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseOut` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseOutCapture` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseOver` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseOverCapture` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseUp` |  |  | MouseEventHandler<HTMLElement> | 
 `onMouseUpCapture` |  |  | MouseEventHandler<HTMLElement> | 
 `onPaste` |  |  | ClipboardEventHandler<HTMLElement> | 
 `onPasteCapture` |  |  | ClipboardEventHandler<HTMLElement> | 
 `onPause` |  |  | ReactEventHandler<HTMLElement> | 
 `onPauseCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onPlay` |  |  | ReactEventHandler<HTMLElement> | 
 `onPlayCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onPlaying` |  |  | ReactEventHandler<HTMLElement> | 
 `onPlayingCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onPointerCancel` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerCancelCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerDown` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerDownCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerEnter` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerEnterCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerLeave` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerLeaveCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerMove` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerMoveCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerOut` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerOutCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerOver` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerOverCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerUp` |  |  | PointerEventHandler<HTMLElement> | 
 `onPointerUpCapture` |  |  | PointerEventHandler<HTMLElement> | 
 `onProgress` |  |  | ReactEventHandler<HTMLElement> | 
 `onProgressCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onRateChange` |  |  | ReactEventHandler<HTMLElement> | 
 `onRateChangeCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onReset` |  |  | FormEventHandler<HTMLElement> | 
 `onResetCapture` |  |  | FormEventHandler<HTMLElement> | 
 `onScroll` |  |  | UIEventHandler<HTMLElement> | 
 `onScrollCapture` |  |  | UIEventHandler<HTMLElement> | 
 `onSeeked` |  |  | ReactEventHandler<HTMLElement> | 
 `onSeekedCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onSeeking` |  |  | ReactEventHandler<HTMLElement> | 
 `onSeekingCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onSelect` |  |  | ReactEventHandler<HTMLElement> | 
 `onSelectCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onStalled` |  |  | ReactEventHandler<HTMLElement> | 
 `onStalledCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onSubmit` |  |  | FormEventHandler<HTMLElement> | 
 `onSubmitCapture` |  |  | FormEventHandler<HTMLElement> | 
 `onSuspend` |  |  | ReactEventHandler<HTMLElement> | 
 `onSuspendCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onTimeUpdate` |  |  | ReactEventHandler<HTMLElement> | 
 `onTimeUpdateCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onTouchCancel` |  |  | TouchEventHandler<HTMLElement> | 
 `onTouchCancelCapture` |  |  | TouchEventHandler<HTMLElement> | 
 `onTouchEnd` |  |  | TouchEventHandler<HTMLElement> | 
 `onTouchEndCapture` |  |  | TouchEventHandler<HTMLElement> | 
 `onTouchMove` |  |  | TouchEventHandler<HTMLElement> | 
 `onTouchMoveCapture` |  |  | TouchEventHandler<HTMLElement> | 
 `onTouchStart` |  |  | TouchEventHandler<HTMLElement> | 
 `onTouchStartCapture` |  |  | TouchEventHandler<HTMLElement> | 
 `onTransitionEnd` |  |  | TransitionEventHandler<HTMLElement> | 
 `onTransitionEndCapture` |  |  | TransitionEventHandler<HTMLElement> | 
 `onVolumeChange` |  |  | ReactEventHandler<HTMLElement> | 
 `onVolumeChangeCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onWaiting` |  |  | ReactEventHandler<HTMLElement> | 
 `onWaitingCapture` |  |  | ReactEventHandler<HTMLElement> | 
 `onWheel` |  |  | WheelEventHandler<HTMLElement> | 
 `onWheelCapture` |  |  | WheelEventHandler<HTMLElement> | 
 `placeholder` |  |  | string | 
 `prefix` |  |  | string | 
 `property` |  |  | string | 
 `radioGroup` |  |  | string | 
 `ref` |  |  | Ref<HTMLElement> | 
 `resource` |  |  | string | 
 `results` |  |  | number | 
 `role` |  |  | AriaRole | 
 `security` |  |  | string | 
 `slot` |  |  | string | 
 `spellCheck` |  |  | Booleanish | 
 `style` |  |  | CSSProperties | 
 `suppressContentEditableWarning` |  |  | boolean | 
 `suppressHydrationWarning` |  |  | boolean | 
 `tabIndex` |  |  | number | 
 `theme` |  |  | any | 
 `tint` |  | ```SOLID``` | "SOLID" \| "GREY" \| "GREEN" \| "TURQUOISE" \| "BLUE" \| "PURPLE" \| "PINK" \| "RED" \| "ORANGE" \| "YELLOW" | Tag tint
 `title` |  |  | string | 
 `translate` |  |  | "yes" \| "no" | 
 `typeof` |  |  | string | 
 `unselectable` |  |  | "on" \| "off" | 
 `vocab` |  |  | string |