Vue 3 中实现点击表格单元格切换文本显示状态的教程

本教程详细介绍了如何在 vue 3 应用中，通过点击表格（`

在现代前端应用中，表格是展示大量数据的重要组件。为了保持界面的整洁和提高可读性，我们常常需要对过长的文本内容进行截断显示。然而，用户在需要时应能方便地查看完整内容。本文将详细讲解如何在 Vue 3 应用中，通过点击表格的

核心思路

实现这一功能的核心在于利用 Vue 3 的响应式系统。我们需要一个状态变量来记录当前哪个单元格的内容处于展开状态。当用户点击一个单元格时，我们更新这个状态变量，然后根据这个状态变量的值，在模板中条件性地渲染截断文本或完整文本。

步骤详解

1. 定义响应式状态

首先，在你的 Vue 3 组件的

<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" 来同时获取邮件对象和其在数组中的索引。
• 点击事件处理： 在 元素上添加 @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>

登录后复制

注意事项与最佳实践

1. 唯一标识符 key： 在 v-for 中，始终使用唯一的 key 属性（如 email.id）。如果数据没有唯一 ID，并且列表项的顺序不会改变，可以使用 index，但通常不推荐，因为它可能导致性能问题或状态混乱。

   

   文心大模型

   百度飞桨-文心大模型 ERNIE 3.0 文本理解与创作

   168

   查看详情

2. 可访问性 (Accessibility)： 对于可点击的单元格，考虑添加 aria-expanded 属性和适当的 role（如 role="button" 或 role="gridcell"），并确保键盘用户也能通过 Tab 键聚焦和 Enter 键激活。

3. 多项展开： 当前实现只允许一个单元格同时展开。如果需要支持多个单元格同时展开，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)

   登录后复制

4. 性能优化： 对于包含成千上万条数据的巨型表格，频繁的 DOM 操作可能影响性能。在这种情况下，可以考虑使用虚拟滚动（Virtual Scrolling）库来只渲染视口内的行。

5. 样式与用户体验： 通过 CSS 为可点击的单元格添加 cursor: pointer; 样式，并在展开时提供视觉反馈（如改变背景色或字体样式），可以显著提升用户体验。在上面的示例中，我们添加了 .subject-cell.expanded 样式来处理展开时的文本显示。

6. title 属性： 使用 title 属性可以在鼠标悬停时显示完整内容，作为点击展开的补充提示，这是一种良好的实践。

总结

通过利用 Vue 3 的响应式 ref 和模板的条件渲染能力，我们可以轻松实现表格单元格点击展开/收起文本内容的功能。这种模式不仅适用于文本内容，也可以扩展到其他需要根据用户交互动态显示或隐藏的元素。理解并熟练运用响应式状态管理是构建交互式 Vue 应用的关键。

以上就是Vue 3 中实现点击表格单元格切换文本显示状态的教程的详细内容，更多请关注php中文网其它相关文章！