SharePoint动态渲染列表 清空搜索后原始数据不复现且列表无填充
搜索功能迁移异常排查与修复
问题背景
- 基于硬编码数组实现的搜索逻辑可正常运行,迁移到SharePoint REST接口的实际业务场景后,出现HTML列表无内容填充、清空搜索框后无法恢复全量数据的问题。
- 业务核心检索字段为
WeekOf,属于SharePoint日期时间类型列,存储格式为YYYY-MM-DD - 预期交互逻辑:页面加载默认展示全部数据,搜索框输入指定日期即可匹配展示对应条目;清空搜索框后自动复现展示全部原始数据。
异常根因定位
- 空值渲染中断:生成列表项时直接对
currData.WeekOf调用.split("T")[0],若某条数据的WeekOf字段为null,会直接抛出JS运行时错误,中断整个循环渲染流程,最终列表容器无内容输出。 - 重复接口请求:代码在全局作用域直接调用一次
loadData(),又在$(document).ready()回调中再次调用loadData(),会重复发起两次SharePoint接口请求,造成列表内容重复渲染。 - 属性选择器大小写不匹配:HTML解析时会自动将自定义属性名转为全小写,列表生成时写的
data-weekOf会被解析为data-weekof,但排序函数的选择器仍使用[data-weekOf]的驼峰写法,导致排序逻辑无法选中目标元素,功能失效。 - 排序逻辑节点重复:原排序函数直接将选中的DOM元素插入列表容器,未提前清空原有内容,会造成同一列表项重复渲染。
- 全量恢复逻辑失效:当列表因前面的渲染中断没有生成任何
li元素时,执行$("li").fadeIn()无实际效果,表现为清空搜索框后无法复现全量数据。
落地修复方案
1. 增加空值防护,避免渲染中断
生成列表项时先判断WeekOf字段是否为空,空值场景给默认值,杜绝JS报错打断循环:
// 原高风险写法 listContent += '<li class="test" data-weekOf="'+currData.WeekOf.split("T")[0]+'">'; // 修复后写法 const weekOfVal = currData.WeekOf ? currData.WeekOf.split("T")[0] : ""; listContent += `<li class="test" data-weekof="${weekOfVal}">`;
2. 统一接口请求时机,移除重复调用
删除全局位置直接执行的loadData()调用,统一将数据加载、列表渲染逻辑放到$(document).ready()回调中执行,确保DOM加载完成后再发起请求,避免重复请求:
// 删除全局位置的独立loadData调用 /* loadData() .then((results) => { // 原渲染逻辑 }); */ // 统一在DOM ready后执行 $(document).ready(function(){ loadData().then((results) => { let listContent = ''; for (var i = 0; i < results.length; i++) { const currData = results[i]; // 列表渲染逻辑补充 const weekOfVal = currData.WeekOf ? currData.WeekOf.split("T")[0] : ""; listContent += `<li class="test" data-weekof="${weekOfVal}">`; // 原有其他列表生成逻辑保持不变 } $('#report-summary').html(listContent); $('#under_txt').text(' '); }); });
3. 对齐属性命名规则,统一选择器写法
所有涉及WeekOf字段的属性名、选择器统一使用全小写的data-weekof,避免大小写匹配偏差:
- 列表生成时的自定义属性名改为
data-weekof - 排序函数内的选择器从
[data-weekOf]改为[data-weekof] - 搜索逻辑的选择器保持
[data-weekof=xxx]的写法,和DOM实际属性名完全对齐
4. 优化排序逻辑,避免节点重复
排序执行前先清空列表容器原有内容,再插入排序后的DOM元素,杜绝重复渲染:
function sortNewestFirst(){ var elements = $('[data-weekof]'); elements.sort(function (a, b) { const dateB = new Date($(b).attr('data-weekof')); const dateA = new Date($(a).attr('data-weekof')); return dateB - dateA; }); $('#report-summary').empty().append(elements); } function sortOldestFirst(){ var elements = $('[data-weekof]'); elements.sort(function (a, b) { const dateA = new Date($(a).attr('data-weekof')); const dateB = new Date($(b).attr('data-weekof')); return dateA - dateB; }); $('#report-summary').empty().append(elements); }
5. 优化搜索逻辑的边界兼容性
对输入值做去空格处理,避免输入内容的空格、格式问题导致匹配失效:
$("#myInput").on("keyup", function() { const value = $(this).val().trim().toLowerCase(); $('#under_txt').text(value); if (value === "") { // 清空搜索时展示所有列表项 $("li").fadeIn(); } else { // 隐藏所有列表项,仅展示日期匹配的条目 $('li').fadeOut(10); $(`li[data-weekof="${value}"]`).fadeIn(); } });
内容的提问来源于stack exchange,提问作者BeerusDev
相关产品推荐
相关产品推荐

