Heading Component
The Heading
component is a functional component that returns a heading element with various style properties.
Props
The Heading
component accepts the following props:
Name | Type | Default Value | Description |
---|---|---|---|
fontSize | string | var(--font-size-base) | Font size of the text |
fontWeight | string | var(--font-weight-normal) | Font weight of the text |
fontStyle | string | var(--font-style-normal) | Font style of the text |
fontFamily | string | var(--font-family-sans) | Font family of the text |
font | string | var(--font) | Shorthand for setting all font properties |
color | string | var(--color-neutrals-9) | Color of the text |
textAlign | string | var(--text-align-left) | Horizontal alignment of the text |
textTransform | string | var(--text-transform-none) | Controls the capitalization of text |
lineHeight | string | var(--line-height-none) | Space between lines |
letterSpacing | string | var(--letter-spacing-normal) | Spacing between characters |
whiteSpace | string | var(--white-space-normal) | How white space inside an element is handled |
wordBreak | string | var(--word-break-normal) | Specifies how words should break when reaching the end of a line |
overflowWrap | string | var(--overflow-wrap-normal) | Specifies whether or not the browser may break lines within words in order to prevent overflow |
wordWrap | string | var(--word-wrap-normal) | Legacy version of the overflowWrap property |
hyphens | string | var(--hyphens-none) | Controls how words should be hyphenated when text wraps across multiple lines |
textOrientation | string | var(--text-orientation-mixed) | Defines the orientation of the text in a line |
textRendering | string | var(--text-rendering-auto) | Provides information to the rendering engine about what to optimize for when rendering text |
textSizeAdjust | string | var(--text-size-adjust-auto) | Allows web authors to disable or modify the text inflation algorithm on a per-element basis |
textUnderlinePosition | string | var(--text-underline-position-auto) | Sets the placement of the underline on links or on underlined text |
textUnderlineOffset | string | var(--text-underline-offset-auto) | Sets the offset distance of an underline text decoration line (applied through text-decoration) from its original position |
textUnderlineStyle | string | var(--text-underline-style-solid) | Sets the style of the underline on links or on underlined text |
textUnderlineColor | string | var(--text-underline-color-currentColor) | Sets the color of the underline on links or on underlined text |
textUnderline | string | var(--text-underline) | Shorthand for setting all the underline properties |
textOverlineStyle | string | var(--text-overline-style-solid) | Sets the style of the overline on links or on overlined text |
textOverlineColor | string | var(--text-overline-color-currentColor) | Sets the color of the overline on links or on overlined text |
textOverline | string | var(--text-overline) | Shorthand for setting all the overline properties |
textLineThroughStyle | string | var(--text-line-through-style-solid) | Sets the style of the line-through on links or on line-through text |
textLineThroughColor | string | var(--text-line-through-color-currentColor) | Sets the color of the line-through on links or on line-through text |
textLineThrough | string | var(--text-line-through) | Shorthand for setting all the line-through properties |
textDecorationLine | string | var(--text-decoration-line-none) | Sets the kind of text decoration to use (like underline, overline, line-through) |
textDecorationStyle | string | var(--text-decoration-style-solid) | Sets the style of the text decoration (like solid, wavy, dotted, dashed, double) |
textDecorationColor | string | var(--text-decoration-color-currentColor) | Sets the color of the text decoration |
textDecoration | string | var(--text-decoration) | Shorthand for setting all the text-decoration-* properties |
textShadow | string | var(--text-shadow-none) | Applies one or more shadows to the text |
textOverflow | string | var(--text-overflow-clip) | Specifies how overflowed content that is not displayed should be signaled to the user |
textJustify | string | var(--text-justify-auto) | Specifies the justification method to use when a line box is justified |
textIndent | string | var(--text-indent-none) | Specifies the indentation of the first line in a text block |
textJustifyTrim | string | var(--text-justify-trim-auto) | Specifies the justification method to use when a line box is justified and has trailing white space |
textAlignLast | string | var(--text-align-last-auto) | Describes how the last line of a block or a line, right before a forced line break, is aligned when text-align is justify |
Usage
This will render a heading of text with the color set to red-500, and the font weight set to bold.
<Heading
color="red-500"
fontWeight="bold"
>
Hello, world!
</Heading>