[关闭]
@Rays 2017-03-25T23:21:46.000000Z 字数 6280 阅读 1948

四个Webix实例：生成多种类型的JavaScript列表

JavaScript

摘要： 本文通过一些编程实例，展示了如何使用Webix UI库创建以列表形式展示数据的Web组件，其中包括了基本的列表，乃至高级的交互列表。本文介绍了Webix列表所使用的核心理念，给出了Webix列表创建和用户化的具体实现。

作者： Sergey Laptick

正文：

在这篇文章中，我们将介绍如何创建使用各种类型列表显示数据的Web组件。具体而言，我们采用的是Webix UI库。要理解Webix UI的工作机制，我们将会创建一个简单的小组件，以列表形式显示JSON数据，然后为已有数据添加编辑功能，以此来学习如何为组件添加交互能力。我们还会学习如何从已有的Webix部件（Widget）创建满足特定需求的Web组件。最后，我们会介绍一些由Webix提供的更高级类型列表，例如Grouplist和Unitlist。

添加Webix UI库

Webix是一种基于HTML5组件的JavaScript UI软件库，用于创建移动和桌面Web应用。Webix提供了多种多样的组件，从基本的按钮到电子表格，使用这些组件可以开发出类似于Excel的办公Web应用。

Webix不只是提供了UI组件集合，它还提供了事件处理机制、对离线模式的支持以及一系列的开发工具。例如，你可以使用Skin Builder创建自定义的皮肤，或是使用“在线源代码广场”中的代码做实验。

要在你的项目中添加所需的JavaScript和CSS文件，有多种实现途径：

1 下载Webix库软件包，并在codebase文件夹中找到相应的文件。使用如下方式加入Webix支持：

  1. <link rel="stylesheet" href="./codebase/webix.css">
  2. <script src="./codebase/webix.js"></script>

2 使用CDN：

  1. <link rel="stylesheet" href="http://cdn.webix.com/edge/webix.css">
  2. <script src="http://cdn.webix.com/edge/webix.js"></script>

3 通过NuGet安装文件：

  1. nuget install Webix

如果你更习惯Bower，使用：

  1. bower install webix

4 使用Microsoft Visual Studio时，可以在Package Manager Console执行下面的命令：

  1. install-package Webix

创建一个简单的JavaScript列表

开始构建JavaScript列表之前，我们必须要新建一个HTML页面，并在其中添加必需的JavaScript和CSS文件。在本文的例子中，我们使用CDN添加Webix。如果你已经下载了包括所有文件的Webix软件包，也可以直接使用下载文件所在的目录。现在打开项目所在的目录，新建一个名为index.html的HTML文件。该文件可以使用文本编辑器打开，代码如下：

  1. <!doctype html>
  2. <html>
  3.   <head>
  4.     <script src="http://cdn.webix.com/site/webix.js"></script>
  5.     <link rel="stylesheet" type="text/css" href="http://cdn.webix.com/edge/webix.css">
  6.   </head>
  7.   <body>
  8.     <script>
  10.     </script>
  11.   </body>
  12. </html>

Webix的相关代码必须要置于<script></script>标签对之间。在完成编辑后，可以在Web浏览器中打开index.html文件，检查在JavaScript列表中是否包含了所需的数据，并且按照我们的设计意图展示数据。

要初始化Webix，需要将所有代码置入webix.ui()这一构建器中。如果想要确认你的应用是否在页面完全加载后得到了执行，使用webix.ready(function() { ... }。下面给出了代码的基本结构：

  1. webix.ready(function(){
  2.     webix.ui({
  3.         /* 在此处插入用户代码 */
  4.     });
  5. });

我们开始创建列表。Webix支持使用多种数据格式加载数据，包括JSON、XML、CSV和JSArray等。本例中我们使用了JSON格式的数据创建一个关于电影信息的目录列表。下面是我们所使用的例子数据：

  1. var list_data = [
  2.     { id:1, title:"The Shawshank Redemption", year:1994, votes:678790, rating:9.2, rank:1},
  3.     { <...> },
  4.     { id:6, title:"12 Angry Men", year:1957, votes:164558, rating:8.9, rank:6}
  5. ];

要使用Webix创建一个部件，必须要用view属性定义部件类型。如果部件还需要一些数据才能工作，那么还必须要用data属性定义数据源。此外，对于列表而言，可以使用template属性定义数据的渲染方式。

通过下面的例子看一下模板的使用方式。本例中，我们希望显示数据集中的ID、title和year数据项。

  1. webix.ui({
  2.     view: "list",
  3.     data: list_data,
  4.     template: "#id# #title# #year#"
  5. });

结果显示如下：

为增加列表的可读性，对模板稍作更改：

  1. template: "#id#. #title# (#year#)"

这样看上去就更整洁了：

数据模板还允许配置加载后的数据在组件中的展示方式，其中可以包括来自初始数据集的纯文本、JSON键值和XML标记，甚至是能增添展示样式的HTML标记和CSS选择器。查看数据模板的文档页面，了解更多相关内容。

与JavaScript列表的交互：选取和编辑

下面我们将在列表中添加交互功能。我们将从最基本的特性着手，即选取功能。要实现选取列表特定条目的功能，可以使用select属性。

  1. webix.ui({
  2.     view: "list",
  3.     data: list_data,
  4.     template: "#id#. #title# (#year#)",
  5.     select: true //or select: 1
  6. });

就这么简单！

要启用选取多个条目的功能，使用如下的代码：

  1. /* "Ctrl"+click multiselection */
  2. select:"multiselect",
  3. /* "Touch" multiselection */
  4. multiselect:"touch"

要为用户提供编辑列表数据的功能，我们将用到Webix的另一个特性。通过调用protoUI()方法，可以将多个对象的内容合并到一个单一的对象中，并新建一个视图。换句话说，我们可以基于已有的部件去新建一个具有所需特性的部件。

下面创建一个名为editlist的新部件：

  1. webix.protoUI({
  2.     name:"editlist"
  3. }, webix.EditAbility, webix.ui.list);

这里我们将Webix的List视图以及实现通用编辑交互的EditAbility混合类（mixin）汇集在一起。这样就可以在项目中使用这个新建的视图：

  1. webix.ui({
  2.     view: "editlist",
  3.     data: list_data,
  4.     template: "#id#. #title# (#year#). Rating: #rating#",
  5.     select: 1,
  6.     /* 编辑对象的属性 */
  7.     editable: true,
  8.     editor: "text",
  9.     editValue: "title",
  10.     editaction:"dblclick"
  11. });

下面解释一下代码所做的事情。我们启用了编辑特性，并设置了适合的编辑器类型。然后指定了我们需要的编辑标题功能。代码行editaction:"dblclick"表示需要双击打开编辑器。

避免过长的列表：使用分页

如果你有一个特别长的列表，通过上下拉动列表查找所需的条目是非常烦人的。一个可取的解决方案是将列表内容分割为多个页面显示。在继续介绍其它类型的列表之前，我们最后介绍一下分页。此外，分页会帮助我们理解Webix学习中的另一个重要知识点：创建Webix提供的布局。

我们的应用由两个视图组成，一个分页器和一个列表。要在页面上并排使用一个以上的组件，就必须创建一个布局。分页器就是一个独立的部件。使用Webix，我们可以将页面作为行和列的组合进行展示。对于我们的例子而言，需要将页面分成两行。下面代码给出了我们需要做的工作：

  1. webix.ui({
  2.     rows:[
  3.     {
  4.         /* 第一个部件的代码。 */
  5.     },
  6.     {
  7.         /* 第二个部件的代码。 */
  8.     }]
  9. })

通过组合内嵌的行和列，可以创建任一复杂的布局。返回到我们的列表例子，第一个要添加的部件就是分页器。我们需要使用下面的属性初始化分页器：

列表部件的代码与上面例子基本一样。我们需要实现的代码是：

  1. webix.ui({
  2.     rows:[
  3.     {
  4.         view: "pager",
  5.         id:"myPager",
  6.         animate: { direction:”top” },
  7.         group: 10,
  8.         size: 15   
  9.     },
  10.     {
  11.          view:”list”,  
  12.          /* 插入列表的代码。 */  
  13.          pager: "myPager" //链接到分页器。
  14.     }
  15.     ]
  16.     });

下图展示了生成的列表，该列表支持漂亮的动画：

要控制大型数据列表的展示空间，分页并非是唯一的方法。下面让我们看一些Webix能提供的其它类型列表。

其它类型的JavaScript列表

除了上面介绍的普通列表之外，Webix提供了一些具有更多扩展功能的列表。这些列表对于实现特定数据排列任务非常有用：。

让我们从Grouplist开始介绍。

使用更强大的Grouplist升级基本JavaScript列表

如果要在一个列表中使用大量的数据，一种十分有用的方式是按一定的规则将列表条目分组展示。例如，将城市按照国家进行分组，用户在注册页面上选取城市时就会方便很多。

我们现在对前面的例子做一个升级。这次我们将会使用Grouplist，而非基本的列表部件。我们将按上市年份对电影进行分组。下面给出了我们用到的三个属性：

除了上述属性，我们还要使用scheme属性，定义用于数据处理的模式。让我们看一下代码：

  1. webix.ui({
  2.    view:"grouplist",
  3.    data:list_data,
  4.    templateBack: "Year #value#",
  5.    templateGroup:" Year #value#",
  6.    templateItem:"#rank#. #title#",
  7.    scheme:{
  8.         $group:function(obj){
  9.                 /* 列表数据按“year”属性分组。 */
  10.                 return obj.year;
  11.         },
  12.         /* 在各层级中，按“year”或“rank”对展示列表项排序。 */
  13.         $sort:{ by:"value", dir:"desc" }
  14.     },                              
  16. });

这样就得到了一个日期列表，具有如下的展示效果：

点击列表的任一项，就会列出相应年份的电影。列表的最上面一行提供了返回上一页面的功能，该行的展示效果取决于templateBack属性：

你可以看一下演示。放手去试验一下代码。

用于非层次化数据集的Unitlist

Unitlist并未明显地更改列表的观感。Unitlist用于显示非层次化数据集，因此它并不提供层级间的前进或后退功能，而是允许排序数据项，并根据一个设定的值对数据项进行分组，例如根据标题中的首个字母。

下面让我们看一个例子：

  1. webix.ui({
  2.     view:"unitlist",
  3.     template:"#title# (#year#)",
  4.     data: list_data,
  5.     select: true,
  6.     uniteBy:function(obj){
  7.         return obj.title.substr(0,1);
  8.     },
  9. });

这看上去与我们的第一个例子非常相似。但是这里我们所使用的view属性值是“unitlist”，表示使用的是Unitlist部件而非基本列表部件。另一个重要的不同是unitBy属性，该属性用于根据指定条件对数据进行分组。在我们的例子中，使用标题中的第一个字母作为分组准则。

展示结果如下图所示：

这些可视的“锚点”有助于用户在滚动列表时快速地找到需要的分类。使用type等可选属性，还可以更改列表的条目和头部的外观。例如下面的代码：

  1. type:{
  2.     height:50,
  3.     headerHeight:30,
  4. },

将给出如下结果：

  1. type:{
  2.     height:50,
  3.     headerHeight:30,
  4. },

在这里可以看到演示。

使用X-List展示水平条目

让我们通过做一些简单的事情结束本节内容。在展示数据的方式上，X-List不同于JavaScript的List部件，它实现的是列表条目的水平排列。

要在X-List中展示一个常规的列表，必须要添加两个新的属性：

  1. webix.ui({
  2.     view:"list",
  3.     template:"#title# (#year#)",
  4.     data: list_data,
  5.     select: true,
  6.     /* 允许列表水平滚动。 */
  7.     scroll:"x",
  8.     /* 允许列表的水平布局。 */
  9.     layout:"x",
  10. });

结果展示如下：

选择一个适合的解决方案

使用JavaScript列表可以让数据更为结构化，更易于找到所需的信息。UI库提供了使用最小的代价创建列表的方法，更为重要的是，列表可以与其他的有用部件进行组合。我们考虑使用Webix这样的软件库，并学习了四种类型的Webix JavaScript列表的工作方式，还查看了该UI库中的其它特性。

下面的小备忘录有助于你确定如何选择适合的列表类型：

必须要指出的是，这里介绍的仅是Webix的基本用法。更详细的内容请参考Webix文档。

如果按需配置列表部件并与其它的Webix组件组合，就可以创建各种复杂度的Web和移动应用。通过一些在线应用，可以查看到List、Grid、Tree等部件是如何在一个页面中同时生效的。例如XLReporting：

以及GanttPRO：

关于本文作者

Sergey Laptick是一名前端开发人员和Web技术爱好者，对JavaScript和HTML5具有很浓厚的兴趣。他喜欢任何Web相关事物，沉溺于JavaScript编程。当前他全心投入到对新事物的学习当中，并编写学习案例，为初级开发人员提供指导。他也在多个东欧地区会议上分享他的经验。

查看英文原文： How to Make Different Types of JavaScript Lists? 4 Examples with Webix

添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注