内容网站的Vue编辑表单切换文章时,如何避免沿用上一篇的输入状态?

发布人:A5数据发布时间:2026-11-16 13:42阅读量:16

切换到另一篇文章时,编辑器应先清空旧表单,再显示新文章的数据;新文章还没加载完成时,不应继续展示上一篇的输入内容。仅靠 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 的草稿,没有草稿再用接口数据初始化。这样保留的是各自独立的表单快照,而不是把上一篇的内容带进下一篇。

为什么取消请求还需要请求标记

快速切换时可能出现这样的顺序:

  1. 选择文章 A,发出请求 A。
  2. 紧接着选择文章 B,发出请求 B。
  3. 请求 B 先返回,表单显示 B。
  4. 请求 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