You are looking at the documentation of the work in progress Hope UI 1.0, examples and information may be broken or outdated.

Typography

Text

Display text and paragraph with Hope UI styling features.

Import

tsx
import { Text } from "@hope-ui/core";
tsx
import { Text } from "@hope-ui/core";

Usage

Text renders a p tag by default and supports style props, sx and the polymorphic as prop.

I'm a Text

tsx
<Text>I'm a Text</Text>
tsx
<Text>I'm a Text</Text>

Changing the font size

To increase the font size of the text, you can pass the size prop. It applies a combination of fontSize and lineHeight for an optimal reading experience.

(9xl) The quick brown fox

(8xl) The quick brown fox

(7xl) The quick brown fox

(6xl) The quick brown fox

(5xl) The quick brown fox

(4xl) The quick brown fox

(3xl) The quick brown fox

(2xl) The quick brown fox

(xl) The quick brown fox

(lg) The quick brown fox

(base) The quick brown fox

(sm) The quick brown fox

(xs) The quick brown fox

tsx
<VStack spacing={3} align="flex-start">
<Text size="9xl">(9xl) The quick brown fox</Text>
<Text size="8xl">(8xl) The quick brown fox</Text>
<Text size="7xl">(7xl) The quick brown fox</Text>
<Text size="6xl">(6xl) The quick brown fox</Text>
<Text size="5xl">(5xl) The quick brown fox</Text>
<Text size="4xl">(4xl) The quick brown fox</Text>
<Text size="3xl">(3xl) The quick brown fox</Text>
<Text size="2xl">(2xl) The quick brown fox</Text>
<Text size="xl">(xl) The quick brown fox</Text>
<Text size="lg">(lg) The quick brown fox</Text>
<Text size="base">(base) The quick brown fox</Text>
<Text size="sm">(sm) The quick brown fox</Text>
<Text size="xs">(xs) The quick brown fox</Text>
</VStack>
tsx
<VStack spacing={3} align="flex-start">
<Text size="9xl">(9xl) The quick brown fox</Text>
<Text size="8xl">(8xl) The quick brown fox</Text>
<Text size="7xl">(7xl) The quick brown fox</Text>
<Text size="6xl">(6xl) The quick brown fox</Text>
<Text size="5xl">(5xl) The quick brown fox</Text>
<Text size="4xl">(4xl) The quick brown fox</Text>
<Text size="3xl">(3xl) The quick brown fox</Text>
<Text size="2xl">(2xl) The quick brown fox</Text>
<Text size="xl">(xl) The quick brown fox</Text>
<Text size="lg">(lg) The quick brown fox</Text>
<Text size="base">(base) The quick brown fox</Text>
<Text size="sm">(sm) The quick brown fox</Text>
<Text size="xs">(xs) The quick brown fox</Text>
</VStack>

Truncate text

If you'd like to truncate the text after a specific number of lines, pass the lineClamp prop and set it to the desired number of lines.

It will render an ellipsis when the text exceeds the width of the viewport or maxWidth prop.

Lorem ipsum is placeholder text commonly used in the graphic, print, and publishing industries for previewing layouts and visual mockups.

tsx
<Text lineClamp={1}>
Lorem ipsum is placeholder text commonly used in the graphic, print, and publishing industries for
previewing layouts and visual mockups.
</Text>
tsx
<Text lineClamp={1}>
Lorem ipsum is placeholder text commonly used in the graphic, print, and publishing industries for
previewing layouts and visual mockups.
</Text>

Theming

Use the TextTheme type to override Text styles and default props when extending Hope UI theme.

tsx
import { extendTheme, TextTheme } from "@hope-ui/core";
const theme = extendTheme({
components: {
Text: {
// ...overrides
} as TextTheme,
},
});
tsx
import { extendTheme, TextTheme } from "@hope-ui/core";
const theme = extendTheme({
components: {
Text: {
// ...overrides
} as TextTheme,
},
});

Component parts

NameStatic selectorDescription
roothope-Text-rootRoot element

Props

NameTypeDescription
size"xs" | "sm" | "base" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl" | "8xl" | "9xl"The size of the text. It apply a combination of font-size and line-height.
lineClampResponsiveValue<number>The number of lines the text should be truncate.
Previous
Heading
Next
Button