Skip to Content
文档

标题

用于渲染语义化的 HTML 标题元素。

The quick brown fox jumps over the lazy dog

用法

¥Usage

import { Heading } from "@chakra-ui/react"
<Heading>I'm a Heading</Heading>

示例

¥Examples

尺寸

¥Sizes

使用 size 属性更改标题组件的大小。

¥Use the size prop to change the size of the heading component.

Heading (sm)

Heading (md)

Heading (lg)

Heading (xl)

Heading (2xl)

Heading (3xl)

Heading (4xl)

Heading (5xl)

Heading (6xl)

高亮

¥Highlight

组合 Heading 组件与 Highlight 组件,使其高亮显示文本。

¥Compose the Heading component with the Highlight component to highlight text.

Create accessible React apps with speed

Chakra UI is a simple, modular and accessible component library that gives you the building blocks you need.

作为其他元素

¥As another element

使用 as 属性将标题渲染为另一个 HTML 元素。

¥Use the as prop to render the heading as another HTML element.

Level 1

Level 2

Level 3

权重

¥Weights

使用 fontWeight 属性更改标题组件的粗细。

¥Use the fontWeight prop to change the weight of the heading component.

Normal

Medium

Semibold

Bold

合成

¥Composition

使用 Heading 组件组合其他组件。

¥Use the Heading component to compose other components.

Modern payments for Stores

PayMe helps startups get paid by anyone, anywhere in the world

自定义

¥Customization

要覆盖 fontSize,我们建议使用 textStyle 属性,因为它会同时考虑行高和字母间距。

¥To override the fontSize, we recommend using the textStyle prop since it considers the line height and letter spacing as well.

基本样式

¥Base style

以下是自定义 Heading 组件的示例。

¥Here's an example of customizing the Heading component.

provider.tsx

import { createSystem, defineRecipe } from "@chakra-ui/react"
import { defaultConfig } from "@chakra-ui/react"

const headingRecipe = defineRecipe({
  base: {
    fontWeight: "normal",
    textStyle: "4xl",
  },
})

const system = createSystem(defaultConfig, {
  theme: {
    recipes: { heading: headingRecipe },
  },
})

自定义尺寸

¥Custom Size

更新 variants.size 属性以创建自定义大小。

¥Update the variants.size property to create a custom size.

provider.tsx

import { createSystem, defineRecipe } from "@chakra-ui/react"
import { defaultConfig } from "@chakra-ui/react"

const headingRecipe = defineRecipe({
  variants: {
    size: {
      custom: {
        fontSize: "100px",
        lineHeight: "100px",
        letterSpacing: "-2px",
      },
    },
  },
})

const system = createSystem(defaultConfig, {
  theme: {
    recipes: { heading: headingRecipe },
  },
})

然后,使用 custom 变量创建自定义大小。

¥Then, use the custom variant to create a custom size.

<Heading size="custom">I'm a custom size</Heading>

属性

¥Props

PropDefaultType
colorPalette 'gray'
'gray' | 'red' | 'orange' | 'yellow' | 'green' | 'teal' | 'blue' | 'cyan' | 'purple' | 'pink'

The color palette of the component

size 'xl'
'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | '6xl' | '7xl'

The size of the component

as
React.ElementType

The underlying element to render.

asChild
boolean

Use the provided child element as the default rendered element, combining their props and behavior.

For more details, read our Composition guide.

Previous

Em

Next

高亮