Skip to content
本页导读

Grid

组件类型:UxGridComponentPublicInstance

宫格布局 需搭配 ux-grid-item 使用

平台兼容性

UniApp X

AndroidiOSweb鸿蒙 Next小程序
x

UniApp Vue Nvue

AndroidiOSweb鸿蒙 Next小程序
xxxx

Props

属性名类型默认值说明
colNumber3宫格的列数
borderBooleanfalse是否显示宫格的边框
alignStringleft宫格对齐方式,表现为数量少的时候,靠左,居中,还是靠右
backgroundStringtransparent背景色

align

说明
left左对齐
center居中
right右对齐

示例代码

html
<template>
	<ux-page :stack="showDoc">
		<ux-navbar :title="title" :border="false">
			<template v-slot:right>
				<!-- #ifndef MP -->
				<ux-button theme="text" icon="/static/tip.png" :icon-size="22" @click="onDoc()"></ux-button>
				<!-- #endif -->
			</template>
		</ux-navbar>
		
		<ux-scroll>
			<ux-card direction="column" icon="flag-filled" title="宫格布局" :bold="true">
				<ux-text text="宫格布局 需搭配 ux-grid-item 使用"></ux-text>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="列数" :bold="true">
				<ux-text text="支持配置排列列数" :mb="15"></ux-text>
				<ux-grid :col="4">
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
				</ux-grid>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="边框" :bold="true">
				<ux-text text="支持边框显示" :mb="15"></ux-text>
				<ux-grid :border="true">
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
				</ux-grid>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="对齐方式" :bold="true">
				<ux-text text="支持左对齐、居中、右对齐" :mb="15"></ux-text>
				<ux-grid :col="4" align="right">
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
				</ux-grid>
			</ux-card>
			
			<ux-placeholder :height="200">
				<ux-row justify="center" align="center" style="height: 100%;">
					<ux-text prefix-icon="soapbubble-filled" text="真的没有了~"></ux-text>
				</ux-row>
			</ux-placeholder>
		</ux-scroll>
	</ux-page>
</template>
<template>
	<ux-page :stack="showDoc">
		<ux-navbar :title="title" :border="false">
			<template v-slot:right>
				<!-- #ifndef MP -->
				<ux-button theme="text" icon="/static/tip.png" :icon-size="22" @click="onDoc()"></ux-button>
				<!-- #endif -->
			</template>
		</ux-navbar>
		
		<ux-scroll>
			<ux-card direction="column" icon="flag-filled" title="宫格布局" :bold="true">
				<ux-text text="宫格布局 需搭配 ux-grid-item 使用"></ux-text>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="列数" :bold="true">
				<ux-text text="支持配置排列列数" :mb="15"></ux-text>
				<ux-grid :col="4">
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
				</ux-grid>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="边框" :bold="true">
				<ux-text text="支持边框显示" :mb="15"></ux-text>
				<ux-grid :border="true">
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
				</ux-grid>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="对齐方式" :bold="true">
				<ux-text text="支持左对齐、居中、右对齐" :mb="15"></ux-text>
				<ux-grid :col="4" align="right">
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b2"></view>
					</ux-grid-item>
					<ux-grid-item>
						<view class="b1"></view>
					</ux-grid-item>
				</ux-grid>
			</ux-card>
			
			<ux-placeholder :height="200">
				<ux-row justify="center" align="center" style="height: 100%;">
					<ux-text prefix-icon="soapbubble-filled" text="真的没有了~"></ux-text>
				</ux-row>
			</ux-placeholder>
		</ux-scroll>
	</ux-page>
</template>
ts
<script setup>
	import * as plus from '@/uni_modules/ux-plus'
	
	const title = ref('')
	const showDoc = ref(false)
	
	function onDoc() {
		plus.openWeb({
			title: '在线文档',
			url: 'https://www.uxframe.cn/component/grid.html',
			// blur: 1,
			success: () => {
				showDoc.value = true
			},
			complete: () => {
				showDoc.value = false
			}
		})
	}
	
	onLoad((e) => {
		title.value = e['title'] ?? ''
	})
</script>
<script setup>
	import * as plus from '@/uni_modules/ux-plus'
	
	const title = ref('')
	const showDoc = ref(false)
	
	function onDoc() {
		plus.openWeb({
			title: '在线文档',
			url: 'https://www.uxframe.cn/component/grid.html',
			// blur: 1,
			success: () => {
				showDoc.value = true
			},
			complete: () => {
				showDoc.value = false
			}
		})
	}
	
	onLoad((e) => {
		title.value = e['title'] ?? ''
	})
</script>
css
<style lang="scss">
	.b1 {
		width: 100%;
		height: 60px;
		background-color: #3491FA;
	}
	
	.b2 {
		width: 100%;
		height: 60px;
		background-color: #165DFF;
	}
</style>
<style lang="scss">
	.b1 {
		width: 100%;
		height: 60px;
		background-color: #3491FA;
	}
	
	.b2 {
		width: 100%;
		height: 60px;
		background-color: #165DFF;
	}
</style>