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

手册版本 V6.0

视频教程推荐

我们为您准备了视频版的框架部署教程,非常建议您观看,会帮助您快速入门,请在 "GraceUI已付费用户群" 内下载视频观看。

注意事项

GraceUI 6.0 必须基于 vue3 环境,请打开 manifest.json > 基础配置 > Vue 版本选择 > 选择 3.0 版本。

您还没有掌握 vue3 ?
没关系继续使用 vue2 的语法开发就好了 ~

想学习 vue3 ?
资料推荐 : 
lesscode 文本教程 : https://www.lesscode.work/courses
b 站搜索 vue3 教程

框架目录结构

|_ 项目根目录
    |_ components // 自定义组件目录
    |_ custom // 自定义文件目录,包含 : 样式及自定义配置
    |_ Grace6 // GraceUI 框架核心目录
        |_ components // GraceUI 组件目录
        |_ css // css 文件目录
        |_ js // js 相关文件目录
        |_ font // 字体文件目录
        |_ demoData // 演示数据
    |_ pages // 页面文件目录
    |_ static // 静态文件目录
    |_ app.vue // 项目入口 ( 初始化样式,加载字体 )
    |_ pages.json // 页面配置文件
    |_ ...... // 其他文件,遵循 uni-app 目录规范

App.Vue 中加载核心样式及字体

<script>
export default {
onLaunch: function() {
// #ifdef APP-PLUS
const domModule = uni.requireNativePlugin('dom')
domModule.addRule('fontFace', {
'fontFamily': "graceuiiconfont",
'src': "url('https://at.alicdn.com/t/c/font_823462_whtuj4ktcl.ttf?t=1703075468532')"
});
console.log("字体加载成功");
// #endif

// #ifdef MP-WEIXIN
wx.onNeedPrivacyAuthorization(function(e){
console.log(e);
})
// #endif
},
onShow: function(){},
onHide: function(){}
}
</script>
<!-- #ifndef APP-NVUE -->
<style lang="scss">
/* 加载框架核心样式 */
@import "./Grace6/css/grace.scss";
/* 加载深色模式适配样式 */
@import "./Grace6/css/graceDark.scss";
/* 加载自定义样式 */
@import "./custom/custom.scss";
page{background:#F8F8F8;}
</style>
<!-- #endif -->
<!-- #ifdef APP-NVUE -->
<style lang="scss">
/* 加载框架核心样式 */
@import "./Grace6/css/grace.scss";
/* 加载自定义样式 */
@import "./custom/custom.scss";
.gui-icons{font-family:graceuiiconfont; font-style:normal;}
</style>
<!-- #endif -->

组件自动加载

传统vue组件,需要安装、引用、注册,三个步骤后才能使用组件。
easycom 将其精简为一步。只要组件安装在项目的components目录下,并符合components/组件名称/组件名称.vue目录结构的组件,就可以不用引用、注册,直接在页面中使用。同时打包后会自动剔除没有使用的组件。

graceUI 6.0 实现自动加载

在 pages.json 内添加以下代码 ( 下载 GraceUI 框架时 page.json 已经写好 ) :  

"easycom": {
	"autoscan" : true,
	"custom": {
		"gui-(.*)" : "@/Grace6/components/gui-$1.vue"
	}
}

样式二次开发

核心建议 : 
01. 不修改 GraceUI 框架的核心源码,当 GraceUI 升级时可以直接使用框架核心文件包覆盖旧文件。
02. 使用样式复写的方式修改 GraceUI 内置样式,如 : 
在 app.vue 的 style 标签内或自定义一个样式文件 :
.gui-text{color:#A5A7B2; font-size:18rpx;}
03. 添加自己的样式,如 : 
.color-black{color:#333333;}
.color-red{color:#FF0036;}
04. 可以利用条件编译编写不同平台的样式 如 : 修改导航组件 
/* #ifndef APP-PLUS-NVUE */
navigator{opacity:1; background:none;}
.navigator-hover{background-color:none; opacity:0.8;}
/* #endif */

组件二次开发

如果我们提供的组件不能满足您的项目需求,您可以 :
01. 将GraceUI 的组件 [ Grace6/components/某个组件.vue ] 复制到 根目录的组件中 [ /根目录/components/自定义组件/自定义组件.vue 可以实现自动加载 ];
02. 修改新的组件然后调用;
建议您一定要这样做,不要改写任何GraceUI组件的源码,这样才能保证您顺利进行框架版本升级哦 ~

快速部署

使用下载项目为基础
答 : 下载框架后解压得到的文件夹直接拖进 HX 编辑器运行即可;

将 GraceUI 部署到已有项目
1 将 graceUI6文件夹、custom 文件夹复制到您项目的根目录;
2 打开下载的 app.vue,参考样式及字体引入代码,将其编写到您的 app.vue 中;