﻿---
description: Компонент ограничивает текстовый контент, скрывая его за многоточием.
---

# EllipsisText \[tag:component]

Компонент предназначен для ограничения текстового содержимого до определенного количества строк
с добавлением многоточия в конце, если текст превышает заданное ограничение.

```jsx
<EllipsisText maxWidth={200}>
  Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut
  labore et dolore magna aliqua.
</EllipsisText>
```

## Типографика

Необязательно оборачивать типографические компоненты (например, [`Text`](/components/typography#text) или [`Paragraph`](/components/typography#paragraph))
в компонент `EllipsisText` для ограничения количества видимого контента. Достаточно передать типографический компонент в
свойство `Component`:

```jsx
<EllipsisText Component={Footnote} maxWidth={100}>
  Мелкий текст скрыт за многоточием
</EllipsisText>
```

## Известные ограничения \[#limitations]

Для работоспособности компонента необходимо, чтобы у ближайшего родителя была ограничена ширина.
Если это не так, то необходимо ограничить ширину вручную.

Рассмотрим на примере [`HorizontalCell`](/components/horizontal-cell), который при `size="auto"` перестаёт ограничивать ширину.
В качестве ограничивающей ширины будем брать ширину изображения:

```jsx
<HorizontalCell
  size="auto"
  title={
    <EllipsisText maxWidth={100} maxLines={2}>
      Lorem ipsum dolor sit amet, consectetur adipiscing elit
    </EllipsisText>
  }
>
  <Image
    size={100}
    borderRadius="l"
    src="https://sun9-24.userapi.com/c639120/v639120173/3fe6f/tgPr7lecAY4.jpg"
  />
</HorizontalCell>
```

## Свойства и методы \[#api]

| Свойство             | Тип                                                                                             | По умолчанию | Описание                                                                                                                                                                                                                                                                               |
| -------------------- | ----------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Component`          | `ElementType<any, keyof IntrinsicElements>`                                                     | `span`       |                                                                                                                                                                                                                                                                                        |
| `disableNativeTitle` | `boolean`                                                                                       | `false`      | Отключает отображение нативного тултипа с полным текстом.                                                                                                                                                                                                                              |
| `getRootRef`         | `Ref<HTMLElement>`                                                                              | `-`          |                                                                                                                                                                                                                                                                                        |
| `maxLines`           | `number`                                                                                        | `1`          | Максимальное количество видимых строк.  > При `maxLines > 1` используется свойство line-clamp, которое поддерживается не всеми версиями браузеров. Используйте с осторожностью >                                                                                                       |
| `maxWidth`           | `number`                                                                                        | `-`          | Пользовательская маскимальная ширина.  Используйте в случаях, когда у контейнера ширина зависит от размера контента, другими словами, когда ширина не ограничена.                                                                                                                      |
| `ref`                | `Ref<HTMLElement>`                                                                              | `-`          |                                                                                                                                                                                                                                                                                        |
| `render`             | `((props: AllHTMLAttributes<HTMLElement> & Omit<HasRootRef<HTMLElement>, "ref">) => ReactNode)` | `-`          | Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные `className` и `style`). Используется вместо `Component`.  Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер. |
