小程式開發入門基礎教程,程式開發基礎教程
小程式開發入門基礎教程
本文檔將帶你一步步建立完成一個小程式,並可以在手機上體驗該小程式的實際效果。
開發準備工作擷取小程式的 AppID
登入 https://mp.weixin.qq.com ,就可以在網站的“設定”-“開發人員設定”中,查看到小程式的 AppID 了,注意不可直接使用服務號或訂閱號的 AppID 。
下載開發工具
:https://mp.weixin.qq.com/debug/wxadoc/dev/devtools/download.html?t=1476197489869
建立項目
開發人員工具安裝完成後,開啟並使用掃碼登入。選擇建立“項目”,填入上文擷取到的 AppID ,設定一個本地項目的名稱(非小程式名稱),比如“我的第一個項目”,並選擇一個本地的檔案夾作為代碼儲存的目錄,點擊“建立項目”就可以了。
為方便初學者瞭解小程式的基本代碼結構,在建立過程中,如果選擇的本地檔案夾是個空檔案夾,開發人員工具會提示,是否需要建立一個 quick start 項目。選擇“是”,開發人員工具會協助我們在開發目錄裡產生一個簡單的 demo。
這樣就搭建好了,我們來看一下主介面
整個開發工具基本分為三塊。
第一列:table-item 每個按鈕代表一個頁
第二列:webview 你的頁面在這裡即時展示
第三列:chrome調試工具,暫且這樣叫吧,因為確實是使用了charome的調試工具, 在這裡可以調試頁面的樣式,js,網路檢測,輸入輸出等等。
編寫樣本小代碼建立小程式執行個體
點擊開發人員工具左側導航的“編輯”,我們可以看到這個項目,已經初始化並包含了一些簡單的代碼檔案。最關鍵也是必不可少的,是 app.js、app.json、app.wxss 這三個。其中,.js尾碼的是指令檔,.json尾碼的檔案是設定檔,.wxss尾碼的是樣式表檔案。小程式會讀取這些檔案,並產生小程式執行個體。
下面我們簡單瞭解這三個檔案的功能,方便修改以及從頭開發自己的小程式。
app.js是小程式的指令碼代碼。我們可以在這個檔案中監聽並處理小程式的生命週期函數、聲明全域變數。調用架構提供的豐富的 API,如本例的同步儲存及同步讀取本機資料。想瞭解更多可用 API,可參考 API 文檔。
//app.jsApp({ onLaunch: function () { //調用API從本機快取中擷取資料 var logs = wx.getStorageSync('logs') || [] logs.unshift(Date.now()) wx.setStorageSync('logs', logs) }, getUserInfo:function(cb){ var that = this; if(this.globalData.userInfo){ typeof cb == "function" && cb(this.globalData.userInfo) }else{ //調用登入介面 wx.login({ success: function () { wx.getUserInfo({ success: function (res) { that.globalData.userInfo = res.userInfo; typeof cb == "function" && cb(that.globalData.userInfo) } }) } }); } }, globalData:{ userInfo:null }})
app.json 是對整個小程式的全域配置。我們可以在這個檔案中配置小程式是由哪些頁面組成,配置小程式的視窗背景色,配置導航條樣式,配置預設標題。注意該檔案不可添加任何注釋。更多可配置項可參考配置詳解。
{ "pages":[ "pages/index/index", "pages/logs/logs" ], "window":{ "backgroundTextStyle":"light", "navigationBarBackgroundColor": "#fff", "navigationBarTitleText": "WeChat", "navigationBarTextStyle":"black" }}
app.wxss 是整個小程式的公用樣式表。我們可以在頁面組件的 class 屬性上直接使用 app.wxss 中聲明的樣式規則。
/**app.wxss**/.container { height: 100%; display: flex; flex-direction: column; align-items: center; justify-content: space-between; padding: 200rpx 0; box-sizing: border-box;}
建立頁面
在這個教程裡,我們有兩個頁面,index 頁面和 logs 頁面,即歡迎頁面和小程式開機記錄的展示頁,他們都在 pages 目錄下。小程式中的每一個頁面的【路徑+頁面名】都需要寫在 app.json 的 pages 中,且 pages 中的第一個頁面是小程式的首頁。
每一個小程式頁面是由同路徑下同名的四個不同尾碼檔案的組成,如:index.js、index.wxml、index.wxss、index.json。.js尾碼的檔案是指令檔,.json尾碼的檔案是設定檔,.wxss尾碼的是樣式表檔案,.wxml尾碼的檔案是頁面結構檔案。
index.wxml 是頁面的結構檔案:
<!--index.wxml--><view class="container"> <view bindtap="bindViewTap" class="userinfo"> <image class="userinfo-avatar" src="{{userInfo.avatarUrl}}" background-size="cover"></image> <text class="userinfo-nickname">{{userInfo.nickName}}</text> </view> <view class="usermotto"> <text class="user-motto">{{motto}}</text> </view></view>
index.js 是頁面的指令檔,在這個檔案中我們可以監聽並處理頁面的生命週期函數、擷取小程式執行個體,聲明並處理資料,響應頁面互動事件等。
//index.js//擷取應用執行個體var app = getApp()Page({ data: { motto: 'Hello World', userInfo: {} }, //事件處理函數 bindViewTap: function() { wx.navigateTo({ url: '../logs/logs' }) }, onLoad: function () { console.log('onLoad') var that = this //調用應用執行個體的方法擷取全域資料 app.getUserInfo(function(userInfo){ //更新資料 that.setData({ userInfo:userInfo }) }) }})
index.wxss 是頁面的樣式表:
/**index.wxss**/.userinfo { display: flex; flex-direction: column; align-items: center;}.userinfo-avatar { width: 128rpx; height: 128rpx; margin: 20rpx; border-radius: 50%;}.userinfo-nickname { color: #aaa;}.usermotto { margin-top: 200px;}
頁面的樣式表是非必要的。當有頁面樣式表時,頁面的樣式表中的樣式規則會層疊覆蓋 app.wxss 中的樣式規則。如果不指定頁面的樣式表,也可以在頁面的結構檔案中直接使用 app.wxss 中指定的樣式規則。
index.json 是頁面的設定檔:
頁面的設定檔是非必要的。當有頁面的設定檔時,配置項在該頁面會覆蓋 app.json 的 window 中相同的配置項。如果沒有指定的頁面設定檔,則在該頁面直接使用 app.json 中的預設配置。
logs 的頁面結構
<!--logs.wxml--><view class="container log-list"> <block wx:for="{{logs}}" wx:for-item="log"> <text class="log-item">{{index + 1}}. {{log}}</text> </block></view>
logs 頁面使用 控制標籤來組織代碼,在 上使用 wx:for 綁定 logs 資料,並將 logs 資料迴圈展開節點。
//logs.jsvar util = require('../../utils/util.js')Page({ data: { logs: [] }, onLoad: function () { this.setData({ logs: (wx.getStorageSync('logs') || []).map(function (log) { return util.formatTime(new Date(log)) }) }) }})
這樣我們就完成了一個簡單入門級小程式開發。
感謝閱讀,希望能協助到大家,謝謝大家對本站的支援!