@blueprintjs/core
Version:
Core styles & components
79 lines (78 loc) • 2.4 kB
TypeScript
import * as React from "react";
import { IconName } from "@blueprintjs/icons";
import { IntentProps, MaybeElement, Props } from "../../common";
export interface TagProps extends Props, IntentProps, React.RefAttributes<HTMLSpanElement>, React.HTMLAttributes<HTMLSpanElement> {
/**
* Whether the tag should appear in an active state.
*
* @default false
*/
active?: boolean;
children?: React.ReactNode;
/**
* Whether the tag should take up the full width of its container.
*
* @default false
*/
fill?: boolean;
/** Name of a Blueprint UI icon (or an icon element) to render before the children. */
icon?: IconName | MaybeElement;
/**
* Whether the tag should visually respond to user interactions. If set
* to `true`, hovering over the tag will change its color and mouse cursor.
*
* Recommended when `onClick` is also defined.
*
* @default false
*/
interactive?: boolean;
/**
* Whether this tag should use large styles.
*
* @default false
*/
large?: boolean;
/**
* Whether this tag should use minimal styles.
*
* @default false
*/
minimal?: boolean;
/**
* Whether tag content should be allowed to occupy multiple lines.
* If false, a single line of text will be truncated with an ellipsis if
* it overflows. Note that icons will be vertically centered relative to
* multiline text.
*
* @default false
*/
multiline?: boolean;
/**
* Callback invoked when the tag is clicked.
* Recommended when `interactive` is `true`.
*/
onClick?: (e: React.MouseEvent<HTMLDivElement>) => void;
/**
* Click handler for remove button.
* The remove button will only be rendered if this prop is defined.
*/
onRemove?: (e: React.MouseEvent<HTMLButtonElement>, tagProps: TagProps) => void;
/** Name of a Blueprint UI icon (or an icon element) to render after the children. */
rightIcon?: IconName | MaybeElement;
/**
* Whether this tag should have rounded ends.
*
* @default false
*/
round?: boolean;
/**
* HTML title to be passed to the <Text> component
*/
htmlTitle?: string;
}
/**
* Tag component.
*
* @see https://blueprintjs.com/docs/#core/components/tag
*/
export declare const Tag: React.FC<TagProps>;