本文檔将帶你(nǐ)一步步創建完成一個微信小程序，并可(kě)以在手機(jī)上體(tǐ)驗該小程序的實際效果。這個小程序的首頁将會顯示歡迎語以及當前用戶的微信頭像，點擊頭像，可(kě)以在新開的頁面中查看(kàn)當前小程序的啓動日(rì)志。

1. 獲取微信小程序的 AppID

登錄 https://mp.weixin.qq.com ，就(jiù)可(kě)以在網站(zhàn)的“設置”-“開發者設置”中，查看(kàn)到微信小程序的 AppID 了，注意不可(kě)直接使用服務号或訂閱号的 AppID 。

注意：如(rú)果要以非管理(lǐ)員(yuán)微信号在手機(jī)上體(tǐ)驗該小程序，那麽我們還(hái)需要操作(zuò)“綁定開發者”。即在“用戶身(shēn)份”-“開發者”模塊，綁定上需要體(tǐ)驗該小程序的微信号。本教程默認注冊帳号、體(tǐ)驗都(dōu)是使用管理(lǐ)員(yuán)微信号。

2. 創建項目

我們需要通過開發者工(gōng)具，來(lái)完成小程序創建和代碼編輯。

開發者工(gōng)具安裝完成後，打開并使用微信掃碼登錄。選擇創建“項目”，填入上文獲取到的 AppID ，設置一個本地項目的名稱（非小程序名稱），比如(rú)“我的第一個項目”，并選擇一個本地的文件(jiàn)夾作(zuò)爲代碼存儲的目錄，點擊“新建項目”就(jiù)可(kě)以了。

爲方便初學者了解微信小程序的基本代碼結構，在創建過程中，如(rú)果選擇的本地文件(jiàn)夾是個空文件(jiàn)夾，開發者工(gōng)具會提示，是否需要創建一個 quick start 項目。選擇“是”，開發者工(gōng)具會幫助我們在開發目錄裡(lǐ)生(shēng)成一個簡單的demo。

項目創建成功後，我們就(jiù)可(kě)以點擊該項目，進入并看(kàn)到完整的開發者工(gōng)具界面，點擊左側導航，在“編輯”裡(lǐ)可(kě)以查看(kàn)和編輯我們的代碼，在“調試”裡(lǐ)可(kě)以測試代碼并模拟小程序在微信客戶端效果，在“項目”裡(lǐ)可(kě)以發送到手機(jī)裡(lǐ)預覽實際效果。

3. 編寫代碼

創建小程序實例

點擊開發者工(gōng)具左側導航的“編輯”，我們可(kě)以看(kàn)到這個項目，已經初始化并包含了一些簡單的代碼文件(jiàn)。最關鍵也是必不可(kě)少的，是 app.js、app.json、app.wxss 這三個。其中，.js後綴的是腳本文件(jiàn)，.json後綴的文件(jiàn)是配置文件(jiàn)，.wxss後綴的是樣式表文件(jiàn)。微信小程序會讀(dú)取這些文件(jiàn)，并生(shēng)成小程序實例。

下面我們簡單了解這三個文件(jiàn)的功能，方便修改以及從(cóng)頭開發自(zì)己的微信小程序。

app.js是小程序的腳本代碼。我們可(kě)以在這個文件(jiàn)中監聽并處理(lǐ)小程序的生(shēng)命周期函數、聲明全局變量。調用框架提供的豐富的 API，如(rú)本例的同步存儲及同步讀(dú)取本地數據。想了解更多可(kě)用 API，可(kě)參考 API 文檔

<code class="lang-javascript"><span class="hljs-comment">//app.js</span>

App({

  onLaunch: <span class="hljs-function"><span class="hljs-keyword">function</span> () </span>{

    <span class="hljs-comment">//調用API從(cóng)本地緩存中獲取數據</span>

    <span class="hljs-keyword">var</span> logs = wx.getStorageSync(<span class="hljs-string">'logs'</span>) || []

    logs.unshift(<span class="hljs-built_in">Date</span>.now())

    wx.setStorageSync(<span class="hljs-string">'logs'</span>, logs)

  },

  getUserInfo:<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">cb</span>)</span>{

    <span class="hljs-keyword">var</span> that = <span class="hljs-keyword">this</span>;

    <span class="hljs-keyword">if</span>(<span class="hljs-keyword">this</span>.globalData.userInfo){

      <span class="hljs-keyword">typeof</span> cb == <span class="hljs-string">"function"</span> &amp;&amp; cb(<span class="hljs-keyword">this</span>.globalData.userInfo)

    }<span class="hljs-keyword">else</span>{

      <span class="hljs-comment">//調用登錄接口</span>

      wx.login({

        success: <span class="hljs-function"><span class="hljs-keyword">function</span> () </span>{

          wx.getUserInfo({

            success: <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">res</span>) </span>{

              that.globalData.userInfo = res.userInfo;

              <span class="hljs-keyword">typeof</span> cb == <span class="hljs-string">"function"</span> &amp;&amp; cb(that.globalData.userInfo)

            }

          })

        }

      });

    }

  },

  globalData:{

    userInfo:<span class="hljs-literal">null</span>

  }

})</code>

app.json 是對整個小程序的全局配置。我們可(kě)以在這個文件(jiàn)中配置小程序是由哪些頁面組成，配置小程序的窗(chuāng)口背景色，配置導航條樣式，配置默認标題。注意該文件(jiàn)不可(kě)添加任何注釋。更多可(kě)配置項可(kě)參考配置詳解

<code class="lang-json">{

  <span class="hljs-string">"pages"</span>:[

    <span class="hljs-string">"pages/index/index"</span>,

    <span class="hljs-string">"pages/logs/logs"</span>

  ],

  <span class="hljs-string">"window"</span>:{

    <span class="hljs-string">"backgroundTextStyle"</span>:<span class="hljs-string">"light"</span>,

    <span class="hljs-string">"navigationBarBackgroundColor"</span>: <span class="hljs-string">"#fff"</span>,

    <span class="hljs-string">"navigationBarTitleText"</span>: <span class="hljs-string">"WeChat"</span>,

    <span class="hljs-string">"navigationBarTextStyle"</span>:<span class="hljs-string">"black"</span>

  }

}</code>

app.wxss 是整個小程序的公共樣式表。我們可(kě)以在頁面組件(jiàn)的 class 屬性上直接使用 app.wxss 中聲明的樣式規則。

<code class="lang-css"><span class="hljs-comment">/**app.wxss**/</span>

<span class="hljs-selector-class">.container</span> {

  <span class="hljs-attribute">height</span>: <span class="hljs-number">100%</span>;

  <span class="hljs-attribute">display</span>: flex;

  <span class="hljs-attribute">flex-direction</span>: column;

  <span class="hljs-attribute">align-items</span>: center;

  <span class="hljs-attribute">justify-content</span>: space-between;

  <span class="hljs-attribute">padding</span>: <span class="hljs-number">200</span>rpx <span class="hljs-number">0</span>;

  <span class="hljs-attribute">box-sizing</span>: border-box;

}</code>

創建頁面

在這個教程裡(lǐ)，我們有兩個頁面，index 頁面和 logs 頁面，即歡迎頁和小程序啓動日(rì)志的展示頁，他(tā)們都(dōu)在 pages 目錄下。微信小程序中的每一個頁面的【路(lù)徑+頁面名】都(dōu)需要寫在 app.json 的 pages 中，且 pages 中的第一個頁面是小程序的首頁。

每一個小程序頁面是由同路(lù)徑下同名的四個不同後綴文件(jiàn)的組成，如(rú)：index.js、index.wxml、index.wxss、index.json。.js後綴的文件(jiàn)是腳本文件(jiàn)，.json後綴的文件(jiàn)是配置文件(jiàn)，.wxss後綴的是樣式表文件(jiàn)，.wxml後綴的文件(jiàn)是頁面結構文件(jiàn)。

index.wxml 是頁面的結構文件(jiàn)：

<code class="lang-html"><span class="hljs-comment">&lt;!--index.wxml--&gt;</span>

<span class="hljs-tag">&lt;<span class="hljs-name">view</span> <span class="hljs-attr">class</span>=<span class="hljs-string">"container"</span>&gt;</span>

  <span class="hljs-tag">&lt;<span class="hljs-name">view</span>  <span class="hljs-attr">bindtap</span>=<span class="hljs-string">"bindViewTap"</span> <span class="hljs-attr">class</span>=<span class="hljs-string">"userinfo"</span>&gt;</span>

    <span class="hljs-tag">&lt;<span class="hljs-name">image</span> <span class="hljs-attr">class</span>=<span class="hljs-string">"userinfo-avatar"</span> <span class="hljs-attr">src</span>=<span class="hljs-string">"{{userInfo.avatarUrl}}"</span> <span class="hljs-attr">background-size</span>=<span class="hljs-string">"cover"</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">image</span>&gt;</span>

    <span class="hljs-tag">&lt;<span class="hljs-name">text</span> <span class="hljs-attr">class</span>=<span class="hljs-string">"userinfo-nickname"</span>&gt;</span>{{userInfo.nickName}}<span class="hljs-tag">&lt;/<span class="hljs-name">text</span>&gt;</span>

  <span class="hljs-tag">&lt;/<span class="hljs-name">view</span>&gt;</span>

  <span class="hljs-tag">&lt;<span class="hljs-name">view</span> <span class="hljs-attr">class</span>=<span class="hljs-string">"usermotto"</span>&gt;</span>

    <span class="hljs-tag">&lt;<span class="hljs-name">text</span> <span class="hljs-attr">class</span>=<span class="hljs-string">"user-motto"</span>&gt;</span>{{motto}}<span class="hljs-tag">&lt;/<span class="hljs-name">text</span>&gt;</span>

  <span class="hljs-tag">&lt;/<span class="hljs-name">view</span>&gt;</span>

<span class="hljs-tag">&lt;/<span class="hljs-name">view</span>&gt;</span></code>

本例中使用了<view/>、<image/>、<text/>來(lái)搭建頁面結構，綁定數據和交互處理(lǐ)函數。

index.js 是頁面的腳本文件(jiàn)，在這個文件(jiàn)中我們可(kě)以監聽并處理(lǐ)頁面的生(shēng)命周期函數、獲取小程序實例，聲明并處理(lǐ)數據，響應頁面交互事(shì)件(jiàn)等。

<code class="lang-javascript"><span class="hljs-comment">//index.js</span>

<span class="hljs-comment">//獲取應用實例</span>

<span class="hljs-keyword">var</span> app = getApp()

Page({

  data: {

    motto: <span class="hljs-string">'Hello World'</span>,

    userInfo: {}

  },

  <span class="hljs-comment">//事(shì)件(jiàn)處理(lǐ)函數</span>

  bindViewTap: <span class="hljs-function"><span class="hljs-keyword">function</span>() </span>{

    wx.navigateTo({

      url: <span class="hljs-string">'../logs/logs'</span>

    })

  },

  onLoad: <span class="hljs-function"><span class="hljs-keyword">function</span> () </span>{

    <span class="hljs-built_in">console</span>.log(<span class="hljs-string">'onLoad'</span>)

    <span class="hljs-keyword">var</span> that = <span class="hljs-keyword">this</span>

    <span class="hljs-comment">//調用應用實例的方法獲取全局數據</span>

    app.getUserInfo(<span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">userInfo</span>)</span>{

      <span class="hljs-comment">//更新數據</span>

      that.setData({

        userInfo:userInfo

      })

    })

  }

})</code>

index.wxss 是頁面的樣式表：

<code class="lang-css"><span class="hljs-comment">/**index.wxss**/</span>

<span class="hljs-selector-class">.userinfo</span> {

  <span class="hljs-attribute">display</span>: flex;

  <span class="hljs-attribute">flex-direction</span>: column;

  <span class="hljs-attribute">align-items</span>: center;

}

<span class="hljs-selector-class">.userinfo-avatar</span> {

  <span class="hljs-attribute">width</span>: <span class="hljs-number">128</span>rpx;

  <span class="hljs-attribute">height</span>: <span class="hljs-number">128</span>rpx;

  <span class="hljs-attribute">margin</span>: <span class="hljs-number">20</span>rpx;

  <span class="hljs-attribute">border-radius</span>: <span class="hljs-number">50%</span>;

}

<span class="hljs-selector-class">.userinfo-nickname</span> {

  <span class="hljs-attribute">color</span>: <span class="hljs-number">#aaa</span>;

}

<span class="hljs-selector-class">.usermotto</span> {

  <span class="hljs-attribute">margin-top</span>: <span class="hljs-number">200px</span>;

}</code>

頁面的樣式表是非必要的。當有頁面樣式表時，頁面的樣式表中的樣式規則會層疊覆蓋 app.wxss 中的樣式規則。如(rú)果不指定頁面的樣式表，也可(kě)以在頁面的結構文件(jiàn)中直接使用 app.wxss 中指定的樣式規則。

index.json 是頁面的配置文件(jiàn)：

頁面的配置文件(jiàn)是非必要的。當有頁面的配置文件(jiàn)時，配置項在該頁面會覆蓋 app.json 的 window 中相(xiàng)同的配置項。如(rú)果沒有指定的頁面配置文件(jiàn)，則在該頁面直接使用 app.json 中的默認配置。

logs 的頁面結構

<code class="lang-html"><span class="hljs-comment">&lt;!--logs.wxml--&gt;</span>

<span class="hljs-tag">&lt;<span class="hljs-name">view</span> <span class="hljs-attr">class</span>=<span class="hljs-string">"container log-list"</span>&gt;</span>

  <span class="hljs-tag">&lt;<span class="hljs-name">block</span> <span class="hljs-attr">wx:for</span>=<span class="hljs-string">"{{logs}}"</span> <span class="hljs-attr">wx:for-item</span>=<span class="hljs-string">"log"</span>&gt;</span>

    <span class="hljs-tag">&lt;<span class="hljs-name">text</span> <span class="hljs-attr">class</span>=<span class="hljs-string">"log-item"</span>&gt;</span>{{index + 1}}. {{log}}<span class="hljs-tag">&lt;/<span class="hljs-name">text</span>&gt;</span>

  <span class="hljs-tag">&lt;/<span class="hljs-name">block</span>&gt;</span>

<span class="hljs-tag">&lt;/<span class="hljs-name">view</span>&gt;</span></code>

logs 頁面使用 <block/> 控制标簽來(lái)組織代碼，在 <block/> 上使用 wx:for 綁定 logs 數據，并将 logs 數據循環展開節點

<code class="lang-js"><span class="hljs-comment">//logs.js</span>

<span class="hljs-keyword">var</span> util = <span class="hljs-built_in">require</span>(<span class="hljs-string">'../../utils/util.js'</span>)

Page({

  data: {

    logs: []

  },

  onLoad: <span class="hljs-function"><span class="hljs-keyword">function</span> () </span>{

    <span class="hljs-keyword">this</span>.setData({

      logs: (wx.getStorageSync(<span class="hljs-string">'logs'</span>) || []).map(<span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">log</span>) </span>{

        <span class="hljs-keyword">return</span> util.formatTime(<span class="hljs-keyword">new</span> <span class="hljs-built_in">Date</span>(log))

      })

    })

  }

})</code>

運行結果如(rú)下：

4. 手機(jī)預覽

開發者工(gōng)具左側菜單欄選擇”項目”，點擊”預覽”，掃碼後即可(kě)在微信客戶端中體(tǐ)驗。

文章(zhāng)引用：

本站(zhàn)文章(zhāng)爲深圳網站(zhàn)建設·源美網絡原創策劃，如(rú)有版權糾紛或者違規問(wèn)題，請(qǐng)聯系我們删除，謝謝！