uni-app

运行到微信开发者工具需要注意

1. 小程序路径需要配置，
2. 小程序端口需要开启

目录结构

pages // 存放页面static // 静态资源uni_modules // 文件夹：用于存放 uniapp 项目的各种依赖文件。unpackage // 打包文件目录App.vue  // 根组件main.js // 入口文件manifest.js // 应用配置文件pages.json // 页面配置文件uni.scss  // 内置样式文件

开发规范

遵循vue和小程序混合

全局配置样式

全局 pages.json

"globalStyle": {}

局部的样式会覆盖全局的样式

https://uniapp.dcloud.net.cn/collocation/pages#style

          {"path": "pages/message/message","style": {"navigationBarTitleText": "message","navigationBarBackgroundColor": "#00ff00","h5": {"titleNView": {"backgroundColor": "#aa0000"}}}} 

可以单独设置h5的样式

tabBar

• tabBar 中的 list 是一个数组，只能配置最少2个、最多5个 tab，tab 按数组的顺序排序。

condition启动模式

启动模式配置，仅开发期间生效，用于模拟直达页面的场景，如：小程序转发后，用户点击所打开的页面。

	"condition": { //模式配置，仅开发期间生效"current": 0, //当前激活的模式（list 的索引项）"list": [{"name": "detail", //模式名称"path": "pages/detail/detail", //启动页面，必选"query": "interval=400" //启动参数，在页面的onLoad函数里面得到。}]},

text组件

是否可选selectable

space 连续空格

view

hover-class 按下去激活的样式

属性名	类型	默认值	说明
hover-class	String	none	指定按下去的样式类。当 hover-class=“none” 时，没有点击态效果
hover-stop-propagation	Boolean	false	指定是否阻止本节点的祖先节点出现点击态，App、H5、支付宝小程序、百度小程序不支持（支付宝小程序、百度小程序文档中都有此属性，实测未支持）
hover-start-time	Number	50	按住后多久出现点击态，单位毫秒
hover-stay-time	Number	400	手指松开后点击态保留时间，单位毫秒

button

常用

size

type

pain

disabled

hover-class

属性说明

属性名	类型	默认值	说明	生效时机	平台差异说明
size	String	default	按钮的大小
type	String	default	按钮的样式类型
plain	Boolean	false	按钮是否镂空，背景色透明
disabled	Boolean	false	是否禁用
loading	Boolean	false	名称前是否带 loading 图标		H5、App(App-nvue 平台，在 ios 上为雪花，Android上为圆圈)
form-type	String		用于 <form> 组件，点击分别会触发 <form> 组件的 submit/reset 事件
open-type	String		开放能力
hover-class	String	button-hover	指定按钮按下去的样式类。当 hover-class=“none” 时，没有点击态效果		App-nvue 平台暂不支持
hover-start-time	Number	20	按住后多久出现点击态，单位毫秒
hover-stay-time	Number	70	手指松开后点击态保留时间，单位毫秒
app-parameter	String		打开 APP 时，向 APP 传递的参数，open-type=launchApp时有效		微信小程序、QQ小程序
hover-stop-propagation	boolean	false	指定是否阻止本节点的祖先节点出现点击态		微信小程序
lang	string	‘en’	指定返回用户信息的语言，zh_CN 简体中文，zh_TW 繁体中文，en 英文。		微信小程序
session-from	string		会话来源，open-type="contact"时有效		微信小程序
send-message-title	string	当前标题	会话内消息卡片标题，open-type="contact"时有效		微信小程序
send-message-path	string	当前分享路径	会话内消息卡片点击跳转小程序路径，open-type="contact"时有效		微信小程序
send-message-img	string	截图	会话内消息卡片图片，open-type="contact"时有效		微信小程序
show-message-card	boolean	false	是否显示会话内消息卡片，设置此参数为 true，用户进入客服会话会在右下角显示"可能要发送的小程序"提示，用户点击后可以快速发送小程序消息，open-type="contact"时有效		微信小程序
group-id	String		打开群资料卡时，传递的群号	open-type=“openGroupProfile”	QQ小程序
guild-id	String		打开频道页面时，传递的频道号	open-type=“openGuildProfile”	QQ小程序
public-id	String		打开公众号资料卡时，传递的号码	open-type=“openPublicProfile”	QQ小程序
data-im-id	String		客服的抖音号	open-type=“im”	抖音小程序2.68.0版本+
data-im-type	String		IM卡片类型	open-type=“im”	抖音小程序2.80.0版本+
data-goods-id	String		商品的id，仅支持泛知识课程库和生活服务商品库中的商品	open-type=“im”	抖音小程序2.80.0版本+
data-order-id	String		订单的id，仅支持交易2.0订单	open-type=“im”	抖音小程序2.80.0版本+
data-biz-line	String		商品类型，“1”代表生活服务，“2”代表泛知识。	open-type=“im”	抖音小程序2.80.0版本+
@getphonenumber	Handler		获取用户手机号回调	open-type=“getPhoneNumber”	微信、支付宝、百度、抖音、快手、京东小程序
@getuserinfo	Handler		用户点击该按钮时，会返回获取到的用户信息，从返回参数的detail中获取到的值同uni.getUserInfo	open-type=“getUserInfo”	微信、QQ、百度、快手、京东小程序
@error	Handler		当使用开放能力时，发生错误的回调	open-type=“launchApp”	微信、QQ、快手、京东小程序
@opensetting	Handler		在打开授权设置页并关闭后回调	open-type=“openSetting”	微信、QQ、百度、快手、京东小程序
@launchapp	Handler		从小程序打开 App 成功的回调	open-type=“launchApp”	微信、QQ、快手、京东小程序
@contact	Handler		客服消息回调	open-type=“contact”	微信、QQ、百度、快手小程序
@chooseavatar	Handler		获取用户头像回调	open-type=“chooseAvatar”	微信小程序
@agreeprivacyauthorization	Handler		用户同意隐私协议事件回调，open-type="agreePrivacyAuthorization"时有效	open-type=“agreeprivacyauthorization”	微信小程序2.33.0
@addgroupapp	Handler		添加群应用的回调	open-type=“addGroupApp”	QQ小程序
@chooseaddress	Handler		调起用户编辑并选择收货地址的回调	open-type=“chooseAddress”	百度小程序
@chooseinvoicetitle	Handler		用户选择发票抬头的回调	open-type=“chooseInvoiceTitle”	百度小程序
@subscribe	Handler		订阅消息授权回调	open-type=“subscribe”	百度小程序
@login	Handler		登录回调	open-type=“login”	百度小程序
@im	Handler		监听跳转IM的成功回调	open-type=“im”	抖音小程序2.68.0版本+

image

有默认的宽高 320px 240px

mode的属于

scaleToFill

不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素

aspectFit

保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。

aspectFill

保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。

样式问题

注意在 uni-app 中不能使用 * 选择器。

目前支持的选择器有：

选择器

选择器	样例	样例描述
.class	.intro	选择所有拥有 class=“intro” 的组件
#id	#firstname	选择拥有 id=“firstname” 的组件
element	view	选择所有 view 组件
element, element	view, checkbox	选择所有文档的 view 组件和所有的 checkbox 组件
::after	view::after	在 view 组件后边插入内容，仅 vue 页面生效
::before	view::before	在 view 组件前边插入内容，仅 vue 页面生效

uni-app 提供内置 CSS 变量

CSS 变量	描述	App	小程序	H5
–status-bar-height	系统状态栏高度	系统状态栏高度、nvue 注意见下	25px	0
–window-top	内容区域距离顶部的距离	0	0	NavigationBar 的高度
–window-bottom	内容区域距离底部的距离	0	0	TabBar 的高度

字体图标

阿里矢量图标库

字体文件的引用路径推荐使用以 ~@ 开头的绝对路径

@font-face {font-family: test1-icon;src: url('~@/static/iconfont.ttf');
}

<style>@import url("~@/static/fonts/iconfont.css");/*每个页面公共css */.c-rpx {background: #aa0000;}
</style>

scss

要使用先安装插件scss

uni.scss里面是变量可以全局使用

引用示例

.text {color: $uni-color-primary;}

事件

可以的传递事件 和 自定义参数

@click($event,params)