1
1
mirror of https://github.com/primer/css.git synced 2024-12-13 06:38:07 +03:00
css/docs/content/components/truncate.md

59 lines
1.6 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/master/src/truncate'
bundle: truncate
---
The `css-truncate` class will shorten text with an ellipsis. Always add a `title` attribute to the truncated element so the full text remains accessible.
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"
title="branch-name-that-is-really-long">
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"
title="branch-name-that-is-really-long">
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"
title="branch-name-that-is-really-long">
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"
title="branch-name-that-is-really-long">
branch-name-that-is-really-long
</strong>
2019-07-30 02:56:17 +03:00
```