SharePoint列表项操作后跳转问题咨询（含SPServices及自定义表单场景）

嘿，我来帮你搞定这两个SharePoint的技术问题！

这个其实很容易实现，关键是要在SPServices的更新操作完全完成后再执行重定向，避免更新还没生效就跳走。直接用UpdateListItems的completefunc回调就行，它会在异步更新操作结束后触发。

给你个现成的代码示例：

var ListTitle = "SubTask";
var targetItemID = 1; // 替换成你要更新的列表项ID
// 构造更新字段的XML，这里以更新Title字段为例
var updateBatch = "<Batch OnError='Continue'><Method ID='1' Cmd='Update'>" +
  "<Field Name='ID'>" + targetItemID + "</Field>" +
  "<Field Name='Title'>更新后的任务标题</Field>" +
"</Method></Batch>";

$(document).ready(function() {
  $().SPServices({
    operation: "UpdateListItems",
    listName: ListTitle,
    updates: updateBatch,
    completefunc: function(xData, Status) {
      // 先判断更新是否成功
      if (Status === "success") {
        // 替换成你的列表视图实际URL
        window.location.href = "/sites/YourSite/Lists/SubTask/AllItems.aspx";
      } else {
        console.error("列表项更新失败：", xData.responseText);
        alert("更新失败，请检查后重试");
      }
    }
  });
});

几个关键点：

• 一定要在completefunc里执行重定向，这个回调是更新操作的“终点”
• 通过Status参数判断操作结果，避免更新失败也跳转的尴尬情况
• 把列表视图URL换成你站点的实际地址，比如默认的AllItems.aspx页面

你遇到的核心坑是：附件上传是异步操作，直接用window.location.href会立刻终止页面上所有未完成的请求。大文件上传慢，还没传完页面就跳走了，自然只传了一个。

解决思路就是：等所有附件都上传成功后，再执行跳转。这里给你两种靠谱的方案：

方案1：用Promise跟踪所有上传请求（推荐） #

如果是用SharePoint REST API上传附件，把每个附件的上传包装成Promise，然后用Promise.all()等待所有上传完成后再跳转，这是最稳妥的方式。

示例代码：

var ListTitle = "SubTask";
var newItemID = 0; // 提交列表项后拿到的新ID
var attachmentInput = document.getElementById("attachment");
var uploadPromises = [];

// 主流程：先提交列表项，再上传所有附件，最后跳转
function submitForm() {
  // 第一步：提交列表项，获取新创建的itemID
  $.ajax({
    url: _spPageContextInfo.webAbsoluteUrl + "/_api/web/lists/getbytitle('" + ListTitle + "')/items",
    type: "POST",
    headers: {
      "Accept": "application/json;odata=verbose",
      "Content-Type": "application/json;odata=verbose",
      "X-RequestDigest": $("#__REQUESTDIGEST").val()
    },
    data: JSON.stringify({
      __metadata: { type: "SP.Data.SubTaskListItem" },
      Title: "新提交的子任务" // 替换成你的表单字段
    }),
    success: function(res) {
      newItemID = res.d.ID;
      // 第二步：为每个附件创建上传Promise
      for (var i = 0; i < attachmentInput.files.length; i++) {
        uploadPromises.push(uploadSingleAttachment(newItemID, attachmentInput.files[i]));
      }
      // 等待所有附件上传完成
      Promise.all(uploadPromises).then(function() {
        // 所有附件上传成功，跳转列表视图
        window.location.href = "/sites/YourSite/Lists/SubTask/AllItems.aspx";
      }).catch(function(err) {
        console.error("附件上传失败：", err);
        alert("部分附件上传失败，请重试");
      });
    },
    error: function(err) {
      console.error("列表项提交失败：", err);
    }
  });
}

// 单个附件上传的Promise封装
function uploadSingleAttachment(itemID, file) {
  return new Promise(function(resolve, reject) {
    var reader = new FileReader();
    reader.onloadend = function(e) {
      var fileBuffer = e.target.result;
      $.ajax({
        url: _spPageContextInfo.webAbsoluteUrl + "/_api/web/lists/getbytitle('" + ListTitle + "')/items(" + itemID + ")/AttachmentFiles/add(FileName='" + file.name + "')",
        type: "POST",
        headers: {
          "Accept": "application/json;odata=verbose",
          "X-RequestDigest": $("#__REQUESTDIGEST").val(),
          "Content-Length": fileBuffer.byteLength
        },
        processData: false,
        contentType: "application/octet-stream",
        data: fileBuffer,
        success: resolve,
        error: reject
      });
    };
    reader.readAsArrayBuffer(file);
  });
}

方案2：监听插件的上传完成事件（如果你用了multifile这类插件） #

如果你用的是第三方上传插件，比如你提到的multifile，可以监听每个文件的上传完成事件，维护一个计数器，等所有文件都上传完再跳转。

示例代码：

var ListTitle = "SubTask";
var totalAttachments = 0;
var uploadedCount = 0;

$(document).ready(function() {
  // 初始化multifile插件，监听单个文件上传完成事件
  $('#attachment').multifile({
    afterFileUpload: function() {
      uploadedCount++;
      // 检查是否所有附件都上传完毕
      if (uploadedCount === totalAttachments) {
        window.location.href = "/sites/YourSite/Lists/SubTask/AllItems.aspx";
      }
    }
  });

  // 表单提交按钮点击事件
  $("#submit-btn").click(function(e) {
    e.preventDefault();
    // 先获取附件总数
    totalAttachments = $('#attachment')[0].files.length;
    // 先提交列表项，成功后再触发附件上传
    submitListItem(function() {
      $('#attachment').multifile('upload'); // 触发插件上传
    });
  });
});

// 提交列表项的函数
function submitListItem(callback) {
  $.ajax({
    url: _spPageContextInfo.webAbsoluteUrl + "/_api/web/lists/getbytitle('" + ListTitle + "')/items",
    type: "POST",
    headers: {
      "Accept": "application/json;odata=verbose",
      "Content-Type": "application/json;odata=verbose",
      "X-RequestDigest": $("#__REQUESTDIGEST").val()
    },
    data: JSON.stringify({
      __metadata: { type: "SP.Data.SubTaskListItem" },
      Title: "新子任务"
    }),
    success: callback,
    error: function(err) {
      console.error("提交失败：", err);
    }
  });
}

核心提醒：
绝对不要在提交表单后立刻跳转，必须等所有附件的异步请求都完成。Promise.all能精准跟踪每个上传的状态，是最优解；如果用插件，一定要用插件提供的“上传完成”事件来计数，确保每个文件都真正传完了。

内容的提问来源于stack exchange，提问作者Sachchin Annam