uni-app
運行到微信開發(fā)者工具需要注意
- 小程序路徑需要配置,
- 小程序端口需要開啟
目錄結(jié)構(gòu)
pages // 存放頁面
static // 靜態(tài)資源
uni_modules // 文件夾:用于存放 uniapp 項目的各種依賴文件。
unpackage // 打包文件目錄
App.vue // 根組件
main.js // 入口文件
manifest.js // 應用配置文件
pages.json // 頁面配置文件
uni.scss // 內(nèi)置樣式文件
開發(fā)規(guī)范
遵循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"
}
}
}
}
可以單獨設(shè)置h5的樣式
tabBar
- tabBar 中的 list 是一個數(shù)組,只能配置最少2個、最多5個 tab,tab 按數(shù)組的順序排序。
condition啟動模式
啟動模式配置,僅開發(fā)期間生效,用于模擬直達頁面的場景,如:小程序轉(zhuǎn)發(fā)后,用戶點擊所打開的頁面。
"condition": { //模式配置,僅開發(fā)期間生效
"current": 0, //當前激活的模式(list 的索引項)
"list": [{
"name": "detail", //模式名稱
"path": "pages/detail/detail", //啟動頁面,必選
"query": "interval=400" //啟動參數(shù),在頁面的onLoad函數(shù)里面得到。
}]
},
text組件
是否可選selectable
space 連續(xù)空格
view
hover-class 按下去激活的樣式
屬性名 | 類型 | 默認值 | 說明 |
---|---|---|---|
hover-class | String | none | 指定按下去的樣式類。當 hover-class=“none” 時,沒有點擊態(tài)效果 |
hover-stop-propagation | Boolean | false | 指定是否阻止本節(jié)點的祖先節(jié)點出現(xiàn)點擊態(tài),App、H5、支付寶小程序、百度小程序不支持(支付寶小程序、百度小程序文檔中都有此屬性,實測未支持) |
hover-start-time | Number | 50 | 按住后多久出現(xiàn)點擊態(tài),單位毫秒 |
hover-stay-time | Number | 400 | 手指松開后點擊態(tài)保留時間,單位毫秒 |
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> 組件,點擊分別會觸發(fā) <form> 組件的 submit/reset 事件 |
|||
open-type | String | 開放能力 | |||
hover-class | String | button-hover | 指定按鈕按下去的樣式類。當 hover-class=“none” 時,沒有點擊態(tài)效果 | App-nvue 平臺暫不支持 | |
hover-start-time | Number | 20 | 按住后多久出現(xiàn)點擊態(tài),單位毫秒 | ||
hover-stay-time | Number | 70 | 手指松開后點擊態(tài)保留時間,單位毫秒 | ||
app-parameter | String | 打開 APP 時,向 APP 傳遞的參數(shù),open-type=launchApp時有效 | 微信小程序、QQ小程序 | ||
hover-stop-propagation | boolean | false | 指定是否阻止本節(jié)點的祖先節(jié)點出現(xiàn)點擊態(tài) | 微信小程序 | |
lang | string | ‘en’ | 指定返回用戶信息的語言,zh_CN 簡體中文,zh_TW 繁體中文,en 英文。 | 微信小程序 | |
session-from | string | 會話來源,open-type="contact"時有效 | 微信小程序 | ||
send-message-title | string | 當前標題 | 會話內(nèi)消息卡片標題,open-type="contact"時有效 | 微信小程序 | |
send-message-path | string | 當前分享路徑 | 會話內(nèi)消息卡片點擊跳轉(zhuǎn)小程序路徑,open-type="contact"時有效 | 微信小程序 | |
send-message-img | string | 截圖 | 會話內(nèi)消息卡片圖片,open-type="contact"時有效 | 微信小程序 | |
show-message-card | boolean | false | 是否顯示會話內(nèi)消息卡片,設(shè)置此參數(shù)為 true,用戶進入客服會話會在右下角顯示"可能要發(fā)送的小程序"提示,用戶點擊后可以快速發(fā)送小程序消息,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 | 獲取用戶手機號回調(diào) | open-type=“getPhoneNumber” | 微信、支付寶、百度、抖音、快手、京東小程序 | |
@getuserinfo | Handler | 用戶點擊該按鈕時,會返回獲取到的用戶信息,從返回參數(shù)的detail中獲取到的值同uni.getUserInfo | open-type=“getUserInfo” | 微信、QQ、百度、快手、京東小程序 | |
@error | Handler | 當使用開放能力時,發(fā)生錯誤的回調(diào) | open-type=“l(fā)aunchApp” | 微信、QQ、快手、京東小程序 | |
@opensetting | Handler | 在打開授權(quán)設(shè)置頁并關(guān)閉后回調(diào) | open-type=“openSetting” | 微信、QQ、百度、快手、京東小程序 | |
@launchapp | Handler | 從小程序打開 App 成功的回調(diào) | open-type=“l(fā)aunchApp” | 微信、QQ、快手、京東小程序 | |
@contact | Handler | 客服消息回調(diào) | open-type=“contact” | 微信、QQ、百度、快手小程序 | |
@chooseavatar | Handler | 獲取用戶頭像回調(diào) | open-type=“chooseAvatar” | 微信小程序 | |
@agreeprivacyauthorization | Handler | 用戶同意隱私協(xié)議事件回調(diào),open-type="agreePrivacyAuthorization"時有效 | open-type=“agreeprivacyauthorization” | 微信小程序2.33.0 | |
@addgroupapp | Handler | 添加群應用的回調(diào) | open-type=“addGroupApp” | QQ小程序 | |
@chooseaddress | Handler | 調(diào)起用戶編輯并選擇收貨地址的回調(diào) | open-type=“chooseAddress” | 百度小程序 | |
@chooseinvoicetitle | Handler | 用戶選擇發(fā)票抬頭的回調(diào) | open-type=“chooseInvoiceTitle” | 百度小程序 | |
@subscribe | Handler | 訂閱消息授權(quán)回調(diào) | open-type=“subscribe” | 百度小程序 | |
@login | Handler | 登錄回調(diào) | open-type=“l(fā)ogin” | 百度小程序 | |
@im | Handler | 監(jiān)聽跳轉(zhuǎn)IM的成功回調(diào) | open-type=“im” | 抖音小程序2.68.0版本+ |
image
有默認的寬高 320px 240px
mode的屬于
scaleToFill
不保持縱橫比縮放圖片,使圖片的寬高完全拉伸至填滿 image 元素
aspectFit
保持縱橫比縮放圖片,使圖片的長邊能完全顯示出來。也就是說,可以完整地將圖片顯示出來。
aspectFill
保持縱橫比縮放圖片,只保證圖片的短邊能完全顯示出來。也就是說,圖片通常只在水平或垂直方向是完整的,另一個方向?qū)l(fā)生截取。
樣式問題
注意在 uni-app
中不能使用 *
選擇器。
目前支持的選擇器有:
選擇器
選擇器 | 樣例 | 樣例描述 |
---|---|---|
.class | .intro | 選擇所有擁有 class=“intro” 的組件 |
#id | #firstname | 選擇擁有 id=“firstname” 的組件 |
element | view | 選擇所有 view 組件 |
element, element | view, checkbox | 選擇所有文檔的 view 組件和所有的 checkbox 組件 |
::after | view::after | 在 view 組件后邊插入內(nèi)容,僅 vue 頁面生效 |
::before | view::before | 在 view 組件前邊插入內(nèi)容,僅 vue 頁面生效 |
uni-app 提供內(nèi)置 CSS 變量
CSS 變量 | 描述 | App | 小程序 | H5 |
---|---|---|---|---|
–status-bar-height | 系統(tǒng)狀態(tài)欄高度 | 系統(tǒng)狀態(tài)欄高度、nvue 注意見下 | 25px | 0 |
–window-top | 內(nèi)容區(qū)域距離頂部的距離 | 0 | 0 | NavigationBar 的高度 |
–window-bottom | 內(nèi)容區(qū)域距離底部的距離 | 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;
}
事件
可以的傳遞事件 和 自定義參數(shù)文章來源:http://www.zghlxwxcb.cn/news/detail-820694.html
@click($event,params)文章來源地址http://www.zghlxwxcb.cn/news/detail-820694.html
到了這里,關(guān)于#Uniapp:引入fonts&目錄結(jié)構(gòu)&全局樣式&啟動模式&全局變量的文章就介紹完了。如果您還想了解更多內(nèi)容,請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持TOY模板網(wǎng)!