mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-03 00:09:39 +08:00
e645804a09
* docs: new ellipsis measure way * Update docs/blog/line-ellipsis.zh-CN.md Co-authored-by: lijianan <574980606@qq.com> Signed-off-by: 二货爱吃白萝卜 <smith3816@gmail.com> * Update docs/blog/line-ellipsis.en-US.md Co-authored-by: lijianan <574980606@qq.com> Signed-off-by: 二货爱吃白萝卜 <smith3816@gmail.com> --------- Signed-off-by: 二货爱吃白萝卜 <smith3816@gmail.com> Co-authored-by: lijianan <574980606@qq.com>
99 lines
4.0 KiB
Markdown
99 lines
4.0 KiB
Markdown
---
|
||
title: 行省略计算
|
||
date: 2024-03-01
|
||
author: zombieJ
|
||
---
|
||
|
||
Ant Design 的 Typography 组件提供了一个 `ellipsis` 属性，用于在文本溢出时显示省略号。它支持通过配置 `ellipsis.rows` 来限定显示的行数。如果是纯粹的文本内容，它会通过 CSS `-webkit-line-clamp` 属性来实现。虽然有 `-webkit-` 前缀，但是在现代浏览器中都已经得到了很好的支持。
|
||
|
||
```tsx
|
||
<div
|
||
style={{
|
||
display: '-webkit-box',
|
||
overflow: 'hidden',
|
||
WebkitBoxOrient: 'vertical',
|
||
webkitLineClamp: 3,
|
||
}}
|
||
>
|
||
{text}
|
||
</div>
|
||
```
|
||
|
||
|
||
|
||
## CSS 的一些问题
|
||
|
||
然而 CSS 实现也有限制，那就是不支持对省略符号的修改以及对附加操作按钮的支持（比如置于最后的 复制、编辑、展开 等按钮）。
|
||
|
||
|
||
|
||
操作按钮会被一同截断，无法显示。
|
||
|
||
|
||
|
||
虽然有一些黑魔法手段可以通过诸如 `float` 样式来实现，但是这样的方式在不同的浏览器中需要做针对性处理。此外仍然无法解决自定义省略符号的问题。因而目前最好的实现方式仍然是通过 JS 来实现。
|
||
|
||
## JS 实现
|
||
|
||
JS 中，我们通过二分法可以快速的找到文本的截断位置。只要根据 `rows` 推断出文本的高度，然后进行遍历，找到最大可以展示的文字数量即可：
|
||
|
||
|
||
|
||
而行高则可以通过模拟埋入一个 `span` 来获取：
|
||
|
||
```tsx
|
||
<div>
|
||
{text}
|
||
{measuring && <span ref={measureRef}> </span>}
|
||
</div>
|
||
```
|
||
|
||
|
||
|
||
但是这样的方式也有一些问题，对于混合行高的场景（比如添加了图片、嵌入不同大小的文字等等）。这种计算方式往往会估算出错误的总高度，而使得裁剪位置不准确：
|
||
|
||
|
||
|
||
由于图片高度超出了行高，导致计算认为这个图片占用了两行的高度。同时又因为图片本身无法裁剪，使得最终省略行数错误（3 行省略变成了 2 行）：
|
||
|
||
|
||
|
||
如果图片在第一行，那整个文本就会被截断：
|
||
|
||
|
||
|
||
而如果使用 CSS 则不会有这个问题：
|
||
|
||
|
||
|
||
## 混合测量
|
||
|
||
为了解决这个问题，我们可以通过混合测量的方式来解决。即通过 CSS 来测量原生多行省略的总高度，然后再通过 JS 进行二分法来确定文本的截断位置最终不要超过 CSS 测量的总高度：
|
||
|
||
```tsx
|
||
<div ref={measureRef} style={ellipsisStyle}>
|
||
{text}
|
||
</div>;
|
||
|
||
const cssHeight = measureRef.current.clientHeight;
|
||
```
|
||
|
||
```tsx
|
||
// pseudocode. Not used in real world
|
||
<div ref={walkingMeasureRef}>{text.slice(0, walkingMeasureIndex)}</div>;
|
||
|
||
if (walkingMeasureRef.current.clientHeight > cssHeight) {
|
||
// Not meet the requirement
|
||
}
|
||
```
|
||
|
||
这样就可以准确的处理混合行高的场景：
|
||
|
||
|
||
|
||
## 总结
|
||
|
||
通过混合测量的方式，我们可以非常容易的利用 CSS 的准确性和 JS 的灵活性，实现即使在包含图片等不同行高元素的复杂内容中，也能实现准确的文本截断。
|
||
|
||
该重构已经在 `5.15.0` 中发布，欢迎体验。
|