UI-Grid：一个 AngularJS 数据网格

需要帮助！

访问 http://ui-grid.info 获取文档和教程。加入 https://gitter.im/angular-ui/ui-grid 讨论开发并寻求具体帮助。

我们一直在寻找新的贡献者，对于专业级贡献指南请查看 Contributor.md，如果你是开源新手（或者需要复习），请查看 First Time Open Source Contributor.md，也可以查看 Developer.md

需要一些灵感？看看我们开放的 good first issue 问题，或者如果你想要更有挑战性的问题，可以查看 help wanted 问题

安装

Bower

    bower install angular-ui-grid

    <link rel="stylesheet" type="text/css" href="bower_components/angular-ui-grid/ui-grid.min.css">
<script src="bower_components/angular-ui-grid/ui-grid.min.js"></script>

NPM

    npm install angular-ui-grid

    <link rel="stylesheet" type="text/css" href="node_modules/angular-ui-grid/ui-grid.min.css">
    <script src="node_modules/angular-ui-grid/ui-grid.min.js">

CDN

你可以使用 jsdelivr.com 的 cdn 链接访问文件。只需根据需要更改版本。

Angular 兼容性

UI-Grid 目前兼容 Angular 1.4.x 到 1.8.x 版本。

功能稳定性

UI-Grid 捆绑了几个功能。并非所有功能都是当前稳定的。请参阅以下列表了解每个功能的稳定性：

功能	发布状态
auto-resize-grid (API)	beta
cellnav (API)	稳定
edit (API)	稳定
expandable (API)	alpha
exporter (API)	稳定
grouping (API)	beta
importer (API)	稳定
infinite-scroll (API)	beta
move-columns (API)	alpha
pagination (API)	alpha
pinning (API)	稳定
resize-columns (API)	稳定
row-edit (API)	稳定
saveState (API)	稳定
selection (API)	稳定
tree-base (API)	beta
tree-view (API)	beta

有关功能的更多详细信息，请查看教程。

插件

UI-Grid 有一个出色的插件系统。大多数新功能都可以作为插件添加。请参阅开发者指南中的一些讨论。教程网站上有一个已知插件列表。如果你想将你的插件添加到该列表中，请编辑教程页面并发送拉取请求。

构建

第一步是安装依赖项。需要 git 并且必须可以从命令行使用。如果你没有，请安装 git 并确保可执行文件在你的路径中。如果你是 git 新手，最简单的安装方法是安装 github 客户端。

还需要 grunt 命令行工具。

# 如果你还没有安装 grunt-cli：
> npm install -g grunt-cli

安装了 git 和 grunt-cli 后，只需运行以下命令即可安装所有依赖项。

> npm install
> grunt install

默认的 grunt 任务将测试并将文件构建到 dist/ 中

> grunt

开发

开发"监视"任务。这将在源文件更改时自动重建，如果你更改了 Gruntfile.js，它将重新加载，并重建文档。

在 localhost:9002 上提供你检出的目录的服务器，带有实时重载。导航到 http://localhost:9002/misc/demo 查看演示文件。
在 localhost:9003 上提供 ./docs 目录的服务器。这些是使用 grunt-uidocs-generator 从源代码构建的文档。

grunt dev

默认情况下，grunt dev 将启动几个 karma 后台观察器，这些观察器将针对多个版本的 angular 运行测试。你可以使用 --angular 标志指定要使用的版本：

> grunt dev --angular=1.6.7

> grunt dev --angular=1.5.11,1.6.7

你还可以使用 --browsers 指定要测试的浏览器（默认为 ChromeHeadless）。

> grunt dev --browsers=Chrome

# 针对多个浏览器运行单次测试
> grunt karma:single --browsers=Chrome,Firefox,IE

默认情况下，dev 任务使用 protractor 运行 e2e 测试。如果你遇到它们运行缓慢或挂起的问题，可以使用 --no-e2e 标志禁用它们：

> grunt dev --no-e2e

随着测试主体变大，grunt 任务正在变慢。如果你只在核心功能上工作，可以使用 --core 标志禁用功能的单元测试：

> grunt dev --core

作为开发人员经常使用的选项的快捷方式，还有一个 --fast 标志，相当于 --core --no-e2e --angular=<latest>：

> grunt dev --fast

Karmangular

karmangular 任务针对多个浏览器连续运行测试（它在内部由 dev 任务使用）。

# 在 Chrome 上针对所有可用版本的 Angular 运行测试
> grunt karmangular --browsers=Chrome

# 使用几个版本的 Angular 针对默认的 ChromeHeadless 浏览器运行测试
> grunt karmangular --angular=1.5.11,1.6.7

SauceLabs

ui-grid 设置为在 SauceLabs 上运行。你必须设置 SAUCE_ACCESS_KEY 环境变量。

# 在 IE8 上针对几个版本的 angular 执行测试
> grunt karmangular --angular=1.5.11,1.6.7 --browsers=SL_IE_8

# 在 IE10 上运行监视任务
> grunt dev --browsers=SL_IE10

运行 grunt saucebrowsers 可以看到 SauceLabs 浏览器的完整列表。通常让 Travis 自动进行这种测试就足够了，除非你试图调试特定于浏览器的问题。

2.x 发生了什么？

从 3.0 版本开始，2.x 正式废弃。不会有进一步的发布。如果由于某些原因你需要找到 2.x 源代码，请参阅 2.x 分支。

2.x 文档在这里：https://github.com/angular-ui/ng-grid-legacy/wiki。

仓库重命名

随着 3.0 版本的发布，仓库已从 "ng-grid" 重命名为 "ui-grid"。

所有到 GitHub 的网络流量应该会自动重定向，但他们说你应该更新你的 git 远程 url：

git remote set-url origin https://github.com/angular-ui/ui-grid.git

感谢

感谢 Sauce Labs 和 BrowserStack 免费为开源项目提供他们的测试平台。

支持者

通过每月捐赠支持我们，帮助我们继续我们的活动。[成为支持者] <a href="https://opencollective.com/ui-grid/backer/0/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/108af25b-67b4-4ebd-b4f9-e28c4f6d3101.svg"></a> <a href="https://opencollective.com/ui-grid/backer/1/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/ccc893f5-0234-49a5-9aed-b1cf62ace343.svg"></a> <a href="https://opencollective.com/ui-grid/backer/2/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/28485441-b66d-474e-ba66-7a6c8b259250.svg"></a> <a href="https://opencollective.com/ui-grid/backer/3/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/6ed89449-0b62-4549-a217-9ab02a0fc502.svg"></a> <a href="https://opencollective.com/ui-grid/backer/4/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/5482fc44-5479-4824-8058-a58eb3131cf8.svg"></a> <a href="https://opencollective.com/ui-grid/backer/5/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/6ff65c2d-cc76-4552-8299-33f35ef8b38a.svg"></a> <a href="https://opencollective.com/ui-grid/backer/6/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/ceed402a-51c9-4ece-9d90-bbb621475dd0.svg"></a> <a href="https://opencollective.com/ui-grid/backer/7/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/b1057da9-da32-4200-8aba-d290db6fe78e.svg"></a> <a href="https://opencollective.com/ui-grid/backer/8/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/5e1788fd-88af-4233-9aa4-9829db41461e.svg"></a> <a href="https://opencollective.com/ui-grid/backer/9/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/c9997366-aa3e-4d4e-bfd4-1c47a00f272d.svg"></a> <a href="https://opencollective.com/ui-grid/backer/10/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/8d09c02c-1bcd-4e39-93d4-cbdd560b687b.svg"></a> <a href="https://opencollective.com/ui-grid/backer/11/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/b2c8ecfc-1de5-4121-8c0a-119dac5e0334.svg"></a> <a href="https://opencollective.com/ui-grid/backer/12/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/44cbcb40-a623-4334-9cba-9ae73fcbfd36.svg"></a> <a href="https://opencollective.com/ui-grid/backer/13/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/0c7633db-ad71-4aae-b498-520b6221253d.svg"></a> <a href="https://opencollective.com/ui-grid/backer/14/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/183c8a1d-440e-4b7f-bde6-e98b73d7d165.svg"></a> <a href="https://opencollective.com/ui-grid/backer/15/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/fc809f45-58af-45bd-b471-d563c850b504.svg"></a> <a href="https://opencollective.com/ui-grid/backer/16/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/a1f27524-d464-4a36-bc95-894f0abecaab.svg"></a> <a href="https://opencollective.com/ui-grid/backer/17/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/b3c0c0a8-8586-467f-ab7b-4ecdb036aef3.svg"></a> <a href="https://opencollective.com/ui-grid/backer/18/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/54b89de7-d5ac-4eaf-a6a3-7602e023703c.svg"></a> <a href="https://opencollective.com/ui-grid/backer/19/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/727471ec-2638-495e-a12f-a4c554f0416f.svg"></a> <a href="https://opencollective.com/ui-grid/backer/20/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/70a28d1d-8ca4-43fd-a7ae-96fb498f1f07.svg"></a> <a href="https://opencollective.com/ui-grid/backer/21/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/8ebfd369-5da1-4dea-9855-1920261c1824.svg"></a> <a href="https://opencollective.com/ui-grid/backer/22/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/5043ab56-950c-410c-9033-477b9fb1d898.svg"></a> <a href="https://opencollective.com/ui-grid/backer/23/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/5e2c97e0-5d77-4da1-aebd-5a377cf04981.svg"></a> <a href="https://opencollective.com/ui-grid/backer/24/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/023597dc-a059-4485-aef2-f6d419326586.svg"></a> <a href="https://opencollective.com/ui-grid/backer/25/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/0e598a58-0a1e-444d-9251-92b9f611ee33.svg"></a> <a href="https://opencollective.com/ui-grid/backer/26/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/682019b1-93e0-4b09-829b-a35bbe16dd61.svg"></a> <a href="https://opencollective.com/ui-grid/backer/27/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/0a23a9af-e8e1-47e3-bc9a-166b05d542d1.svg"></a> <a href="https://opencollective.com/ui-grid/backer/28/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/5b55af3a-bad7-4d73-b25c-b3a7751031af.svg"></a> <a href="https://opencollective.com/ui-grid/backer/29/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/18ded5ab-0197-4228-9505-897be4aa74f9.svg"></a>

赞助商

成为赞助商，在我们的网站和 Github 上的 README 中展示您的徽标，并链接到您的网站。[成为赞助商] <a href="https://opencollective.com/ui-grid/sponsor/0/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/0e6e46e8-a355-4f61-a681-6600d925c84c.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/1/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/359afc51-8235-4ab9-bc8d-58e610c4e2ec.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/2/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/226f3798-b9bb-41db-a81f-97988ae081bd.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/3/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/3a40c0a1-f10b-439b-8aa2-d5ae2c1a43bf.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/4/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/9292cc07-4674-4a66-942e-4f041fc0a764.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/5/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/4e06d98d-a2d7-4d54-a2bd-bd13263b7aaf.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/6/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/879d7d1a-a119-44b2-9722-34f7654eb39d.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/7/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/1febf2a4-4329-4dec-a31a-b4de6f9bb627.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/8/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/83fa0a01-98d0-48a9-90a3-f9f2f713475e.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/9/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/c2d06bf5-95e8-4d55-8781-f6ac60735494.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/10/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/037f11dd-ab3e-40dc-959f-e845c003e31c.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/11/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/7c90d985-7dd6-4adb-a11c-33f24117f457.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/12/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/14e6f660-15dd-4d8a-8543-19bb2bc444e2.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/13/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/6afaa23e-c224-42cc-bb62-23c5309d0f72.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/14/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/cbb5319d-9a93-48c6-a161-eaef7dd089b4.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/15/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/aae6c690-a7a4-4201-ac53-37d29c76de6c.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/16/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/333e1832-9212-4dc0-bc32-82c32defd1cb.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/17/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/c4b0f99a-b36a-4f2e-8354-612d0eb4b514.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/18/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/90de28d7-878e-487e-89d5-d6fde9fb6064.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/19/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/4348cdd2-97d8-4a31-a768-fa67cd9d4cf7.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/20/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/6a43a357-1b98-4672-a2f9-d8648692f150.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/21/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/e3ee79e1-653f-4d67-a8ee-74729204fe24.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/22/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/64818c9f-03b2-4564-a076-11a7ab43c4c2.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/23/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/4a8c8668-049e-4329-b0cb-29afbf0af91f.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/24/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/8e391926-23ec-4aff-8547-208859231a21.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/25/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/d1e40bd1-5ea0-4ccd-b26f-6a221b3b5ee0.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/26/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/c88a1d51-c97a-4195-a5b0-65b0ab3e5114.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/27/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/b0fd067d-4081-4272-91c5-c0ef4c28d934.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/28/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/88ee9ca8-4a02-48f2-8946-9f3b956bf704.svg"></a> <a href="https://opencollective.com/ui-grid/sponsor/29/website" target="_blank"><img src="https://yellow-cdn.veclightyear.com/2b54e442/962139f0-0d77-4feb-a92a-f8eae9e2f55a.svg"></a>