从HTML表格初始化网格
除了创建一个空的网格div
元素,您可以从HTML表中初始化它。
当您从HTML表初始化Grid时,您可以从表结构和元素的HTML属性推断出它的一些设置。这意味着您可以在表格的HTML中完全描述Grid的布局。
HTML表通常已经填充了数据,这提高了可访问性和搜索引擎优化,并确保即使JavaScript被禁用或页面上有JavaScript错误,用户也能看到数据。
当您从HTML表初始化Grid时,小部件使用一个Kendo UI DataSource实例。单元格的内容被提取,并按照以下方式填充DataSource:
- 数据源中数据字段的名称要么从标题单元格的内容创建,要么从
数据字段
标题单元格的属性。 - 数据字段的名称必须是有效的JavaScript标识符。因此,建议使用
数据字段
属性。否则,报头的单元格内容必须满足以下要求:- 没有空格
- 无特殊字符
- 第一个字符必须是字母
如果从HTML表创建Grid,但数据源配置为使用传输和远程操作,则会为初始Grid状态发出远程请求,即使该表可能已经填充。这种行为是由设计定义的,除非使用网格的MVC包装器,否则无法避免。
当从现有表创建Grid时,Grid提供列
可以通过HTML属性定义的设置。属性的所有属性都必须应用于宽度列样式< th >
元素:
- 的
id
属性定义列的id。 - 的
数据字段
属性定义数据字段的名称。 - 的
宽度
样式应用于各自的< >上校
元素设置列的宽度。 - 的
数据类型
属性定义数据类型。 - 的
数据模板
属性设置列模板。 - 的
数据菜单上
属性启用或禁用列菜单。 - 的
data-sortable
属性启用或禁用排序。 - 的
data-filterable
属性启用或禁用筛选。 - 的
data-groupable
属性启用或禁用分组。 - 的
材料指数
属性为列定义一个从零开始的数字指示器。
将
aria-describedby
属性的单元格对应的列标题在一个可导航的剑道UI网格,定义id
而且材料指数
每个的属性< th >
元素。
中的HTML属性定义其他与列相关的设置是不可能的<表>
.如果必须使用设置,如命令、锁定、编辑器、自定义行、单元格CSS类等,请跳过上述属性配置,并在Grid的JavaScript初始化语句中包含所有设置。方法设置列属性数据列
属性时使用声明性小部件初始化。
如下面的示例所示,Grid的客户机对象附加到<表>
元素。但是,Grid生成的HTML输出完全依赖于小部件的设置,无论小部件的初始化方式如何,它总是相同的。完整的示例请参见演示如何从HTML表初始化Grid.
//用行、列和数据定义HTML表。 < /脚本
另请参阅