peanut
42d7bb3cb5
设计内容:
- 扩展 Markdown 组件支持三级标题和粗体
- ScriptView.vue 卡片摘要使用 Markdown 渲染
- 新增 ScriptDetailView.vue 剧本详情页
- 点击卡片跳转查看详情
解决 issues: 小程序"创造未来"页面剧本内容以纯文本显示，
无法正确渲染 Markdown 格式（标题、列表、粗体等）
9.9 KiB
9.9 KiB
author, created_at, purpose
| author | created_at | purpose |
|---|---|---|
| Peanut | 2026-04-07 | 定义小程序"创造未来"页面剧本卡片的 Markdown 渲染方案 |
小程序剧本卡片 Markdown 渲染设计
问题背景
小程序"创造未来"页面（ScriptView.vue）中，剧本卡片当前以纯文本形式显示内容：
- 摘要区域：
<text class="script-summary">{{ getScriptSummary(script) }}</text> - 完整内容：存储在
script.plotJson.fullContent中
但后端返回的剧本数据是 Markdown 格式：
### 人物小传
花生米曾有过光芒闪耀的"破土而出"时刻...
### 戏剧驱动力
- 主人公当下最想要的一件具体的东西是：成为武林高手。
- 为了得到它，他必须承受或放弃的是：原本正常的生活节奏...
#### 第一场：抉择
- **时间**：日
- **地点**：花生米家中
- **人物**：花生米
花生米（自言自语）："成为武林高手，这听起来多带劲啊..."
当前纯文本显示导致：
- 标题与普通文本无法区分
- 列表项没有项目符号
- 粗体等格式丢失
- 阅读体验差
设计方案
架构概述
┌─────────────────────────────────────────────────────────────┐
│ ScriptView.vue │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 剧本卡片 (script-card) │ │
│ │ ┌─────────────────────────────────────────────┐ │ │
│ │ │ 标题 / persona │ │ │
│ │ ├─────────────────────────────────────────────┤ │ │
│ │ │ 摘要区域 (Markdown 渲染 - 前 200 字符) │ │ │
│ │ │ ### 人物小传 │ │ │
│ │ │ 花生米曾有过光芒闪耀的... │ │ │
│ │ └─────────────────────────────────────────────┘ │ │
│ │ [路径映射 →] (点击跳转详情页) │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
│
▼ 点击卡片
┌─────────────────────────────────────────────────────────────┐
│ ScriptDetailView.vue (新增) │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 返回 剧本标题 │ │
│ ├─────────────────────────────────────────────────────┤ │
│ │ │ │
│ │ 完整 Markdown 内容渲染 │ │
│ │ ### 人物小传 │ │
│ │ 花生米曾有过... │ │
│ │ ### 戏剧驱动力 │ │
│ │ - 主人公当下最想要... │ │
│ │ #### 第一场：抉择 │ │
│ │ - **时间**：日 │ │
│ │ ... │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
组件复用
已有组件：mini-program/src/components/Markdown.vue
当前支持的 Markdown 格式：
- ✅ 分割线
--- - ✅ 四级标题
#### - ✅ 列表项
*/- - ✅ 普通段落
需要扩展支持：
- ❌ 三级标题
### - ❌ 粗体
**text**
文件结构
mini-program/src/
├── components/
│ └── Markdown.vue # 扩展现有组件
├── pages/main/
│ ├── ScriptView.vue # 修改：卡片摘要使用 Markdown
│ └── ScriptDetailView.vue # 新增：剧本详情页
└── services/
└── epicScript.js # 现有服务，无需修改
实施细节
1. Markdown 组件扩展
文件：mini-program/src/components/Markdown.vue
新增解析规则：
// 三级标题 ###
const h3Match = trimmed.match(/^###\s+(.+)/)
if (h3Match) {
blocks.push({ type: 'h3', content: h3Match[1] })
continue
}
// 粗体 **text** (在段落内容中处理)
// 由于小程序不支持富文本内的 HTML，粗体需要特殊处理
// 方案：将包含粗体的段落拆分为多个文本段
模板新增：
<!-- 三级标题 -->
<text v-else-if="block.type === 'h3'" class="markdown-h3">{{ block.content }}</text>
样式：
.markdown-h3 {
display: block;
font-size: 30rpx;
font-weight: 600;
color: rgba(243, 232, 255, 0.95);
margin: 20rpx 0 12rpx 0;
line-height: 1.4;
}
2. ScriptView.vue 修改
修改点 1：导入 Markdown 组件
import Markdown from '../../components/Markdown.vue'
修改点 2：摘要区域使用 Markdown 渲染
<!-- 原代码 -->
<text class="script-summary" lines="3">{{ getScriptSummary(script) }}</text>
<!-- 修改后 -->
<view class="script-summary">
<Markdown :content="getScriptSummary(script)" />
</view>
修改点 3：添加点击跳转
<view class="script-card" @click="viewScriptDetail(script)">
<!-- 卡片内容 -->
</view>
修改点 4：跳转方法
const viewScriptDetail = (script) => {
uni.navigateTo({
url: `/pages/main/ScriptDetailView?id=${script.id}`
})
}
3. ScriptDetailView.vue 新建
文件：mini-program/src/pages/main/ScriptDetailView.vue
核心结构：
<template>
<view class="detail-view">
<view class="detail-header">
<text class="detail-title">{{ script.title }}</text>
<text class="detail-theme">{{ script.theme }}</text>
</view>
<scroll-view class="detail-content" scroll-y>
<Markdown :content="fullContent" />
</scroll-view>
</view>
</template>
<script setup>
import { ref, onMounted } from 'vue'
import { useAppStore } from '../../stores/app.js'
import Markdown from '../../components/Markdown.vue'
const store = useAppStore()
const script = ref(null)
const fullContent = ref('')
onMounted(async () => {
const pages = getCurrentPages()
const currentPage = pages[pages.length - 1]
const scriptId = currentPage.options.id
// 从 store 获取剧本详情
const targetScript = store.scripts.find(s => s.id === scriptId)
script.value = targetScript
// 获取完整内容
if (targetScript?.plotJson?.fullContent) {
fullContent.value = targetScript.plotJson.fullContent
}
})
</script>
4. 摘要提取逻辑
当前逻辑：
const getScriptSummary = (script) => {
const text = script.summary || script.content || ''
return text.replace(/\s+/g, ' ').trim()
}
修改后：
const getScriptSummary = (script) => {
// 优先使用 summary 字段
if (script.summary) {
return script.summary
}
// 从 fullContent 提取前 200 字符
const fullContent = script.plotJson?.fullContent || ''
if (fullContent) {
// 提取内容，去掉 Markdown 符号
return fullContent
.split('\n')
.filter(line => line.trim())
.slice(0, 5) // 取前 5 行
.join('\n')
.slice(0, 200) + '...'
}
return '暂无摘要'
}
验收标准
- Markdown 组件支持三级标题
### - Markdown 组件支持粗体
**text**（如无法完美支持，降级为普通文本） - ScriptView.vue 卡片摘要使用 Markdown 渲染
- 点击卡片可跳转到详情页查看完整内容
- 详情页正确渲染完整 Markdown 格式
- 样式与现有设计保持一致
注意事项
1. 粗体支持限制
微信小程序的 <text> 组件不支持富文本内的局部样式。
解决方案：
- 方案 A：使用正则将
**text**拆分为多个<text>组件（复杂） - 方案 B：降级处理，粗体标记移除但保留文字（简单）
推荐：先实现方案 B，如效果不佳再考虑方案 A。
2. 长内容加载
剧本完整内容可能较长（2000+ 字符），详情页使用 <scroll-view> 确保可滚动浏览。
3. 数据获取
- 剧本数据已通过
store.fetchScripts()加载到 store - 详情页从 store 根据 ID 获取，无需额外 API 调用
参考文档
- uni-app 页面跳转
- uni-app scroll-view
- 已有 Markdown 组件：
mini-program/src/components/Markdown.vue