Skip to content

Commit df33fad

Browse files
committed
feat(docs): format tooltip.md
1 parent bb31a07 commit df33fad

File tree

1 file changed

+22
-11
lines changed

1 file changed

+22
-11
lines changed

packages/components/tooltip/tooltip.md

Lines changed: 22 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,19 @@
1-
Тултип (tooltip) — подсказка, которая появляется при наведении указателя или при фокусе на элемент интерфейса. В тултипе не может быть интерактивных элементов.
1+
Тултип (tooltip) — подсказка, которая появляется при наведении указателя или при фокусе на элемент интерфейса.
2+
В тултипе не может быть интерактивных элементов.
23

34
### Когда использовать
45

56
- Для коротких поясняющих текстов об элементах интерфейса.
67
- Для вывода подписей к иконкам, рядом с которыми нет текста со значением.
7-
- Если текст не помещается в отведенном месте и обрезается многоточием (например, в колонках таблицы). В этом случае в тултипе выводится полный текст.
8+
- Если текст не помещается в отведенном месте и обрезается многоточием (например, в колонках таблицы). В этом случае
9+
в тултипе выводится полный текст.
810
- Если нужно показать подсказку с заголовками, списками, таблицей и т. д.
911

1012
### Структура компонента
1113

1214
#### Вариации
1315

14-
Нестандартный тултип всегда предпочтительнее системного. Не используйте системный и нестандартный тултип в одном интерфейсе.
16+
Нестандартный тултип всегда предпочтительнее системного. Не используйте системный и нестандартный тултип в одном интерфейсе.
1517

1618
##### Простой
1719

@@ -34,7 +36,9 @@
3436

3537
<!-- example(tooltip-multiple-lines) -->
3638

37-
Иногда удобнее, если текст в тултипе не переносится, а написан в одну строку, например при сравнении хеш-сумм, выводе адресов электронной почты или путей к файлам и папкам. Для подобных случаев максимальную ширину тултипа можно не устанавливать:
39+
Иногда удобнее, если текст в тултипе не переносится, а написан в одну строку, например при сравнении хеш-сумм,
40+
выводе адресов электронной почты или путей к файлам и папкам. Для подобных случаев максимальную ширину тултипа можно
41+
не устанавливать:
3842

3943
<!-- example(tooltip-long) -->
4044

@@ -44,17 +48,20 @@
4448
- Указатель-дятел
4549
- Шапка (необязательно)
4650

47-
Не используйте интерактивные элементы (кнопки, ссылки и пр.) в сложном тултипе, пользоваться ими, как правило, просто невозможно. Если нужно использовать интерактивные элементы, возьмите [поповер](/components/popover).
51+
Не используйте интерактивные элементы (кнопки, ссылки и пр.) в сложном тултипе, пользоваться ими, как правило, просто
52+
невозможно. Если нужно использовать интерактивные элементы, возьмите [поповер](/components/popover).
4853

4954
<div style="margin-top: 5px;">
5055
<img src="./assets/images/tooltip/tooltip-hard__structure.jpg" alt="tooltip hard structure"/>
5156
</div>
5257

5358
##### Размеры
5459

55-
В отличие от простого тултипа, сложный имеет фиксированную ширину. Чтобы оптимально использовать пространство, полезно заложить несколько вариантов ширины.
60+
В отличие от простого тултипа, сложный имеет фиксированную ширину. Чтобы оптимально использовать пространство,
61+
полезно заложить несколько вариантов ширины.
5662

57-
Высота тултипа зависит от контента. Рекомендуемая максимальная высота — 480px (может быть увеличена по усмотрению дизайнера).
63+
Высота тултипа зависит от контента. Рекомендуемая максимальная высота — 480px (может быть увеличена
64+
по усмотрению дизайнера).
5865

5966
### Описание работы
6067

@@ -91,21 +98,24 @@
9198

9299
#### По краю элемента
93100

94-
Край тултипа выравнивается по краю триггерного элемента, указатель на фиксированном расстоянии от края тултипа. Если элемент слишком маленький, указатель выравнивается по центру элемента.
101+
Край тултипа выравнивается по краю триггерного элемента, указатель на фиксированном расстоянии от края тултипа.
102+
Если элемент слишком маленький, указатель выравнивается по центру элемента.
95103

96104
<!-- example(tooltip-placement-edges) -->
97105

98106
**Динамическое выравнивание**
99107

100-
Если для тултипа не хватает места, он попытается перейти в другое положение. Например, из положения «снизу в центре» в положение «сверху в центре».
108+
Если для тултипа не хватает места, он попытается перейти в другое положение. Например, из положения «снизу в центре»
109+
в положение «сверху в центре».
101110

102111
### Стилизация тултипов
103112

104113
#### Простой тултип
105114

106115
Для светлой темы используется темный тултип. Для темной темы используется светлый тултип.
107116

108-
Для предупреждений используется отдельный вид тултипов. Например, он появляется при попытке ввода запрещенного символа в поле (подробнее см. [Валидация](/other/validation))
117+
Для предупреждений используется отдельный вид тултипов. Например, он появляется при попытке ввода запрещенного символа
118+
в поле (подробнее см. [Валидация](/other/validation))
109119

110120
<!-- example(tooltip-overview) -->
111121

@@ -129,4 +139,5 @@
129139

130140
[Дропдаун](/components/dropdown) — кнопка-меню, открывающая список доступных действий.
131141

132-
[Поповер](/components/popover) — небольшой немодальный диалог без затемнения, который открывается рядом с триггерным элементом. Он может содержать текст, поля ввода, любые элементы управления.
142+
[Поповер](/components/popover) — небольшой немодальный диалог без затемнения, который открывается рядом с триггерным
143+
элементом. Он может содержать текст, поля ввода, любые элементы управления.

0 commit comments

Comments
 (0)