内容网站的Vue编辑表单切换文章时,如何避免沿用上一篇的输入状态?
切换到另一篇文章时,编辑器应先清空旧表单,再显示新文章的数据;新文章还没加载完成时,不应继续展示上一篇的输入内容。仅靠 v-model 不会自动完成这件事:需要在文章 ID 变化时重置表单,并防止较慢的旧请求覆盖较快的新请求。

下面用 Vue 3 的 script setup 实现这两个保护,同时保留未保存提示和保存状态。示例假设文章 ID 由父组件提供,加载、保存请求由父组件传入。
在文章 ID 变化时重置并加载
先约定表单只保存当前文章的可编辑字段。加载文章时,用接口返回值重新创建表单对象,而不是让新旧文章共用一个对象。
<script setup lang="ts">
import { computed, ref, watch } from 'vue'
type ArticleForm = {
title: string
content: string
}
type Article = {
id: string
title: string
content: string
}
const props = defineProps<{
articleId: string | null
loadArticle: (id: string, signal: AbortSignal) => Promise<Article>
saveArticle: (id: string, ArticleForm) => Promise<void>
}>()
const emit = defineEmits<{
(event: 'dirty-change', value: boolean): void
(event: 'saving-change', value: boolean): void
}>()
function createEmptyForm(): ArticleForm {
return {
title: '',
content: ''
}
}
const form = ref<ArticleForm>(createEmptyForm())
const baseline = ref<ArticleForm>(createEmptyForm())
const loading = ref(false)
const saving = ref(false)
const loadError = ref('')
const saveError = ref('')
const saveMessage = ref('')
const reloadKey = ref(0)
const isDirty = computed(() => {
return form.value.title !== baseline.value.title
|| form.value.content !== baseline.value.content
})
watch(isDirty, (dirty) => {
emit('dirty-change', dirty)
}, { immediate: true })
watch(saving, (value) => {
emit('saving-change', value)
}, { immediate: true })
let loadToken = 0
let saveToken = 0
watch(
[() => props.articleId, reloadKey],
async ([id], _oldValue, onCleanup) => {
const token = ++loadToken
// 切换文章时,旧保存请求的返回结果也不能更新当前界面。
saveToken += 1
saving.value = false
// 先清空表单和基准值,避免加载期间露出上一篇的内容。
form.value = createEmptyForm()
baseline.value = createEmptyForm()
loadError.value = ''
saveError.value = ''
saveMessage.value = ''
loading.value = Boolean(id)
if (!id) {
return
}
const controller = new AbortController()
onCleanup(() => controller.abort())
try {
const article = await props.loadArticle(id, controller.signal)
// 请求可能在切换文章后才返回,不能用它覆盖当前表单。
if (token !== loadToken || props.articleId !== id) {
return
}
// 避免接口返回了与请求 ID 不匹配的数据。
if (article.id !== id) {
throw new Error('文章 ID 不匹配')
}
const nextForm: ArticleForm = {
title: article.title,
content: article.content
}
form.value = { ...nextForm }
baseline.value = { ...nextForm }
} catch {
if (controller.signal.aborted || token !== loadToken) {
return
}
loadError.value = '文章加载失败,请重试。'
} finally {
if (token === loadToken) {
loading.value = false
}
}
},
{ immediate: true }
)
function reload() {
reloadKey.value += 1
}
async function save() {
const id = props.articleId
if (!id || loading.value || saving.value || loadError.value) {
return
}
const payload: ArticleForm = {
title: form.value.title.trim(),
content: form.value.content
}
if (!payload.title) {
saveError.value = '标题不能为空。'
return
}
const token = ++saveToken
saveError.value = ''
saveMessage.value = ''
saving.value = true
try {
await props.saveArticle(id, payload)
if (token !== saveToken || props.articleId !== id) {
return
}
// 保存成功后,将当前内容设为新的未修改基准。
form.value = { ...payload }
baseline.value = { ...payload }
saveMessage.value = '保存成功。'
} catch {
if (token !== saveToken || props.articleId !== id) {
return
}
saveError.value = '保存失败,请检查网络后重试。'
} finally {
if (token === saveToken) {
saving.value = false
}
}
}
</script>
<template>
<section>
<p v-if="!articleId">请选择一篇文章进行编辑。</p>
<p v-else-if="loading">正在加载文章……</p>
<div v-else-if="loadError" role="alert">
<p>{{ loadError }}</p>
<button type="button" @click="reload">重新加载</button>
</div>
<form v-else @submit.prevent="save">
<label for="article-title">标题</label>
<input
id="article-title"
v-model="form.title"
type="text"
maxlength="120"
required
:disabled="saving"
>
<label for="article-content">正文</label>
<textarea
id="article-content"
v-model="form.content"
rows="18"
required
:disabled="saving"
/>
<p v-if="saveError" role="alert">{{ saveError }}</p>
<p v-else-if="saveMessage" aria-live="polite">{{ saveMessage }}</p>
<button type="submit" :disabled="saving">
{{ saving ? '正在保存……' : '保存文章' }}
</button>
</form>
</section>
</template>
父组件传入当前文章 ID,以及实际的接口方法。例如,loadArticle 需要把 signal 传给支持 AbortSignal 的请求客户端;saveArticle 则应使用传入的文章 ID 发起更新请求。
<ArticleEditor
:article-id="selectedArticleId"
:load-article="loadArticle"
:save-article="saveArticle"
@dirty-change="onDirtyChange"
@saving-change="onSavingChange"
/>
loadArticle 的基本约定是:收到 ID 后请求该文章,并返回带有 id、title 和 content 的对象。saveArticle 使用捕获到的 ID 更新对应文章,不要依赖一个可能已经变化的全局“当前文章”变量。
处理未保存内容和切换时机
重置表单能避免旧输入混入新文章,但也意味着切换时会丢弃尚未保存的修改。父组件应在真正更新 selectedArticleId 前处理确认和保存中的状态:
import { ref } from 'vue'
const selectedArticleId = ref<string | null>(null)
const editorDirty = ref(false)
const editorSaving = ref(false)
function onDirtyChange(dirty: boolean) {
editorDirty.value = dirty
}
function onSavingChange(saving: boolean) {
editorSaving.value = saving
}
function selectArticle(id: string) {
if (editorSaving.value) {
return
}
if (
editorDirty.value
&& !window.confirm('当前文章有未保存的修改,切换后将丢弃。是否继续?')
) {
return
}
selectedArticleId.value = id
}
文章列表的点击事件应调用 selectArticle,而不是直接改写 selectedArticleId。如果项目使用自定义确认弹窗,可以将 window.confirm 换成对应组件。若文章 ID 还可能由路由返回、浏览器前进后退等方式改变,也要在这些入口设置相同的未保存保护。
如果希望切换时保留草稿,不能把同一个表单对象继续用在不同文章上。可以把草稿按文章 ID 分开保存,例如维护 Map<string, ArticleForm>;加载文章时先取该 ID 的草稿,没有草稿再用接口数据初始化。这样保留的是各自独立的表单快照,而不是把上一篇的内容带进下一篇。
为什么取消请求还需要请求标记
快速切换时可能出现这样的顺序:
- 选择文章 A,发出请求 A。
- 紧接着选择文章 B,发出请求 B。
- 请求 B 先返回,表单显示 B。
- 请求 A 后返回。
如果只在请求返回后直接赋值,第四步会把 A 的内容写回表单。代码中用 AbortController 尝试取消旧请求,并用 loadToken 在结果返回时再次核对请求是否仍有效。取消请求和核对标记解决的问题不同:取消可以减少无用工作,标记则负责阻止过期结果更新界面。即使请求客户端不支持取消,标记仍能保护表单。
保存请求也捕获了发起时的文章 ID。切换后,旧保存请求的结果不会改写新文章的界面状态。需要注意,这只保护前端显示,不会撤销已经发往服务器的更新。因此示例在保存期间阻止文章切换;如果业务允许保存中导航,应为路由切换增加同类保护,并根据服务端能力考虑版本号或并发更新校验。
用几种操作核对结果
可以在本地用两篇内容不同的文章检查关键行为:
- 打开 A,在标题和正文中输入未保存内容,再选择 B。确认前应停留在 A;确认切换后,加载期间不显示 A 的输入内容,加载结束后表单显示 B 的数据。
- 快速从 A 切换到 B,并让 A 的请求延迟返回。最终表单应保持 B 的标题和正文。
- 让文章请求失败,确认页面显示加载错误和重新加载入口,而不是继续显示上一篇的内容。
- 保存 A 时确认切换操作受到阻止;保存失败时,A 的输入内容仍在,修改状态也没有被当成已保存。
- 保存成功后再切换文章,回到已保存的文章时应显示服务端保存的数据。
key 也可以用于让 Vue 在文章 ID 变化时销毁并重新创建编辑器组件,例如在父组件上使用 :key="selectedArticleId"。这有助于清理组件本地状态,但不应取代异步请求的有效性检查:请求可能仍在进行,数据也可能写入共享状态或缓存。切换时重置表单、校验异步结果,并明确未保存内容的处理方式,才能分别控制界面状态和数据更新顺序。
内容网站的编辑后台除了表单状态管理,也依赖承载站点、接口与数据库的服务器资源。A5idc数据提供香港、美国、日本、中国台湾、新加坡和马来西亚等地区的物理服务器租用,覆盖常规建站、Xeon与AMD平台及SSD、NVMe存储等配置,可为文章管理系统、内容接口和数据库部署提供不同地区与硬件组合的资源基础。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9818.html