# Text ## Description Use text to present your design and content as clearly and efficiently as possible. ## Parameters | Name | Type | Default Value | Description | | :--- | :--- | :------------ | :---------- | | ChildContent | `RenderFragment?` | null | The content of the text. | | Color | `BitColor?` | null | The general color of the text. | | Element | `string?` | null | The custom html element used for the root node. | | ForceBreak | `bool` | false | Forces the text to always break at the end. | | Foreground | `BitColorKind?` | null | The kind of the foreground color of the text. | | Gutter | `bool` | false | If true, the text will have a bottom margin. | | NoWrap | `bool` | false | If true, the text will not wrap, but instead will truncate with a text overflow ellipsis. | | Typography | `BitTypography?` | null | The typography of the text. | | AriaLabel | `string?` | null | Gets or sets the accessible label for the component, used by assistive technologies. | | Class | `string?` | null | Gets or sets the CSS class name(s) to apply to the rendered element. | | Dir | `BitDir?` | null | Gets or sets the text directionality for the component's content. | | ForceAnimation | `bool` | false | Gets or sets a value indicating whether the component's animations play at their full duration even when reduced motion is requested. | | HtmlAttributes | `Dictionary<string, object>` | new Dictionary<string, object>() | Captures additional HTML attributes to be applied to the rendered element, in addition to the component's parameters. | | Id | `string?` | null | Gets or sets the unique identifier for the component's root element. | | IsEnabled | `bool` | true | Gets or sets a value indicating whether the component is enabled and can respond to user interaction. | | Style | `string?` | null | Gets or sets the CSS style string to apply to the rendered element. | | TabIndex | `string?` | null | Gets or sets the tab order index for the component when navigating with the keyboard. | | Visibility | `BitVisibility` | BitVisibility.Visible | Gets or sets the visibility state (visible, hidden, or collapsed) of the component. | ## Public Members | Name | Type | Default Value | Description | | :--- | :--- | :------------ | :---------- | | UniqueId | `Guid` | Guid.NewGuid() | Gets the readonly unique identifier for the component's root element, assigned when the component instance is constructed. | | RootElement | `ElementReference` | | Gets the reference to the root HTML element associated with this component. | ## Enums ### BitColor Enum | Name | Value | Description | | :--- | :--- | :---------- | | Primary | 0 | Info Primary general color. | | Secondary | 1 | Secondary general color. | | Tertiary | 2 | Tertiary general color. | | Info | 3 | Info general color. | | Success | 4 | Success general color. | | Warning | 5 | Warning general color. | | SevereWarning | 6 | SevereWarning general color. | | Error | 7 | Error general color. | | PrimaryBackground | 8 | Primary background color. | | SecondaryBackground | 9 | Secondary background color. | | TertiaryBackground | 10 | Tertiary background color. | | PrimaryForeground | 11 | Primary foreground color. | | SecondaryForeground | 12 | Secondary foreground color. | | TertiaryForeground | 13 | Tertiary foreground color. | | PrimaryBorder | 14 | Primary border color. | | SecondaryBorder | 15 | Secondary border color. | | TertiaryBorder | 16 | Tertiary border color. | ### BitColorKind Enum | Name | Value | Description | | :--- | :--- | :---------- | | Primary | 0 | The primary color kind. | | Secondary | 1 | The secondary color kind. | | Tertiary | 2 | The tertiary color kind. | | Transparent | 3 | The transparent color kind. | ### BitTypography Enum | Name | Value | Description | | :--- | :--- | :---------- | | H1 | 0 | | | H2 | 1 | | | H3 | 2 | | | H4 | 3 | | | H5 | 4 | | | H6 | 5 | | | Subtitle1 | 6 | | | Subtitle2 | 7 | | | Body1 | 8 | | | Body2 | 9 | | | Button | 10 | | | Caption1 | 11 | | | Caption2 | 12 | | | Overline | 13 | | | Inherit | 14 | | ### BitVisibility Enum | Name | Value | Description | | :--- | :--- | :---------- | | Visible | 0 | The content of the component is visible. | | Hidden | 1 | The content of the component is hidden, but the space it takes on the page remains (visibility:hidden). | | Collapsed | 2 | The component is hidden (display:none). | ### BitDir Enum | Name | Value | Description | | :--- | :--- | :---------- | | Ltr | 0 | Ltr (left to right) is to be used for languages that are written from the left to the right (like English). | | Rtl | 1 | Rtl (right to left) is to be used for languages that are written from the right to the left (like Arabic). | | Auto | 2 | Auto lets the user agent decide. It uses a basic algorithm as it parses the characters inside the element until it finds a character with a strong directionality, then applies that directionality to the whole element. | ## Examples \n**Basic**: ```razor This is default (Subtitle1) H1. Heading H2. Heading H3. Heading H4. Heading H5. Heading H6. Heading Subtitle1. Once upon a time Subtitle2. Once upon a time Body1. Once upon a time, stories wove connections between people, a symphony of voices crafting shared dreams. Body2. Once upon a time, stories wove connections between people, a symphony of voices crafting shared dreams. Button. Click Me Caption1. Hello World! Caption2. Hello World! Overline. this is overline text. ``` \n**Wrapping**: ```razor Once upon a time, stories wove connections between people, a symphony of voices crafting shared dreams. Once upon a time, stories wove connections between people, a symphony of voices crafting shared dreams. 1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890 ``` \n**Align**: ```razor Start Center End ``` \n**Foreground**: ```razor Primary foreground Secondary foreground Tertiary foreground
Transparent foreground
``` \n**Color**: ```razor Primary color Secondary color Tertiary color Info color Success color Warning color SevereWarning color Error color PrimaryBackground color SecondaryBackground color TertiaryBackground color PrimaryForeground color SecondaryForeground color TertiaryForeground color PrimaryBorder color SecondaryBorder color TertiaryBorder color ```