如何在 Kendo UI Grid 间跨页面精准定位并选中指定行

秋墨大大_8820

秋墨大大_8820

2026-10-21

353人浏览

原创

如何在 Kendo UI Grid 间跨页面精准定位并选中指定行

本文介绍如何通过服务端过滤与客户端跳转参数协同,实现在仪表盘页选中某工单后,自动跳转至工单详情页并高亮显示对应行,同时兼容直接访问详情页时默认选中首行的场景。

本文介绍如何通过服务端过滤与客户端跳转参数协同,实现在仪表盘页选中某工单后,自动跳转至工单详情页并高亮显示对应行,同时兼容直接访问详情页时默认选中首行的场景。

要实现跨页面的 Kendo Grid 行级联动(即:仪表盘页选中某行 → 跳转至工单页 → 工单页 Grid 自动定位并选中相同 TicketID 的行),核心思路是将选中状态从客户端行为转化为服务端数据契约,避免依赖前端 DOM 操作或 URL 片段传递(易失效、不安全、难维护)。以下是经过验证的生产级解决方案:

✅ 推荐方案:服务端过滤 + 视图模型驱动

  1. 仪表盘页:点击行时携带 TicketID 跳转
    在 Onchange 事件中获取选中项 ID,并重定向至工单页,附带 TicketID 查询参数:

    TP.ClientSite.Banking.Banking.Onchange = function (e) {
        var grid = $("#ClientOpenTicketsDashboard").data("kendoGrid");
        var selectedItem = grid.dataItem(grid.select());
        if (selectedItem && selectedItem.TicketID) {
            window.location.href = "/Ticket/Ticket/Details?ticketId=" + selectedItem.TicketID;
        }
    };
  2. 工单页控制器:接收 TicketID 并注入 ViewModel
    修改 Details Action,支持可选的 ticketId 参数,并将其传入视图模型:

    public async Task<iactionresult> Details(Guid? ticketId = null)
    {
        var vm = new OverviewTicketSystemModel();
        if (ticketId.HasValue)
        {
            vm.TargetTicketID = ticketId.Value; // 新增属性:用于前端 Grid 过滤
            vm.Ticket = await _TicketApiClient.GetTicketByIDAsync(ticketId.Value);
        }
        return View(vm);
    }</iactionresult>

    ✅ 注意:OverviewTicketSystemModel 需新增 public Guid? TargetTicketID { get; set; } 属性。

  3. 工单页视图:为 Grid 启用服务端过滤
    利用 Kendo DataSource 的 .Filter() 方法,仅请求匹配 TargetTicketID 的单条记录(而非全量加载再前端筛选):

    @(Html.Kendo().Grid<tp.objects.entities.generic.ticket>()
        .Name("ClientOpenTicketsTicketPage")
        .Columns(columns => { /* ...保持原有列定义... */ })
        .Selectable(x => x.Enabled(true))
        .Events(events => events
            .Change("TP.ClientSite.Banking.Banking.OnchangeForClientOpenTickets")
            .DataBound("onDataBoundForClientOpenGrid")
        )
        .DataSource(dataSource => dataSource
            .Custom()
            .PageSize(1000)
            .ServerPaging(true)
            .Transport(transport => transport
                .Read(read => read
                    .TPApiUrl("/Ticketing/TicketApi/GetClientOpenTicketsPaged")
                    .Data("GetUserID")
                )
            )
            .Schema(schema => schema
                .Data("Data")
                .Total("Total")
                .Errors("Errors")
                .Model(m => m.Id("TicketID"))
            )
            // ? 关键:服务端过滤,确保只返回目标工单
            .Filter(filters => filters
                .Add(t => t.TicketID).IsEqualTo(Model.TargetTicketID ?? Guid.Empty)
            )
        )
        .Deferred(true)
    )</tp.objects.entities.generic.ticket>

    ⚠️ 注意:Guid.Empty 作为兜底值可避免空值引发异常;若 TargetTicketID 为空,该过滤条件将匹配所有记录(此时需配合前端逻辑处理默认选中)。

  4. 优化 DataBound 逻辑:智能选中
    更新 onDataBoundForClientOpenGrid,仅当有明确目标 ID 时才选中对应行;否则选中首行(满足“直接访问时默认选中第一行”的需求):

    function onDataBoundForClientOpenGrid(e) {
        var grid = $("#ClientOpenTicketsTicketPage").data("kendoGrid");
        grid.tbody.find(">tr").addClass("custom-row-gap");
    
        var targetId = '@(Model.TargetTicketID?.ToString() ?? "null")';
        var selectedRow;
    
        if (targetId !== 'null') {
            // 查找匹配 TicketID 的行(服务端已过滤,通常仅1行)
            selectedRow = grid.tbody.find(`>tr[data-uid="${grid.dataSource.view()[0]?.uid}"]`);
        } else {
            // 直接访问:选中第一行
            selectedRow = grid.tbody.find(">tr").first();
        }
    
        if (selectedRow.length) {
            grid.select(selectedRow);
            selectedRow.trigger("click"); // 确保触发 Change 事件
        }
    }

? 关键优势与注意事项

  • 性能可靠:服务端过滤大幅减少传输数据量,避免客户端遍历千行数据查找 ID;
  • 状态一致:无论从仪表盘跳转还是直接访问,页面初始状态均由服务端决定,无竞态风险;
  • SEO 友好:URL 含语义化参数(?ticketId=xxx),便于调试与分享;
  • 兼容性保障:TargetTicketID 为可空类型,未提供时自动回退至全量数据+首行选中;
  • 安全提示:服务端必须校验 TicketID 所属用户权限(如 _TicketApiClient.GetTicketByIDAsync 内部已做鉴权)。

通过以上设计,您不仅解决了跨页行定位问题,更构建了可扩展、易维护的工单导航体系。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

6355

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

3552

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

3230

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

3239

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

4959

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

3181

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

3009

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

2628

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

2708

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.8万人学习