ant-design/components/typography/index.en-US.md
2024-07-11 10:02:24 +08:00

9.1 KiB
Raw Permalink Blame History

category group title description cover coverDark
Components General Typography Basic text writing, including headings, body text, lists, and more. https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*MLt3R6m9huoAAAAAAAAAAAAADrJ8AQ/original https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*LT2jR41Uj2EAAAAAAAAAAAAADrJ8AQ/original

When To Use

  • When you need to display a title or paragraph contents in Articles/Blogs/Notes.
  • When you need copyable/editable/ellipsis texts.

Examples

Basic Title Component Title and Paragraph Text and Link Component Editable Copyable Ellipsis Controlled ellipsis expand/collapse Ellipsis from middle Ellipsis Debug suffix Component Token

API

Common props refCommon props

Typography.Text

Property Description Type Default Version
code Code style boolean false
copyable Whether to be copyable, customize it via setting an object boolean | copyable false copyable
delete Deleted line style boolean false
disabled Disabled content boolean false
editable If editable. Can control edit state when is object boolean | editable false editable
ellipsis Display ellipsis when text overflows, can't configure expandable、rows and onExpand by using object. Diff with Typography.Paragraph, Text do not have 100% width style which means it will fix width on the first ellipsis. If you want to have responsive ellipsis, please set width manually boolean | Omit<ellipsis, 'expandable' | 'rows' | 'onExpand'> false ellipsis
keyboard Keyboard style boolean false 4.3.0
mark Marked style boolean false
onClick Set the handler to handle click event (event) => void -
strong Bold style boolean false
italic Italic style boolean false 4.16.0
type Content type secondary | success | warning | danger - success: 4.6.0
underline Underlined style boolean false

Typography.Title

Property Description Type Default Version
code Code style boolean false
copyable Whether to be copyable, customize it via setting an object boolean | copyable false copyable
delete Deleted line style boolean false
disabled Disabled content boolean false
editable If editable. Can control edit state when is object boolean | editable false editable
ellipsis Display ellipsis when text overflows, can configure rows and expandable by using object boolean | ellipsis false ellipsis
level Set content importance. Match with h1, h2, h3, h4, h5 number: 1, 2, 3, 4, 5 1 5: 4.6.0
mark Marked style boolean false
onClick Set the handler to handle click event (event) => void -
italic Italic style boolean false 4.16.0
type Content type secondary | success | warning | danger - success: 4.6.0
underline Underlined style boolean false

Typography.Paragraph

Property Description Type Default Version
code Code style boolean false
copyable Whether to be copyable, customize it via setting an object boolean | copyable false copyable
delete Deleted line style boolean false
disabled Disabled content boolean false
editable If editable. Can control edit state when is object boolean | editable false editable
ellipsis Display ellipsis when text overflows, can configure rows and expandable by using object boolean | ellipsis false ellipsis
mark Marked style boolean false
onClick Set the handler to handle click event (event) => void -
strong Bold style boolean false
italic Italic style boolean false 4.16.0
type Content type secondary | success | warning | danger - success: 4.6.0
underline Underlined style boolean false

copyable

{
  text: string | (() => string | Promise<string>),
  onCopy: function(event),
  icon: ReactNode,
  tooltips: false | [ReactNode, ReactNode],
  format: 'text/plain' | 'text/html',
  tabIndex: number,
}
Property Description Type Default Version
format The Mime Type of the text 'text/plain' | 'text/html' - 4.21.0
icon Custom copy icon: [copyIcon, copiedIcon] [ReactNode, ReactNode] - 4.6.0
text The text to copy string -
tooltips Custom tooltip text, hide when it is false [ReactNode, ReactNode] [Copy, Copied] 4.4.0
onCopy Called when copied text function -
tabIndex Set tabIndex of the copy button number 0 5.17.0

editable

{
  icon: ReactNode,
  tooltip: ReactNode,
  editing: boolean,
  maxLength: number,
  autoSize: boolean | { minRows: number, maxRows: number },
  text: string,
  onChange: function(string),
  onCancel: function,
  onStart: function,
  onEnd: function,
  triggerType: ('icon' | 'text')[],
  enterIcon: ReactNode,
  tabIndex: number,
}
Property Description Type Default Version
autoSize autoSize attribute of textarea boolean | { minRows: number, maxRows: number } - 4.4.0
editing Whether to be editable boolean false
icon Custom editable icon ReactNode <EditOutlined /> 4.6.0
maxLength maxLength attribute of textarea number - 4.4.0
tooltip Custom tooltip text, hide when it is false ReactNode Edit 4.6.0
text Edit text, specify the editing content instead of using the children implicitly string - 4.24.0
onChange Called when input at textarea function(value: string) -
onCancel Called when type ESC to exit editable state function -
onStart Called when enter editable state function -
onEnd Called when type ENTER to exit editable state function - 4.14.0
triggerType Edit mode trigger - icon, text or both (not specifying icon as trigger hides it) Array<icon|text> [icon]
enterIcon Custom "enter" icon in the edit field (passing null removes the icon) ReactNode <EnterOutlined /> 4.17.0
tabIndex Set tabIndex of the edit button number 0 5.17.0

ellipsis

interface EllipsisConfig {
  rows: number;
  /** `collapsible` added in `5.16.0` */
  expandable: boolean | 'collapsible';
  suffix: string;
  /** render function added in `5.16.0` */
  symbol: ReactNode | ((expanded: boolean) => ReactNode);
  tooltip: ReactNode | TooltipProps;
  /** added in `5.16.0` */
  defaultExpanded: boolean;
  /** added in `5.16.0` */
  expanded: boolean;
  /** `info` added in `5.16.0` */
  onExpand: (event: MouseEvent, info: { expanded: boolean }) => void;
  onEllipsis: (ellipsis: boolean) => void;
}
Property Description Type Default Version
expandable Whether to be expandable boolean | 'collapsible' - collapsible: 5.16.0
rows Max rows of content number -
suffix Suffix of ellipsis content string -
symbol Custom description of ellipsis ReactNode | ((expanded: boolean) => ReactNode) Expand Collapse
tooltip Show tooltip when ellipsis ReactNode | TooltipProps - 4.11.0
defaultExpanded Default expand or collapse boolean 5.16.0
expanded Expand or Collapse boolean 5.16.0
onEllipsis Called when enter or leave ellipsis state function(ellipsis) - 4.2.0
onExpand Called when expand content function(event, { expanded: boolean }) - info: 5.16.0

Design Token

FAQ

react-router support customize render component:

<Link to="/" component={Typography.Link} />

Note This is not equivalent to the execution logic of react-router's Link reference