Grid
组件类型:UxGridComponentPublicInstance
宫格布局 需搭配 ux-grid-item 使用
平台兼容性
UniApp X
Android | iOS | web | 鸿蒙 Next | 小程序 |
---|---|---|---|---|
√ | √ | √ | x | √ |
UniApp Vue Nvue
Android | iOS | web | 鸿蒙 Next | 小程序 |
---|---|---|---|---|
x | x | √ | x | x |
Props
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
col | Number | 3 | 宫格的列数 |
border | Boolean | false | 是否显示宫格的边框 |
align | String | left | 宫格对齐方式,表现为数量少的时候,靠左,居中,还是靠右 |
background | String | transparent | 背景色 |
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>