1
1
mirror of https://github.com/primer/css.git synced 2024-12-10 23:26:59 +03:00
css/docs/content/components/truncate.md

54 lines
1.3 KiB
Markdown
Raw Normal View History

2019-07-30 02:56:17 +03:00
---
title: Truncate
path: components/truncate
status: Stable
source: 'https://github.com/primer/css/tree/main/src/truncate'
2019-07-30 02:56:17 +03:00
bundle: truncate
---
The `css-truncate` class will shorten text with an ellipsis.
2019-07-30 02:56:17 +03:00
2019-11-07 11:05:21 +03:00
## Truncate overflow
Combine the `css-truncate` and `css-truncate-overflow` classes to prevent text that overflows from wrapping.
2019-11-07 11:05:21 +03:00
```html live
<div class="col-3">
<div class="css-truncate css-truncate-overflow border p-3">
2019-11-07 11:05:21 +03:00
branch-name-that-is-really-long
</div>
<div class="border p-3 mt-3">
branch-name-that-is-really-long
</div>
</div>
```
## Truncate target
Combine the `css-truncate` and `css-truncate-target` classes for inline (or inline-block) elements with a fixed maximum width (default: `125px`).
2019-11-07 11:05:21 +03:00
```html live
Some text with a
<strong class="css-truncate css-truncate-target">
2019-11-07 11:05:21 +03:00
branch-name-that-is-really-long
</strong>
```
You can override the maximum width of the truncated text with an inline `style` attribute:
2019-11-07 11:05:21 +03:00
```html live
Some text with a
<strong class="css-truncate css-truncate-target" style="max-width: 180px">
2019-11-07 11:05:21 +03:00
branch-name-that-is-really-long
</strong>
2019-07-30 02:56:17 +03:00
```
You can reveal the entire string on hover with the addition of `.expandable`.
2019-11-07 11:05:21 +03:00
```html live
Some text with a
<strong class="css-truncate css-truncate-target expandable">
2019-11-07 11:05:21 +03:00
branch-name-that-is-really-long
</strong>
2019-07-30 02:56:17 +03:00
```