1

问题:

我可以将“keydown”事件绑定到 jqgrid 单元格吗?

(最终,帖子/问题的目的是解决可访问性问题。)

问题描述:

设想:

用户正在使用箭头键遍历网格的单元格,并且他停在特定的单元格上。
注意:他可以在 jqgrid 单元格之间使用“箭头键”导航,因为 jqgrid 的“cellEdit”参数设置为 true(即cellEdit: true)。他现在在<enter>他停下来的牢房上按下键。

我想要的是<enter>在那个 jqgrid 单元格上捕获产生的 keydown/keyup 事件,并用它做一些事情。

——到目前为止,我的尝试都没有奏效。

FWIW - 产生我的帖子的原始问题: 如果<button>用户决定停止在单元格内部(即,当他们使用箭头键导航网格时),如果用户然后按下该键单元格/按钮,什么都不会发生。

(注意:我已经知道,如果你碰巧到<tab><button>单元格,你会看到按钮是聚焦的,你可以按下 <enter> 键来单击它。但是,随后, <enter> 按下失败。)

- 因此,作为一种解决方法,我决定,如果我至少可以捕获 keydown 事件,那么我可能能够在按钮上触发一个 click 事件 - 以实现我所需要的。

谢谢你的帮助!

(并且,如果我需要进一步澄清或提供其他信息,请告诉我)

现在,我的 jqgrid 列模型定义如下:

    -
    -
    -
    colNames: ['', 'city', 'postal code', 'VIEW'],
    colModel: [
        {name: 'id', label: "id", index: 'id', width: 100, hidden: true},
        {
            name: 'cityName', 
            label: "cityName", 
            index: 'cityName', 
            width: 100, 
            sortable: true,
            cellattr: function(){return 'tabindex="0"'}
        },
        {
            name: 'postalCode', 
            label: "postalCode", 
            index: 'postalCode', 
            width: 100, 
            sortable: true,
            cellattr: function(){return 'tabindex="0"'}
        },
        {
            name: 'view', 
            label: 'view', 
            index: 'view', 
            width: 100, 
            fixed: true,                          
            formatter: function() { return "<button tabindex='0' class='cellbtn' type='button'>View</button>";}
        }
    ],
    -
    -
    -

在此处输入图像描述


完整的“独立” html 示例页面

(即,您应该能够保存到 HTML 文件并运行它)***

注意:有人建议我尝试尝试“editOptions”/“dataEvents”参数解决方案(使用列模型捕获 keypress/keydown/keyup 事件)。目前,我已注释掉用于尝试此解决方案的代码,因为它不起作用。

本质上,提供此页面的目的是提供有关使用“箭头”键导航的说明。如果您运行该页面,则可以单击一个单元格,然后使用箭头键四处导航。试着停在“按钮”单元格上并按下<enter>键……——你会发现现在什么都没有发生。

另一个更新:

我对“loadComplete”功能进行了轻微修改 - 现在按钮在通过键单击后将保持焦点<enter>。(再次感谢,奥列格)


    <!DOCTYPE html>
    <html>
        <head>
            <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
            <title>cellbutton click test</title>

            <!-- Import jQuery UI and jqGrid UI -->
            <link href="http://code.jquery.com/ui/1.8.13/themes/base/jquery-ui.css" rel="stylesheet" media="screen" type="text/css" />
            <link href="http://trirand.com/blog/jqgrid/themes/ui.jqgrid.css" rel="stylesheet" type="text/css" />

            <!-- Import jQuery jqGrid JS files -->
            <script type="text/javascript" src="http://code.jquery.com/jquery-1.8.0.js"></script>
            <script type="text/javascript" src="http://trirand.com/blog/jqgrid/js/i18n/grid.locale-en.js"></script>
            <script type="text/javascript" src="http://trirand.com/blog/jqgrid/js/jquery.jqGrid.src.js"></script>

            <script type="text/javascript">
                $(function () {
                    //...data for table
                    var localdata = [
                            {id: "1", cityName: "springfield", postalCode: "11111"},
                            {id: "2", cityName: "new york", postalCode: "22222"},
                            {id: "3", cityName: "huntington", postalCode: "33333"}
                        ];

                    $("#testgrid").jqGrid({
                        datatype: "local",
                        data: localdata,
                        cellsubmit: 'clientArray',
                        cellEdit: true,
                        colNames: ['', 'city', 'postal code', 'VIEW'],
                        colModel: [
                            {name: 'id', label: "id", index: 'id', width: 100, hidden: true},
                            {
                                name: 'cityName', 
                                width: 100, 
                                //editable: true,
                                cellattr: function(){return 'tabindex="0"'}
                            },
                            {
                                name: 'postalCode', 
                                width: 100, 
                                //editable: true,
                                cellattr: function(){return 'tabindex="0"'}
                            },
                            {
                                name: 'view', 
                                width: 100, 
                                fixed: true,                        
                                formatter: function() { return "<button tabindex='0' class='cellbtn' type='button'>View</button>";}
                            }
                        ],
                        rowNum: 10,
                        rowList: [10, 20, 30],
                        pager: '#pager',
                        sortname: 'id',
                        //viewrecords: true,
                        height: "auto",
                        sortorder: "desc",
                        caption: "test",
                        rownumbers: true,
                        //loadonce: true, //otherwise, sort will reload data from server (i.e., erasing any client-side input that has not yet been posted)...
                        loadComplete: function() {
                            $("th[id^='testgrid_']").attr("tabindex", "0");

                            $(this).find("button.cellbtn").click(function (e) {
                                var rowid = $(this).closest("tr.jqgrow").attr("id");
                                $("<span>View button are clicked. The rowid=" + rowid +
                                  "<br/></span>").appendTo("#log");
                                setTimeout(function () 
                                {                                   
                                    $(e.target).focus();
                                }, 50);                           
                            });                     
                        },
                        afterEditCell: function (rowid) 
                        {
                            var $editControl = $("#" + rowid).find("input, select, textarea");
                            var events = $._data($editControl[0], "events"); // old jQuery: $editControl.data("events")
                            var originalKeydown;

                            if (events && events.keydown && events.keydown.length === 1) 
                            {
                                originalKeydown = events.keydown[0].handler; // save old

                                $editControl.unbind("keydown");
                                $editControl.bind("keydown", function (e) 
                                {
                                    var $viewButton;
                                    // we can do something before jqGrid process "keydown" event
                                    if (e.keyCode === 13 && e.target.id.split("_")[1] === "postalCode") 
                                    {
                                        $("<span>Enter are pressed(A)<br/></span>").appendTo("#log");
                                        setTimeout(function () 
                                        {
                                            $viewButton = $(e.target).closest("td").next("td").find("button.cellbtn");                                  
                                            $viewButton.focus();
                                        }, 50);                                 
                                    } 
                                    else 
                                    if (e.keyCode === 9 && e.target.id.split("_")[1] === "postalCode") 
                                    {
                                        $viewButton = $(e.target).closest("td").next("td").find("button.cellbtn");
                                    }
                                    originalKeydown.call(this, e);
                                    // we can do something after jqGrid process "keydown" event
                                    if (e.keyCode === 9 && $viewButton !== undefined) 
                                    {
                                        $("<span>Tab are pressed so that View button has focus.<br/></span>").appendTo("#log");
                                        setTimeout(function () 
                                        {
                                            $viewButton.focus();
                                        }, 50);
                                    }
                                });
                            }
                        }
                    });
                    $("#pager_left").hide();
                });            
            </script>
        </head>
        <body>
            <form id="form1">
                <div tabindex="0" id="gridx" class="editFormTable">
                    <table tabindex="0" id="testgrid"></table>
                    <div tabindex="0" id="pager" ></div>
                    <div id="log"></div>
                </div>
            </form>
        </body>
    </html>
4

2 回答 2

6

如果我正确理解您的问题,您希望Enter在单元格编辑期间按下 jqGrid 进程键之前或之后执行一些操作。jqGrid 没有任何可以直接用于此目的的回调。不过,您可以使用 jQuery 事件的“子类化”相对容易地解决问题。

首先,您可以检查 jqGrid 的源代码并找出将事件处理程序绑定到单元格中任何或子元素的之后(见)回调和事件将被调用。因此,例如在回调内部,您可以检查绑定到或处理事件的事件句柄。您可以保存绑定到 jqGrid 事件句柄的原始句柄,取消绑定并将其替换为您自己的回调。在您的事件句柄中,您可以调用 jqGrid 的原始句柄,但您可以有条件地执行此操作,并且您可以在处理 jqGrid 之前或之后添加一些操作keydown<input><select><textarea><td>afterEditCelljqGridAfterEditCellafterEditCell<input><select><textarea>keydownkeydown事件。您将在演示中找到相应的代码。它使用以下内容afterEditCell

afterEditCell: function (rowid) {
    var $editControl = $("#" + rowid).find("input, select, textarea"),
        events = $._data($editControl[0], "events"),
                 // old jQuery: $editControl.data("events")
        originalKeydown;

    if (events && events.keydown && events.keydown.length === 1) {
        originalKeydown = events.keydown[0].handler; // save old

        $editControl.unbind("keydown");
        $editControl.bind("keydown", function (e) {
            // we can do something before jqGrid process "keydown" event
            if (e.keyCode === 13) {
                $("<span>Enter are pressed.<br/></span>").appendTo("#log");
            }
            originalKeydown.call(this, e);
            // we can do something after jqGrid process "keydown" event
        });
    }
}

更新:我仍然不确定我是否正确理解了您的要求,但我想您需要Tab在“查看”按钮(TabpostalCode列中按下)之前在字段中按下的用户中执行一些操作。您可以将焦点设置在“查看”按钮上,如果用户按下Enter则将click触发“查看”按钮的处理程序。我认为这是您尝试实施的。

该演示演示了这种行为。它使用以下代码:

$("#testgrid").jqGrid({
    ...
    loadComplete: function() {
        ...
        $(this).find("button.cellbtn").click(function () {
            var rowid = $(this).closest("tr.jqgrow").attr("id");
            $("<span>View button are clicked. The rowid=" + rowid +
              "<br/></span>").appendTo("#log");
        });
    },
    afterEditCell: function (rowid) {
        var $editControl = $("#" + rowid).find("input, select, textarea"),
            events = $._data($editControl[0], "events"), // old jQuery: $editControl.data("events")
            originalKeydown;

        if (events && events.keydown && events.keydown.length === 1) {
            originalKeydown = events.keydown[0].handler; // save old

            $editControl.unbind("keydown");
            $editControl.bind("keydown", function (e) {
                var $viewButton;
                // we can do something before jqGrid process "keydown" event
                if (e.keyCode === 13) {
                    $("<span>Enter are pressed.<br/></span>").appendTo("#log");
                } else if (e.keyCode === 9 && e.target.id.split("_")[1] === "postalCode") {
                    $viewButton = $(e.target).closest("td").next("td").find("button.cellbtn");
                }
                originalKeydown.call(this, e);
                // we can do something after jqGrid process "keydown" event
                if (e.keyCode === 9 && $viewButton !== undefined) {
                    $("<span>Tab are pressed so that View button has focus.<br/></span>").appendTo("#log");
                    setTimeout(function () {
                        $viewButton.focus();
                    }, 50);
                }
            });
        }
    }
});

第二行的编辑结果,在postalCode列中按 Tab,然后按Enter“查看”按钮如下图所示

在此处输入图像描述

于 2013-08-26T17:53:24.277 回答
1

您可以使用dataEvents. 如wiki中所述,它的类型为 array 并且是:

应用于数据元素的事件列表;用于$(”#id”).bind(type, [data], fn)将事件绑定到数据元素。

 {name:"postalCode",index:"postalCode",width:80,align:"right",editable:true,sortable:true,
  editrules:{number:true},formatter:'integer',search: false,
  editoptions:{size:14,maxlength:14,
                dataEvents: [
                        {
                         type: 'keypress',
                         fn: function(e) {
                                           var key = e.charCode || e.keyCode; // to support all browsers
                                           //something on key press by manipulating above value

                                }
                        },
                        {  type: 'change',
                            fn: function(e) {
                            //something if value changed
                            }
                        }
                       ]}},
于 2013-08-22T04:33:31.537 回答