账户中心 退出系统
6.0 版本 5.0 版本 3.0 版本
使用手册 模板中心 账户中心 合作 · 服务
6.0 版本 5.0 版本 3.0 版本
快速开始
框架介绍版权要求
更新日志
常见问题
框架部署目录结构
版本差别V5 vs V3
皮肤说明
nvue 说明
数据转换格式问题
防抖节流技巧文章
页面布局 ( 15 )
页面组件 独创 · 好用
全屏加载 + 挂件
自定义头部返回 · 主页
自定义头部动态变化
自定义头部双击回顶部
返回顶部页面模式
返回顶部内置滚动区域模式
自定义底部详情模式
自定义 tabbar凸出按钮
吸顶元素插槽实现
动态吸顶逻辑演示
吸顶 + 滚动主体布局演示
iPhone 底部适配自动适配
小程序胶囊按钮躲避
下拉选择筛选 · 排序
页面背景色设置外链技巧
框架基础 ( 8 )
文本相关尺寸及修饰
内置颜色colors.css
定位样式absolute · fixed
手势操作触屏 · 缩放
内置图标
按钮样式
常用标题更多 · 换一批
动画效果
Flex 布局 ( 3 )
Flex 布局样式模式
Flex 横向布局组件模式
Flex 竖向布局组件模式
Grace.JS ( 18 )
工具介绍
网络请求
页面跳转
数据缓存
图片操作
设备信息
消息提示
头部导航 动态设置
底部导航 动态设置
元素选择 尺寸获取
ref 获取 跨生命周期
字符常用
数组操作
随机数据
日期时间
延时循环
对象操作
MD5 加密
请求工具库 ( 8 )
工具库介绍
GET 请求
POST 请求
upload 上传
签名验证 对 键 进行签名
签名验证 对 值 进行签名
用户登录检查
后端代码 php 版本示例
常用组件 ( 18 )
图片组件等比缩放
排序按钮
搜索组件
徽章角标
标签组件
功能标签选择 · 删除
星级组件
倒计时组件
城市选择
地区联动省市区三级
链接组件
为空展示
多图选择
多图上传
头像群组
数值动画
PK 投票
抽奖转盘
常用布局 ( 9 )
宫格布局默认5格
普通表格
数据表格
横向公告
时间轴布局
步骤展示
骨架加载
瀑布流布局
启动页广告全屏轮播形式
列表布局 ( 8 )
列表布局样式模式
滑动列表
可选列表
全选列表
树状列表
排序列表竖向拖拽
卡片列表
名片卡片
切换布局 ( 8 )
切换导航单行
切换导航多行
局部选项卡
全屏选项卡布局原理
分段切换
折叠面板
竖向切换导航适配
分类切换
滚动 · 轮播 ( 8 )
滚动区域原生 scroll-view
横向滚动带有进度条
滚动公告基于 swiper
无缝滚动横向文本形式
无缝滚动横向卡片形式
竖向公告顺序卡片形式
轮播组件
主体滚动定位+滚动区域
刷新加载 ( 6 )
全屏加载遮罩模式
下拉刷新基于页面组件
加载更多基于页面组件
刷新和加载基于页面组件
刷新和加载自定义组合
刷新和加载原生组合模式
弹层 · 对话框 ( 6 )
遮罩弹层 popup
顶部消息框
模态对话框
底部操作表
右侧菜单
弹出菜单 popup menu
表单相关 ( 14 )
表单元素 form 布局
提交按钮
表单验证
字数限制
动态表单 添加删除元素
分步提交
步进器
数字键盘
车牌号键盘
滑动解锁
进度滑块 单滑块
区间滑块 双滑块
功能标签 选择 · 删除
点选按钮
日期时间 ( 6 )
日历日期 带有农历及时间
日期区间 日历形式
日期时间 picker 模式
时间段选择 picker 模式
日程日历 日程 · 提醒
横向日历 布局模式
文章相关 ( 13 )
文章列表 基础用法
文章列表 切换模式
文章列表 全屏选项卡模式
内容编辑器 新版 · 自主研发 · 多端兼容
编辑器 旧版本 · 废弃保留
格式转换 后端转换为 HTML
内容渲染 新版 · 编辑器解析
文章详情 旧版本 · 废弃保留
富文本 字符串转数组
展开阅读
评论布局
评论提交
底部分享
媒体播放 ( 2 )
音乐播放器
视频播放器
地图使用 ( 3 )
位置标注
地图周边
拖拽定位
用户模板 ( 10 )
用户协议
用户登录
手机号登录
短信登录
短信验证
个人中心
头像剪裁
证件上传
会员排行榜
手写签名
电商常用 ( 9 )
商品列表
商品详情
订单中心
购物车模板
排序与筛选
地址列表
地址添加
抽奖模板
优惠券组件
即时通讯 ( 3 )
消息展示组件
消息输入组件
消息列表展示
二维码及条码 ( 3 )
二维码生成
条形码生成
海报模板
页面组件

手册版本 V5.0

组件介绍

在项目开发过程中,为了能够兼容多种平台、多种设备我们需要花费大量力气去完成项目内每个页面的兼容性设置。
GraceUI 发布了 gui-page 组件,来更高效的完成这项工作,您可以使用此组件完成各种模式的页面布局,同时页面组件还提供了挂件、全屏 Loading。
当页面需要自定义头部导航或底部导航时我们推荐您使用 gui-page 组件作为页面根节点;

教程推荐

我们精心为您准备了关于gui-page组件的视频教程,请在 付费用户群 > 群文件内下载并观看,gui-page 组件非常常用,推荐您深度学习理解一下(:

组件名称

gui-page : /graceUI/组件目录/gui-page

兼容平台

H5APP小程序NVUE

组件属性

属性名称类型默认值作用
fullPageBooleanfalse主体部分是否铺满屏幕
customHeaderBooleanfalse
是否使用自定义头部导航
headerSetsObject{height:44, zIndex:100} // 高度, z-index 值自定义头部导航设置 [ 自定义模式有效 ]
headerStyleStringbackground-color:#FFFFFF;自定义头部导航样式 [ 自定义模式有效 ]
isHeaderSizedBooleantrue
是否启用自定义头部占位
statusBarStyleStringbackground-color:#FFFFFF;状态栏样式 [ 自定义模式有效 ]
customFooterBooleanfalse是否使用自定义底部导航
footerSetsObject{height:100, zIndex:100, bg:'linear-gradient(to bottom, #FFFFFF,#FFFFFF)'}自定义底部导航设置 [ 自定义模式有效 ]
iphoneXButtomStyleString''iphoneX 底部占位元素样式设置
pendantSetsObject{width:'100rpx', right:'25rpx', bottom:'100rpx', zIndex:100}页面右下角挂件设置
isLoadingBooleanfalse是否展示全屏加载
isSwitchPageBooleanfalse页面是否为一个switchTab 页,影响如下 :
01. 不需要进行 iPhone 底部适配 
02. 自定义底部导航 H5 端 bottom 值调整为 50px
refreshBooleanfalse是否启用页面内置的下拉刷新
refreshTextArray['继续下拉刷新','松开手指开始刷新','数据刷新中','数据已刷新']下拉刷新过程组件文本
refreshBgColorArray['#FFFFFF','#FFFFFF','#FFFFFF','#63D2BC']下拉刷新过程背景颜色
refreshColorArray['rgba(69, 90, 100, 0.6)','rgba(69, 90, 100, 0.6)','#63D2BC','#FFFFFF']下拉刷新过程文本颜色
refreshFontSizeString26rpx
下拉刷新组件文本尺寸
loadmoreBooleanfalse是否启用页面内置的加载更多
loadMoreTextArray['','数据加载中', '已加载全部数据', '暂无数据']加载更多过程组件文本
loadMoreColorArray['rgba(69, 90, 100, 0.6)', 'rgba(69, 90, 100, 0.6)',
'rgba(69, 90, 100, 0.8)','rgba(69, 90, 100, 0.8)']
加载更多过程文本颜色
loadMoreStatusNumber0 2022.05.12 新增加载更多默认状态
loadMoreFontSizeString26rpx加载更多组件文本尺寸
apiLoadingStatus
Booleanfalse页面内 api 加载状态
true : api 数据加载中,false :无加载执行
作用 : 避免刷新、加载同时执行引发冲突
headerSizedStyleString'' 2021.08.23 新增属性开启自定义头部导航时,占位 view 样式
fixedTopZIndexnumber2021.08.23 新增属性吸顶插槽 z-inddex 值

组件插槽

01. gHeader - 页面头部插槽,包含手机状态栏;
02. gBody - 页面主体插槽,用于承载页面内容布局;
03. gFooter - 页面底部插槽,用于承载自定义底部导航;
04. gPendant - 页面右下角挂件插槽,用于实现返回顶部、客服、多功能菜单等功能;
05. gFixedTop - 吸顶原生插槽, 紧贴顶部导航的 fixed 定位;

皮肤样式

您可以通过修改对应皮肤的样式来修改页面组件的相关样式,具体如下 :

/* *** gui-page 页面组件相关  */
/* 页面内置全屏 Loading 背景颜色 */
.gui-page-loading-bg{background-color:rgba(255,255,255,0.88);}
/* 页面内置全屏 Loading 颜色 */
.gui-page-loading-color{background-color:#2B2E3D;}

/* 自定义导航左侧按钮背景颜色 */
.gui-header-buttons-bg{background-color:rgba(0,0,0,0.8);}
.gui-header-buttons-color{color:#FFFFFF;}

/* 底部自定义导航切换色 */
.gui-nav-bottom-color{color:#B6C3D2;}
.gui-nav-bottom-active-color{color:#2B2E3D;}
/* gui-page 页面组件相关 *** */

组件方法

getDomSize : 
功能 : 获取插槽的尺寸
参数 :
01 选择器 : guiPageHeader - 自定义头部导航、guiPageBody - 页面主体、guiPageFooter - 页面自定义底部
02 自定义回调函数,携带参数 : 选中dom的尺寸信息
示例 : 

graceJS.getRefs('guiPage', this, 0, (ref)=>{
	ref.getDomSize('guiPageBody', (e)=>{
		console.log(e);
		// 02. 导航的高度
		// 可以 使用 graceJS.select() 函数动态获取, 也可以使用 uni.upx2px 转换已知高度
		// 轮播主体高度 = 页面高度 - 导航高度
		this.mainHeight  = e.height - uni.upx2px(100);
		this.pageLoading = false;
	});
});
// 完整代码 : https://www.graceui.com/v5/info/10040-55.html

setScrollTop : 
功能 : 设置内置滚动区域的 scroll-top 值 [ 2021.07.29 新增 ];

演示代码

UNI 普通版本
NVUE 版本
登录并购买 GraceUI 后可以查阅完整手册内容 。