DEV Community

Cover image for Text Truncation in CSS: Learn Single and Multiple Line Truncation with Ease
Brian Treese
Brian Treese

Posted on • Updated on • Originally published at briantree.se

Text Truncation in CSS: Learn Single and Multiple Line Truncation with Ease

Are you running into scenarios where you have a single line of text that can get too long and you want to truncate it? How about multiple lines that you want to constrain to a known number of lines and then truncate? Well, in this post I’ll show you how to do both with nothing but CSS. Let’s check it out!

Truncating a Single Line of Text With the text-overflow Property

With CSS we have the text-overflow property that we can use any time we want to truncate a single line of text. Seems simple enough right? But there are a couple of things to be on the lookout for so let’s look at an example.

Here, we have some issues with our username display in the header bar for our site. This person has a long name and it’s breaking our layout. Let’s truncate it when this happens.

A single line of text overflowing out of its containing block

Here on our username, we already have white-space set to nowrap because we want to keep the name on a single line.

.username {
  white-space: nowrap;
}
Enter fullscreen mode Exit fullscreen mode

So, to truncate it, we use the text-overflow with a value of ellipsis.

.username {
  white-space: nowrap;
  text-overflow: ellipsis;
}
Enter fullscreen mode Exit fullscreen mode

But, nothing happens. This is because we need to do a few more things here. First, text overflow won’t work without adding overflow hidden.

.username {
  white-space: nowrap;
  text-overflow: ellipsis;
  overflow: hidden;
}
Enter fullscreen mode Exit fullscreen mode

Properly Handling text-overflow Within a Flex Container

Another issue we have with this particular example is that it’s contained within our header which is a flex container. Both the nav and our user sections will be flex items that have a min width value of auto by default. We need to make our user item flexible, which we can do by adding a flex of one.

.user {
  flex: 1;
}
Enter fullscreen mode Exit fullscreen mode

And now, we need to allow it to shrink by setting a min-width to zero.

.user {
  flex: 1;
  min-width: 0;
}
Enter fullscreen mode Exit fullscreen mode

Ok now we’re getting somewhere but our avatar is getting a little squeezed.

The username squeezing the avatar

This is probably because we need to make our username flexible too, so, let’s add flex one.

.username {
  white-space: nowrap;
  text-overflow: ellipsis;
  overflow: hidden;
  flex: 1;
}
Enter fullscreen mode Exit fullscreen mode

Yep, that was it.

Single line text truncation final example

Nice, so we have this single line of text truncated properly now. You can check out the final example below:

Truncating Multiple Lines of Text With the line-clamp Property

What if we had multiple lines that we want to truncate? Well, we can do this again with a handful of CSS properties, and the webkit prefixed line-clamp property. Let’s take a look at another example.

Here, we have this list of blog posts that show an excerpt. But, we only want to see three lines of the excerpt in each post.

Single line text truncation final example

Well, let’s add our webkit line-clamp property with a value of three.

p {
  -webkit-line-clamp: 3;
}
Enter fullscreen mode Exit fullscreen mode

Ok, just like the last example, nothing happens. This is because we need a few more properties too. First, we need to set the display property to webkit-box.

p {
  -webkit-line-clamp: 3;
  display: -webkit-box;
}
Enter fullscreen mode Exit fullscreen mode

Then we need to add -webkit-box-orient: with a value of vertical. Almost there I promise.

p {
  -webkit-line-clamp: 3;
  display: -webkit-box;
  -webkit-box-orient: vertical;
}
Enter fullscreen mode Exit fullscreen mode

The last thing we need to add is overflow hidden.

p {
  -webkit-line-clamp: 3;
  display: -webkit-box;
  -webkit-box-orient: vertical;
  overflow: hidden; 
}
Enter fullscreen mode Exit fullscreen mode

Tada. There it is, now these are properly truncated to three lines of text.

Single line text truncation final example

And, even as they shrink and grow, they will continue to show three lines. Pretty cool.

It’s probably important here to mention that, in most cases similar to this, you’d want to be sure that you’re not hiding a lot of text for performance reasons. Like if these excerpts were actually a full blog post here, that wouldn’t be great. It’s better to do something more like what we have where we have a fairly short excerpt for each post and then we truncate with CSS.

The Final Result

Check out the final example below:

Ok, so I think that’s all I have for this now. Until you next time, thanks for reading!

Top comments (0)