在 Aurelia 中使用 jQWidgets

Question

我想在 Aurelia 项目中使用 jqxGrid 小部件，但我不确定如何调整他们的示例（如下）以在 Aurelia View/View-Model 组件中工作。

看到了运行here.

<!DOCTYPE html>
<html lang="en">
<head>
    <title id='Description'>This example shows how to create a Grid from Array data.</title>
    <link rel="stylesheet" href="../../jqwidgets/styles/jqx.base.css" type="text/css" />
    <script type="text/javascript" src="../../scripts/jquery-1.11.1.min.js"></script>
    <script type="text/javascript" src="../../jqwidgets/jqxcore.js"></script>
    <script type="text/javascript" src="../../jqwidgets/jqxdata.js"></script> 
    <script type="text/javascript" src="../../jqwidgets/jqxbuttons.js"></script>
    <script type="text/javascript" src="../../jqwidgets/jqxscrollbar.js"></script>
    <script type="text/javascript" src="../../jqwidgets/jqxmenu.js"></script>
    <script type="text/javascript" src="../../jqwidgets/jqxgrid.js"></script>
    <script type="text/javascript" src="../../jqwidgets/jqxgrid.selection.js"></script> 
    <script type="text/javascript" src="../../jqwidgets/jqxgrid.columnsresize.js"></script> 
    <script type="text/javascript" src="../../scripts/demos.js"></script>
    <script type="text/javascript">
        $(document).ready(function () {
            // prepare the data
            var data = new Array();
            var firstNames =
            [
                "Andrew", "Nancy", "Shelley", "Regina", "Yoshi", "Antoni", "Mayumi", "Ian", "Peter", "Lars", "Petra", "Martin", "Sven", "Elio", "Beate", "Cheryl", "Michael", "Guylene"
            ];
            var lastNames =
            [
                "Fuller", "Davolio", "Burke", "Murphy", "Nagase", "Saavedra", "Ohno", "Devling", "Wilson", "Peterson", "Winkler", "Bein", "Petersen", "Rossi", "Vileid", "Saylor", "Bjorn", "Nodier"
            ];
            var productNames =
            [
                "Black Tea", "Green Tea", "Caffe Espresso", "Doubleshot Espresso", "Caffe Latte", "White Chocolate Mocha", "Cramel Latte", "Caffe Americano", "Cappuccino", "Espresso Truffle", "Espresso con Panna", "Peppermint Mocha Twist"
            ];
            var priceValues =
            [
                "2.25", "1.5", "3.0", "3.3", "4.5", "3.6", "3.8", "2.5", "5.0", "1.75", "3.25", "4.0"
            ];
            for (var i = 0; i < 200; i++) {
                var row = {};
                var productindex = Math.floor(Math.random() * productNames.length);
                var price = parseFloat(priceValues[productindex]);
                var quantity = 1 + Math.round(Math.random() * 10);
                row["firstname"] = firstNames[Math.floor(Math.random() * firstNames.length)];
                row["lastname"] = lastNames[Math.floor(Math.random() * lastNames.length)];
                row["productname"] = productNames[productindex];
                row["price"] = price;
                row["quantity"] = quantity;
                row["total"] = price * quantity;
                data[i] = row;
            }
            var source =
            {
                localdata: data,
                datatype: "array",
                datafields:
                [
                    { name: 'firstname', type: 'string' },
                    { name: 'lastname', type: 'string' },
                    { name: 'productname', type: 'string' },
                    { name: 'quantity', type: 'number' },
                    { name: 'price', type: 'number' },
                    { name: 'total', type: 'number' }
                ]
            };
            var dataAdapter = new $.jqx.dataAdapter(source);

            $("#jqxgrid").jqxGrid(
            {
                width: 850,
                source: dataAdapter,
                columnsresize: true,
                columns: [
                  { text: 'Name', datafield: 'firstname', width: 120 },
                  { text: 'Last Name', datafield: 'lastname', width: 120 },
                  { text: 'Product', datafield: 'productname', width: 180 },
                  { text: 'Quantity', datafield: 'quantity', width: 80, cellsalign: 'right' },
                  { text: 'Unit Price', datafield: 'price', width: 90, cellsalign: 'right', cellsformat: 'c2' },
                  { text: 'Total', datafield: 'total', cellsalign: 'right', cellsformat: 'c2' }
                ]
            });
        });
    </script>
</head>
<body class='default'>
    <div id='jqxWidget'>
        <div id="jqxgrid">
        </div>
    </div>
</body>
</html>

根据上面的例子，一切都是通过 HTML 脚本标签完成的，这似乎不适用于 Aurelia Views 中使用的 HTML 模板元素。我假设我必须使用 JSPM 将所需的 jqwidgets 文件导入到视图模型中，但我完全不知道该怎么做。

谁能帮我弄清楚如何将上面的示例代码连接到 Aurelia 组件中？（如果有帮助，我有一个空的、可编辑的 Aurelia 项目框架运行宁这里 https://gist.run/?id=6f38a1211eeecafe74c4dd4c960fc2d6&sha=d9959ac0f4d7ad9f3c8385b7b78f648adfc91e11）。

Answer 1

我已经创建了一个基于 aurelia-skeleton-navigation 的示例应用程序，您可以找到这个 here。让我引导您完成相关步骤。

首先你需要安装jqwidgets：jspm install jqwidgets=github:jqwidgets/jQWidgets

确保您也安装了 JSPM 的 css 插件：jspm install css.

在app.html中我们可以加载jqwidgets的CSS部分：<require from="jqwidgets/jqwidgets/styles/jqx.base.css!"></require>。请注意末尾的感叹号，它指示 SystemJS 使用 css 插件加载 css 文件。这个

然后您可以通过创建两个文件来创建一个 my-grid 自定义元素：my-grid.html 和 my-grid.js.

my-grid.html 可能看起来像：

<template>
  <div ref="container"></div>
</template>

在这里你可以看到 ref 属性，它是 Aurelia 特定的代码，它会在视图模型（my-grid.js)，包含对 div 元素的引用。这非常方便，因为我们可以使用此引用来初始化网格，而无需使用 jQuery.

创建我的-grid.js 需要更多工作

import 'jquery';
import 'jqwidgets/jqwidgets/jqxcore';
import 'jqwidgets/jqwidgets/jqxdata';
import 'jqwidgets/jqwidgets/jqxbuttons';
import 'jqwidgets/jqwidgets/jqxscrollbar';
import 'jqwidgets/jqwidgets/jqxmenu';
import 'jqwidgets/jqwidgets/jqxgrid';
import 'jqwidgets/jqwidgets/jqxgrid.aggregates';
import 'jqwidgets/jqwidgets/jqxgrid.columnsreorder';
import 'jqwidgets/jqwidgets/jqxgrid.columnsresize';
import 'jqwidgets/jqwidgets/jqxgrid.edit';
import 'jqwidgets/jqwidgets/jqxgrid.export';
import 'jqwidgets/jqwidgets/jqxgrid.filter';
import 'jqwidgets/jqwidgets/jqxgrid.grouping';
import 'jqwidgets/jqwidgets/jqxgrid.pager';
import 'jqwidgets/jqwidgets/jqxgrid.selection';
import 'jqwidgets/jqwidgets/jqxgrid.sort';
import 'jqwidgets/jqwidgets/jqxgrid.storage';
import {bindable} from 'aurelia-framework';

export class MyGridCustomElement {
  @bindable gridData;

  attached() {
    let source = {
      localdata: this.gridData,
      datatype: 'array',
      datafields:
      [
          { name: 'firstname', type: 'string' },
          { name: 'lastname', type: 'string' },
          { name: 'productname', type: 'string' },
          { name: 'quantity', type: 'number' },
          { name: 'price', type: 'number' },
          { name: 'total', type: 'number' }
      ]
    };

    let dataAdapter = new $.jqx.dataAdapter(source);

    $(this.container).jqxGrid({
      width: 850,
      source: dataAdapter,
      columnsresize: true,
      columns: [
        { text: 'Name', datafield: 'firstname', width: 120 },
        { text: 'Last Name', datafield: 'lastname', width: 120 },
        { text: 'Product', datafield: 'productname', width: 180 },
        { text: 'Quantity', datafield: 'quantity', width: 80, cellsalign: 'right' },
        { text: 'Unit Price', datafield: 'price', width: 90, cellsalign: 'right', cellsformat: 'c2' },
        { text: 'Total', datafield: 'total', cellsalign: 'right', cellsformat: 'c2' }
      ]
    });
  }
}

这里发生了一些事情。首先，在命名 class MyGridCustomElement 时使用 Aurelia 的命名约定，我们可以将此自定义元素与 <my-grid>.

一起使用

您看到的另一件事是大量 import 语句。这将拉入 jqxgrid 的所有部分。我们需要告诉 JSPM 将这些模块加载为 Global，因为 JSPM 将尝试将这些模块加载为 AMD，这将不起作用。

因为我们想将数据传递给 <my-grid> 自定义元素，所以我们需要设置一个属性然后我们可以绑定到。这可以通过使用 @bindable 装饰器装饰 a 来完成。

建议从 attached() 生命周期回调中初始化 jQuery 组件。在 my-grid.html 中，我们添加了 ref="container" 属性，它允许我们使用 container 属性从视图模型初始化网格：$(this.container).jqxGrid({.

此时 <my-grid> 自定义元素已设置，我们可以开始使用它了。

在任何视图中，我选择在 welcome.html 视图中执行此操作，以下将允许您使用 <my-grid> 自定义元素：

<template>
  <require from="./my-grid"></require>

  <my-grid grid-data.bind="data"></my-grid>
</template>

<require> 标签将引入我们的自定义元素，以便我们可以从该视图中使用它。我们现在想将一些数据传递给这个自定义元素。在 my-grid.js 中，我们声明了一个属性 @bindable，它是 gridData 属性。这里我们必须将它转换为 kebab-case (gridData -> grid-data)。我们将 gridData 属性数据绑定到存在于 welcome.js 文件中的 data 属性。

此时我们应该完成了，尽管我们需要指示 JSPM 使用全局模块格式加载 jqxgrid（因为使用默认 AMD 格式无法正确加载）。您可以在 config.js.

中看到必要的配置

在 Aurelia 中使用 jQWidgets

Using jQWidgets in Aurelia

jqwidget

aurelia