动态网格

创建可排序、可过滤的多列动态网格布局。

动态网格组件允许你利用网格组件创建一个动态的响应式网格布局。在任何尺寸的设备中,网格单元都将自动地、流动地、无缝地调整自身构建无缝的多列布局。


用法

使用这个组件,添加 data-uk-grid 属性到容器元素。用 网格组件 中的 uk-width-*.uk-grid-width-* 类来设置网格单元的宽度。注意 使用此组件需要额外添加 grid.js 文件,在js/components文件夹中。

Example

1
2
3
4
5
6
7
8

Markup

<!-- 这是使用在每个网格单元上使用 uk-width-* 的网格 -->
<div data-uk-grid>
    <div class="uk-width-small-1-2 uk-width-medium-1-4">...</div>
    <div class="uk-width-small-1-2 uk-width-medium-1-4">...</div>
</div>

<!-- 这是使用在网格自身使用 uk-grid-width-* 的网格 -->
<div class="uk-grid-width-small-1-2 uk-grid-width-medium-1-4" data-uk-grid>
    <div>...</div>
    <div>...</div>
</div>

网格排水沟/Grid Gutter

用排水沟将网格单元分开,在data属性中使用 {gutter: 20} 选项即可。此时,排水沟会是20px宽。

Example

1
2
3
4
5
6
7
8

Markup

<div data-uk-grid="{gutter: 20}">...</div>

过滤

你还可以过滤网格,使其只在页面中显示特定的网格单元。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

A 1
B 2
A 3
B 4
B 5
A 6
B 7
A+B 8

Markup

这个例子使用了 二级导航 来过滤网格单元。

<!-- Filter Controls -->
<ul id="my-id" class="uk-subnav">
    <li data-uk-filter=""><a href=""></a></li>
    <li data-uk-filter="filter-a"><a href=""></a></li>
    <li data-uk-filter="filter-b"><a href=""></a></li>
</ul>

<!-- Dynamic Grid -->
<div data-uk-grid="{controls: '#my-id'}">
    <div data-uk-filter="filter-a">...</div>
    <div data-uk-filter="filter-b">...</div>
    <div data-uk-filter="filter-a,filter-b">...</div>
</div>

排序

升序排列网格单元,添加 {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

A
B
C
D
E
F
G
H

Markup

<ul id="my-id" class="uk-subnav">
    <li data-uk-sort="my-category"><a href=""></a></li>
    <li data-uk-sort="my-category:desc"><a href=""></a></li>
</ul>

<div data-uk-grid="{controls: '#my-id'}">
    <div data-my-category="a">...</div>
    <div data-my-category="b">...</div>
</div>

多个类别

要使用多个类别来进行网格单元的排序,为每个类别使用不同的名字就行了。

A 8
B 7
C 6
D 1
E 5
F 3
G 2
H 4

Markup

<ul id="my-id" class="uk-subnav">
    <li data-uk-sort="my-category"><a href=""></a></li>
    <li data-uk-sort="my-category:desc"><a href=""></a></li>
    <li data-uk-sort="my-category2"><a href=""></a></li>
    <li data-uk-sort="my-category2:desc"><a href=""></a></li>
</ul>

<div data-uk-grid="{controls: '#my-id'}">
    <div data-my-category="a" data-my-category2="8">...</div>
    <div data-my-category="b" data-my-category2="7">...</div>
</div>

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
    });
});