| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081 |
- <!--
- 单行长文本的**共用省略方法**(票 37)—— 共享渲染层里唯一一处声明
- 「溢出省略成 `…`」与「`title` 携带完整原文」的地方。
- 为什么做成组件、而不是在每个 `class` 里各写一遍 `overflow:hidden; text-overflow:ellipsis`
- 再各绑一个 `:title`:维护者 2026-10-13 的原话是「需要一个**共用方法**在所有类似位置统一
- 处理」—— 分头手写正是「早晚不一致」的来源(同一份文本一处省略、一处被裁掉、第三处不省略)。
- 两半职责各只有一处(见 `domain/ellipsis.js` 的文件头):
- · 画标记 → 本组件的 `.ellipsis-text`(平台按真实宽度画 `…`,不用 JS 猜字符宽度);
- · 留原文 → 本组件的 `title`,值来自 `ellipsisTitle()`,**不截断**。
- 用法(`text` 必须是**完整原文**,它既是默认显示内容、也是 title 的来源):
- <EllipsisText class="panel-bar__label" :text="row.label" />
- <EllipsisText tag="b" class="panel-kpi__value" :text="full">{{ shown }}<em>unit</em></EllipsisText>
- 默认插槽存在时,显示内容以插槽为准(可含子元素,如 KPI 的单位、可点的按钮文字),
- `text` 仍只负责 title —— 两者因此不会漂移。
- -->
- <template>
- <component :is="tag" class="ellipsis-text" :class="{ 'ellipsis-text--wrap': wrap }" :title="title">
- <slot>{{ text }}</slot>
- </component>
- </template>
- <script setup>
- import { computed } from 'vue'
- import { ellipsisTitle } from '../domain/ellipsis.js'
- const props = defineProps({
- /** **完整原文**(不截断):`title` 的来源,也是没有插槽时的显示内容。 */
- text: { type: [String, Number], default: '' },
- /** 根元素标签(`span` / `b` / `button` / `h4` …);默认 `span`。 */
- tag: { type: String, default: 'span' },
- /**
- * 可选的**动作提示**,附在完整原文之后(如可点读数的「点它跳哪」)。
- * 刻意做成"附加"而不是"覆盖":title 永远以完整原文开头,原文不会因为要写提示而丢。
- */
- hint: { type: String, default: '' },
- /**
- * 放不下时**换行**而不是画 `…`(维护者 2026-10-28:指标卡尽量不要出现省略号)。
- *
- * 只给 KPI 卡的标签 / 口径小字用:字号已由卡片宽度预算压到可读下限、仍放不下时才换行。
- * 读数(数值)不开这个口子 —— 数字被折断比省略更难读,那边靠降字号兜底。
- */
- wrap: { type: Boolean, default: false },
- })
- const title = computed(() => {
- const full = ellipsisTitle(props.text)
- if (!full) return ''
- return props.hint ? `${full}(${props.hint})` : full
- })
- </script>
- <style scoped>
- /*
- 全仓面板文字的省略标记**只在这里声明一份**(票 37 的落点)。
- `overflow: hidden` 同时让本元素在 flex 布局下把 `min-width: auto` 解析为 0 ——
- 少了它,flex 子项会被内容撑宽,省略永远不会发生。
- */
- .ellipsis-text {
- display: block;
- min-width: 0;
- overflow: hidden;
- white-space: nowrap;
- text-overflow: ellipsis;
- }
- /*
- 换行形态(票 67 追加,2026-10-28 维护者反馈「指标卡尽量不要出现省略号」):
- `white-space: normal` 一开,`text-overflow: ellipsis` 就不再画 `…`(那需要 nowrap),
- 文本自然折行;`overflow-wrap: anywhere` 兜住超长无空格串(如 LOCA 编码),
- 不会横向撑破卡片。省略形态仍只在本文件声明一份(t50 A4 的守卫不动)。
- */
- .ellipsis-text--wrap {
- white-space: normal;
- overflow-wrap: anywhere;
- line-height: 1.15;
- }
- </style>
|