本教程详细介绍了如何在 vue 3 应用中，通过点击表格（`
在现代前端应用中，表格是展示大量数据的重要组件。为了保持界面的整洁和提高可读性，我们常常需要对过长的文本内容进行截断显示。然而，用户在需要时应能方便地查看完整内容。本文将详细讲解如何在 Vue 3 应用中，通过点击表格的 <td> 单元格，实现其内容的动态展开与收起。
核心思路
实现这一功能的核心在于利用 Vue 3 的响应式系统。我们需要一个状态变量来记录当前哪个单元格的内容处于展开状态。当用户点击一个单元格时，我们更新这个状态变量，然后根据这个状态变量的值，在模板中条件性地渲染截断文本或完整文本。
步骤详解
1. 定义响应式状态
首先，在你的 Vue 3 组件的 <script setup> 或 setup() 函数中，引入 ref 并定义一个响应式变量来存储当前被点击并展开的邮件的索引。我们将使用 -1 作为初始值，表示没有任何邮件被展开。
<script setup>
import { ref, reactive } from 'vue';
// 假设你的邮件数据和 store 已经定义
const emails = reactive({
data: [
{ id: 1, subject: '这是一封非常长的邮件主题，需要被截断显示以便表格整洁。', body: '...' },
{ id: 2, subject: '另一封邮件主题，长度适中。', body: '...' },
{ id: 3, subject: '又一封邮件，主题也比较长，用于测试展开功能。', body: '...' },
]
});
// 模拟 store 对象，提供截断和完整主题的方法
const store = {
getSubjectTruncated: (email) => {
const maxLength = 20; // 截断长度
return email.subject.length > maxLength ? email.subject.substring(0, maxLength) + '...' : email.subject;
},
getSubject: (email) => email.subject,
};
// 定义响应式变量，用于存储当前展开的邮件索引
const currentShownEmail = ref(-1); // 初始值为 -1，表示没有邮件主题被展开
</script>2. 模板中的条件渲染与事件处理
接下来，我们需要修改表格的模板部分。关键在于：
立即学习“前端免费学习笔记（深入）”；
- 遍历时获取索引： 使用 v-for="(email, index) in emails.data" 来同时获取邮件对象和其在数组中的索引。
-
点击事件处理： 在 <td> 元素上添加 @click 事件监听器。当点击发生时，我们检查 currentShownEmail 是否等于当前行的 index。
- 如果相等，说明当前行已经展开，再次点击应收起，所以将 currentShownEmail 重置为 -1。
- 如果不相等，说明当前行未展开或展开的是其他行，点击应展开当前行，所以将 currentShownEmail 设置为当前的 index。
- 条件性文本渲染： 使用 v-text 指令结合三元表达式。如果 currentShownEmail 等于当前行的 index，则显示完整主题 (store.getSubject(email))；否则，显示截断主题 (store.getSubjectTruncated(email))。
<template>
<table>
<thead>
<tr>
<th>ID</th>
<th>主题</th>
<!-- 其他表头 -->
</tr>
</thead>
<tbody>
<tr v-for="(email, index) in emails.data" :key="email.id">
<td>{{ email.id }}</td>
<!--
点击事件：
如果 currentShownEmail 等于当前行的索引，则点击后将其设置为 -1（收起）；
否则，将其设置为当前行的索引（展开）。
-->
<td @click="currentShownEmail = (currentShownEmail === index ? -1 : index)"
:v-text="currentShownEmail === index ? store.getSubject(email) : store.getSubjectTruncated(email)"
:title="store.getSubject(email)">
<!--
注意：v-text 应该直接放在元素上，而不是作为属性绑定。
这里为了演示，直接使用插值表达式或更正为 v-text="表达式"
-->
{{ currentShownEmail === index ? store.getSubject(email) : store.getSubjectTruncated(email) }}
</td>
<!-- 其他表格数据单元格 -->
</tr>
</tbody>
</table>
</template>修正说明: 在提供的原始答案中 v-text=""currentShownEmail===index? store.getSubject(email) : store.getSubjectTruncated(email)" 语法有些问题。v-text 是一个指令，可以直接赋值表达式，或者在 Vue 3 中，更常见和推荐的做法是直接使用双花括号 {{ }} 进行插值。为了清晰和符合常见实践，上述代码示例中采用了 {{ }} 插值。
3. 完整示例代码
下面是一个完整的 Vue 3 单文件组件示例，展示了如何实现点击表格单元格切换文本显示：
<template>
<div class="email-table-container">
<h2>邮件列表</h2>
<table>
<thead>
<tr>
<th>ID</th>
<th>主题</th>
<th>操作</th>
</tr>
</thead>
<tbody>
<tr v-for="(email, index) in emails.data" :key="email.id">
<td>{{ email.id }}</td>
<td @click="currentShownEmail = (currentShownEmail === index ? -1 : index)"
:title="store.getSubject(email)"
class="subject-cell"
:class="{ 'expanded': currentShownEmail === index }">
{{ currentShownEmail === index ? store.getSubject(email) : store.getSubjectTruncated(email) }}
</td>
<td><button @click="viewEmail(email.id)">查看</button></td>
</tr>
</tbody>
</table>
</div>
</template>
<script setup>
import { ref, reactive } from 'vue';
const emails = reactive({
data: [
{ id: 1, subject: '这是一封非常长的邮件主题，需要被截断显示以便表格整洁。点击我来查看完整内容。', body: '这是邮件1的详细内容...' },
{ id: 2, subject: '另一封邮件主题，长度适中。', body: '这是邮件2的详细内容...' },
{ id: 3, subject: '又一封邮件，主题也比较长，用于测试展开功能。点击我来查看完整内容。', body: '这是邮件3的详细内容...' },
{ id: 4, subject: '短主题邮件。', body: '这是邮件4的详细内容...' },
]
});
const store = {
getSubjectTruncated: (email) => {
const maxLength = 30; // 截断长度
return email.subject.length > maxLength ? email.subject.substring(0, maxLength) + '...' : email.subject;
},
getSubject: (email) => email.subject,
};
const currentShownEmail = ref(-1);
const viewEmail = (id) => {
alert(`查看邮件 ID: ${id}`);
// 实际应用中可能跳转到详情页或打开模态框
};
</script>
<style scoped>
.email-table-container {
padding: 20px;
font-family: sans-serif;
}
table {
width: 100%;
border-collapse: collapse;
margin-top: 20px;
}
th, td {
border: 1px solid #ddd;
padding: 8px;
text-align: left;
}
th {
background-color: #f2f2f2;
}
.subject-cell {
cursor: pointer;
max-width: 300px; /* 限制单元格宽度 */
white-space: nowrap; /* 默认不换行 */
overflow: hidden; /* 隐藏溢出内容 */
text-overflow: ellipsis; /* 显示省略号 */
}
.subject-cell.expanded {
white-space: normal; /* 展开时允许换行 */
overflow: visible; /* 展开时显示全部内容 */
text-overflow: unset; /* 移除省略号 */
}
button {
padding: 5px 10px;
cursor: pointer;
}
</style>注意事项与最佳实践
唯一标识符 key： 在 v-for 中，始终使用唯一的 key 属性（如 email.id）。如果数据没有唯一 ID，并且列表项的顺序不会改变，可以使用 index，但通常不推荐，因为它可能导致性能问题或状态混乱。
可访问性 (Accessibility)： 对于可点击的单元格，考虑添加 aria-expanded 属性和适当的 role（如 role="button" 或 role="gridcell"），并确保键盘用户也能通过 Tab 键聚焦和 Enter 键激活。
-
多项展开： 当前实现只允许一个单元格同时展开。如果需要支持多个单元格同时展开，currentShownEmail 可以改为一个 Set 或数组，存储所有展开项的 index 或 id。
// 支持多项展开 const expandedEmails = ref(new Set()); const toggleExpand = (id) => { if (expandedEmails.value.has(id)) { expandedEmails.value.delete(id); } else { expandedEmails.value.add(id); } }; // 模板中使用：expandedEmails.value.has(email.id) 性能优化： 对于包含成千上万条数据的巨型表格，频繁的 DOM 操作可能影响性能。在这种情况下，可以考虑使用虚拟滚动（Virtual Scrolling）库来只渲染视口内的行。
样式与用户体验： 通过 CSS 为可点击的单元格添加 cursor: pointer; 样式，并在展开时提供视觉反馈（如改变背景色或字体样式），可以显著提升用户体验。在上面的示例中，我们添加了 .subject-cell.expanded 样式来处理展开时的文本显示。
title 属性： 使用 title 属性可以在鼠标悬停时显示完整内容，作为点击展开的补充提示，这是一种良好的实践。
总结
通过利用 Vue 3 的响应式 ref 和模板的条件渲染能力，我们可以轻松实现表格单元格点击展开/收起文本内容的功能。这种模式不仅适用于文本内容，也可以扩展到其他需要根据用户交互动态显示或隐藏的元素。理解并熟练运用响应式状态管理是构建交互式 Vue 应用的关键。
