---
title: Showcase 版本亮点
description: 用动效标题、卡片轮播与指标讲清一次发版的发布页
category: TemplateContent
status: beta
since: 0.9.1
tags: [template, marketing, motion, carousel, landing]
syncStatus: reviewed
verified: false
---

> **模板约束（文档站）**：下面的约定来自 Nexus 模板规范，改写或复刻本页时遵守。
>
> - 整页放进 `TemplateFrame`，由它负责展开、收起与尺寸。不要显式 import `Tx*` 组件，它们自动注册。
> - 演示从 `@enter` 开始播放，不要放在 `onMounted` 里。
> - 快捷键绑在模板根元素上，不绑 `window` 或 `document`。
> - 反馈放在舞台内的 `TxToastPanel` 里。禁止 `toast()`、`clearToasts()`、`TxToastHost`、`TxTouchTip`、`TxBottomDialog` 与 `TxBlowDialog`。
> - 完整规范见 `docs/engineering/specs/frontend/nexus-docs-templates.md`。

## 用法

### 版本亮点
:::TuffDemoWrapper{demo="TemplateShowcaseDemo" code-lang="vue" description="进入视口后播放一次，轮播每 4 秒翻一张，碰一下就停；点「重看演示」再看一遍。"}
---
code: |
  <script setup lang="ts">
  import { computed, ref, watch } from 'vue'
  import TemplateFrame from './TemplateFrame.vue'

  const headlineKey = ref(0) // 每递增一次，标题按行揭示一次
  const current = ref(0)
  const autoplay = ref(false) // 进入视口时打开；点按、按键或焦点移进轮播就关掉
  const deckHover = ref(false)
  const hidden = ref(false) // 离屏或标签页隐藏：IntersectionObserver + visibilitychange
  const turning = computed(() => autoplay.value && !deckHover.value && !logOpen.value && !hidden.value)

  // 每次暂停都清掉计时器，恢复时重新计满一整轮
  let slideTimer: ReturnType<typeof setTimeout> | undefined
  function scheduleSlide() {
    clearTimeout(slideTimer)
    if (!turning.value)
      return
    slideTimer = setTimeout(() => {
      current.value = (current.value + 1) % FEATURES.length
      scheduleSlide()
    }, 4000)
  }
  watch(turning, scheduleSlide)

  function onEnter() {
    if (prefersReducedMotion())
      return settle() // 直接显示最终画面，不启动计时器
    headlineKey.value++
    METRIC_IDS.forEach((id, i) => rollMetric(id, 600 + i * 160)) // 从 2.5 的数滚到 2.6 的数
    autoplay.value = true
  }
  </script>

  <template>
    <TemplateFrame title="版本亮点" :height="680" @enter="onEnter">
      <template #default="{ width, height }">
        <!-- 宽屏：标题放到轮播旁边能让轮播更大时加 is-split；--sc-deck-zoom 把卡片层放大到分得的空间（1–2 倍） -->
        <div class="sc" v-bind="stageAttrs(width, height)" data-theme="dark" @pointerdown.capture="onReaderInput" @keydown.capture="onReaderInput">
          <div class="sc-hero">
            <TxFlowLight variant="corners" />
            <TxMotionText
              ref="headlineRef" tag="h2" variant="text-reveal" trigger="manual"
              :text="copy.headline" :replay-key="headlineKey"
              @animation-complete="headlineRef?.reset()"
            />
            <TxMotionButton variant="slide-arrow" active-icon="arrow-right" :label="copy.openLog" @click="openLog" />
            <TxMotionButton variant="rotate" icon="refresh" :label="copy.replay" @click="resetDemo" />
          </div>

          <TxPrismGlow :active="entered && !hidden && !logOpen" placement="top" :collapse-on-grow="false">
            <TxCarousel3D
              v-model="current" variant="card-carousel" :items="cards"
              :size="width >= 960 ? 'lg' : 'md'" loop :controls="false" @change="onDeckChange"
            >
              <template #item="{ item, index }">
                <span class="sc-card" :style="{ background: ART[index] }">{{ item.title }}</span>
              </template>
            </TxCarousel3D>
          </TxPrismGlow>

          <TxMotionMetric
            v-for="card in metricCards" :key="card.id"
            variant="mono-users" size="sm" :data="card.data" :format-value="FORMAT[card.id]"
          />
        </div>
      </template>
    </TemplateFrame>
  </template>
---
:::

## 概述

一个虚构版本「Tuff 2.6」的新功能发布页：动效标题、六张亮点卡片的 3D 轮播与三项指标。所有数字都是示例数据；页面不卖任何东西，没有价格、结账或下载入口。

- 首次进入视口时播放一次：标题按行揭示，副标题与按钮随后淡入，三项指标从 2.5 的数滚到 2.6 的数，轮播每 4 秒翻一张；减少动态效果时直接显示最终画面，不启动计时器。
- 指针停在轮播上时暂停，移开后重新计满 4 秒；在页面里点按、按键，或把焦点移进轮播，自动轮播就停下，轮播右上角的按钮可以重新开始。离屏、切到其他标签页或打开更新日志时同样暂停，棱镜光层随之卸载。
- 拖动、← / →、Home / End 与圆点切换都来自 TxCarousel3D；卡片插画是代码生成的渐变加 SVG 线稿，没有图片请求。
- 自动翻页时不播报：TxCarousel3D 的说明区始终是 `aria-live`，模板把它对读屏隐藏，改用一条只在读者自己切换时播报的提示。
- 指标卡的差值与百分比由 TxMotionMetric 按 `previous` 计算，滚动途中不显示，落定后才出现；每张卡都标着「示例 · 对比 2.5」。
- 「查看更新日志」在舞台内打开侧面板（窄屏为底部面板）；Esc、遮罩或关闭按钮收起它并把焦点还给按钮，全屏时 Esc 只关面板。「重看演示」从头再播一遍。
- 整页在亮暗两种文档主题里都是深色；中等宽度时标题在轮播上方、按钮靠右；窄屏全部纵向排列。宽屏（≥ 960px，如全屏）在高的舞台上把标题留在轮播上方，在矮的舞台上移到轮播旁边，取轮播空间更大的一种，卡片再放大填满这块空间，最多到最大尺寸的两倍。

## 自定义

- 换成真实版本时，亮点、指标与更新日志都是普通常量（`FEATURES`、`METRICS`、`LOG`）；`parts` 在两个版本里都要和总数对得上：耗时取平均，数量相加。
- 卡片插画由 `artOf()` 把 SVG 线稿编码成 data URI，和渐变叠在同一个 `background` 里；改用仓库里的图片时给每项填 `src`，并去掉 `#item` 插槽。
- TxMotionMetric 用同一个 `format-value` 回调格式化数值、分项与差值，只有差值调用时不带 `unit`，模板据此补上正负号和单位；括号里的百分比由组件生成。
- TxCarousel3D 没有自动播放：模板用计时器改 `v-model`。组件只在读者自己切换时发出 `change`，读屏提示就挂在这个事件上。
- TxCarousel3D 最大的 `size` 是 `lg`；再往上，模板用 CSS `zoom`（`--sc-deck-zoom`）放大卡片层，倍数由舞台的 `height` 与实测的标题区、指标区高度算出；说明文字和圆点保持原尺寸。
- `trigger="manual"` 的标题揭示播完后仍算「已请求」，再次进入视口会重播；模板在 `animation-complete` 里调用 `reset()`。
- TxPrismGlow 是纯 CSS 动画，离屏时不会自己停：模板通过 `:active` 在离屏、隐藏标签页和打开更新日志时卸载光层；全屏会让舞台变高，所以关掉 `collapse-on-grow`。

## 相关组件

| 区域 | 组件 | 作用 |
|---|---|---|
| 首屏 | [TxMotionText](/docs/dev/components/motion-text)、[TxFlowLight](/docs/dev/components/flow-light)、[TxMotionButton](/docs/dev/components/motion-button) | 按行揭示的标题、角落光与两个行动按钮 |
| 亮点轮播 | [TxCarousel3D](/docs/dev/components/carousel-3d)、[TxPrismGlow](/docs/dev/components/prism-glow) | 六张亮点卡片与顶部棱镜光 |
| 指标 | [TxMotionMetric](/docs/dev/components/motion-metric) | 从 2.5 滚到 2.6 的三项示例指标 |
| 更新日志 | 手写面板、[TxFlowLight](/docs/dev/components/flow-light) | 舞台内的侧面板与顶边光 |
