# Layout 栅格布局

概述

Layout 栅格布局，将整个屏幕宽度分为 24 单位，每个单位的大小，由当前屏幕尺寸决定。 Layout提供了fui-row和fui-col两个组件来进行行列布局。

# 支持平台

目前开发小程序与H5推荐使用 FirstUI nvue版本 (opens new window)。

安卓系统版本	安卓uni-app	安卓uniapp-x	iOS系统版本	iOS uniapp	iOS uniapp-x	小程序	H5/Web
5.0	×	✓	9.0	×	×	×	✓

# 引入

以下介绍两种常用的引入方式。

第一种：在页面中引用、注册

import fuiRow from "@/components/firstui/fui-row/fui-row.uvue"
import fuiCol from "@/components/firstui/fui-col/fui-col.uvue"
export default {
	components:{
		fuiRow,
		fuiCol
	}
}

1
2
3
4
5
6
7
8

第二种：easycom组件规范

传统vue组件，需要安装、引用、注册，三个步骤后才能使用组件。easycom将其精简为一步。

First UI easycom配置请查看快速上手。

如果不了解easycom，可先查看官网文档 (opens new window)。

# 代码演示

部分示例演示，完整使用请参考示例程序以及文档API。

基础布局

通过 span 属性设置栅格占据的列数，默认值为24。

<fui-row margin-bottom="24rpx">
	<fui-col>
		<view class="fui-col__item fui-color__black"></view>
	</fui-col>
</fui-row>
<fui-row margin-bottom="24rpx">
	<fui-col :span="12">
		<view class="fui-col__item fui-color__black"></view>
	</fui-col>
	<fui-col :span="12">
		<view class="fui-col__item fui-color__yellow"></view>
	</fui-col>
</fui-row>

1
2
3
4
5
6
7
8
9
10
11
12
13

.fui-col__item {
	height: 84rpx;
	border-radius: 16rpx;
}

.fui-color__black {
	background-color: #333333;
}

.fui-color__yellow {
	background-color: #FFB703;
}

1
2
3
4
5
6
7
8
9
10
11
12

分栏偏移

通过 offset 属性设置栅格左侧的间隔格数。

<fui-row marginBottom="10px">
	<fui-col :span="8">
		<view class="fui-col__item fui-color__black"></view>
	</fui-col>
	<fui-col :span="8" :offset="6">
		<view class="fui-col__item fui-color__yellow"></view>
	</fui-col>
</fui-row>

<fui-row marginBottom="10px">
	<fui-col :span="6" :offset="6">
		<view class="fui-col__item fui-color__black"></view>
	</fui-col>
	<fui-col :span="6" :offset="6">
		<view class="fui-col__item fui-color__yellow"></view>
	</fui-col>
</fui-row>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

.fui-col__item {
	height: 84rpx;
	border-radius: 16rpx;
}

.fui-color__black {
	background-color: #333333;
}

.fui-color__yellow {
	background-color: #FFB703;
}

1
2
3
4
5
6
7
8
9
10
11
12

# Slots

# fui-row 组件

插槽名称	说明
default	标签显示内容，内部由一个或多个fui-col组成

# fui-col 组件

插槽名称	说明
default	标签内显示的自定义内容

# Props

# fui-row 组件

属性名	类型	说明	默认值	平台差异说明
justify	String	flex布局下的水平排列方式，可取值：start、end、center、space-around、space-between	start	-
align	String	flex布局下的垂直排列方式，可取值：top、middle、bottom	top	-
marginTop	String	margin-top值，传值需要带单位	0rpx	-
marginBottom	String	margin-bottom值，传值需要带单位	0rpx	-
gutter	Number	栅格间隔，单位rpx	0	-
width	Number	使用span等属性，需要配置宽度，单位rpx	750	-

# fui-col 组件

属性名	类型	说明	默认值	平台差异说明
span	Number	栅格占据的列数	24	-
offset	Number	栅格左侧的间隔格数	0	-
pushLeft	Number	栅格向右移动格数	-1	-
pullRight	Number	栅格向左移动格数	-1	-

# Events

事件名	说明	回调参数
-	-	-

示例预览

# 示例代码地址

Layout 栅格布局

← CSS 常用样式 Grid 宫格 →