动态网格
最后更新于:2022-04-01 22:22:50
# 动态网格
创建可排序、可过滤的多列动态网格布局。
动态网格组件允许你利用[网格组件](grid.html)创建一个动态的响应式网格布局。在任何尺寸的设备中,网格单元都将自动地、流动地、无缝地调整自身构建无缝的多列布局。
* * *
## 用法
使用这个组件,添加 `data-uk-grid` 属性到容器元素。用 [网格组件](grid.html) 中的 `uk-width-*` 或 `.uk-grid-width-*` 类来设置网格单元的宽度。注意 使用此组件需要额外添加 `grid.js` 文件,在`js/components`文件夹中。
### Example
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-05-12_57346f3a9defd.jpg)
### Markup
```
```
* * *
### 网格排水沟/Grid Gutter
用排水沟将网格单元分开,在data属性中使用 `{gutter: 20}` 选项即可。此时,排水沟会是20px宽。
### Example
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-05-12_57346f3aae29a.jpg)
### Markup
```
```
* * *
## 排序
升序排列网格单元,添加 `{controls: '#my-id'}` 选项到data属性指向排序控件的id。
每个控件需要带有 `data-uk-sort` 属性以及一个自定义值以指明你想要进行排序的种类,比如 `data-uk-sort="my-category"`。同样,你需要添加带有指定分类名称的data属性到每个网格单元中。 自定义的值包含应该被排序的数据,比如 `data-my-category="my-data"`。
网格单元默认按升序排序。要实现降序,只需添加 `:desc` 到排序控件的data属性值中,比如 `data-uk-sort="my-category:desc"`。
### Example
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-05-12_57346f3adae32.jpg)
### Markup
```
```
* * *
### 多个类别
要使用多个类别来进行网格单元的排序,为每个类别使用不同的名字就行了。
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-05-12_57346f3aee653.jpg)
### Markup
```
```
* * *
## JavaScript 选项
| 选项 | 可用值 | 默认值 | 描述 |
| --- | --- | --- | --- |
| `colwidth` | integer | auto | 列宽 |
| `animation` | boolean | true | 是否开启列刷新的动画 |
| `duration` | integer | 200 | 动画持续时间 |
| `gutter` | integer | 0 | 列与列之间的排水沟 |
| `controls` | string | false | 联结过滤器或排序控件的 CSS 选择器 |
| `filter` | string | '' | 单元过滤器 |
### 手动初始化
```
var grid = UIkit.grid(element, { /* options */ });
```
### Events
| 名称 | 参数 | 描述 |
| --- | --- | --- |
| `beforeupdate.uk.grid` | event, children | 网格刷新前触发 |
| `afterupdate.uk.grid` | event, children | 网格刷新后触发 |
### Example
用jQuery监听beforeupdate事件:
```
$(function() {
$('[data-uk-grid]').on('beforeupdate.uk.grid', function(e, children) {
// your event-handling goes here
});
});
```
';
...
...
...
...
...
```
* * *
## 过滤
你还可以过滤网格,使其只在页面中显示特定的网格单元。You can also filter your grid so that only particular items will be displayed. 为此,添加 `{controls: '#my-id'}` 选项到data属性指向过滤器的id。每个过滤控制器都必须有 `data-uk-filter` 属性来定义你想要的过滤分类。你还必须为每个网格单元添加 `data-uk-filter` 属性以明确其归属于哪个分类。使用逗号分隔多段分类。
### Example
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-05-12_57346f3ac6541.jpg)
### Markup
这个例子使用了 [二级导航](subnav.html) 来过滤网格单元。
```
...
...
...
...
...
...
...