微信小程序學習筆記

(一)阮一峰教程之一:初次上手

hello world 示例

  • app.js
  • app.json
  • pages/home 子目錄
app.js - 對整個小程序進行初始化

app.js內容只有一行代碼。

App({});
app.json 配置文件,記錄項目的一些靜態配置。

app.json采用 JSON 格式。JSON 是基于 JavaScript 語言的一種數據交換格式,只有五條語法規則,非常簡單,不熟悉 JSON 的同學可以參考這篇教程

app.json文件的內容,至少必須有一個pages屬性,指明小程序包含哪些頁面。

{
  "pages": [
    "pages/home/home"
  ]
}

上面代碼中,pages屬性是一個數組,數組的每一項就是一個頁面。這個示例中,小程序只有一個頁面,所以數組只有一項pages/home/home

pages/home/home是一個三層的文件路徑。

  1. 所有頁面都放在pages子目錄里面。
  2. 每個頁面有一個自己的目錄,這里是pages下面的home子目錄,表示這個頁面叫做home。頁面的名字可以隨便起,只要對應的目錄確實存在即可。
  3. 小程序會加載頁面目錄pages/home里面的home.js文件,.js后綴名可以省略,所以完整的加載路徑為pages/home/homehome.js這個腳本的文件名也可以隨便起,但是習慣上跟頁面目錄同名。
新建 pages/home 子目錄。
$ mkdir -p pages/home

然后,在這個目錄里面新建一個腳本文件home.js。該文件的內容如下。

Page({});

上面代碼中,Page()由小程序原生提供,它是一個函數,用于初始化一個頁面實例。它的參數是一個配置對象,用于設置當前頁面的行為屬性。這里是一個空對象,表示不設置任何屬性。

第五步,在pages/home目錄新建一個home.wxml文件。WXML 是微信頁面標簽語言,類似于 HTML 語言,用于描述小程序的頁面。

home.wxml的內容很簡單,就寫一行hello world

hello world

到這一步,就算基本完成了。現在,打開小程序開發工具,導入項目目錄wechat-miniprogram-demo。如果一切正常,就可以在開發者工具里面,看到運行結果了。

WXML 標簽語言

小程序的 WXML 語言提供各種頁面標簽。下面,對 home.wxml 改造一下,加上兩個最常用的標簽。

<view>
  <text>hello world</text>
</view>

上面的代碼用到了兩個標簽:<view><text>

<view> 標簽表示一個區塊,用于跟其他區塊分隔,類似 HTML 語言的 <div> 標簽。<text> 表示一段行內文本,類似于 HTML 語言的 <span> 標簽,多個 <text> 標簽之間不會產生分行。

小程序的項目結構

總結一下,這個示例一共有4個文件,項目結構如下。

|- app.json
|- app.js
|- pages
   |- home
      |- home.wxml
      |- home.js

這就是最簡單、最基本的小程序結構。所有的小程序項目都是這個結構,在上面不斷添加其他內容。

這個結構分成兩層:描述整體程序的頂層 app 腳本,以及描述各個頁面的 page 腳本。

項目配置文件 app.json

頂層的app.json文件用于整個項目的配置,對于所有頁面都有效。

除了前面提到的必需的pages屬性,app.json文件還有一個window屬性,用來設置小程序的窗口。window屬性的值是一個對象,其中有三個屬性很常用。

  • navigationBarBackgroundColor:導航欄的顏色,默認為#000000(黑色)。
  • navigationBarTextStyle:導航欄的文字顏色,只支持black(黑色)或white(白色),默認為white
  • navigationBarTitleText:導航欄的文字,默認為空。

下面,改一下前面的app.json,加入window屬性。


{
  "pages": [
    "pages/home/home"
  ],
  "window": {
    "navigationBarBackgroundColor": "#ff0000",
    "navigationBarTextStyle": "white",
    "navigationBarTitleText": "小程序 Demo"     
  }
}

上面代碼中,window屬性設置導航欄的背景顏色為紅色(#ff0000),文本顏色為白色(white),標題文字為"小程序 Demo"。

開發者工具導入項目代碼,就可以看到導航欄變掉了。

除了窗口的樣式,很多小程序的頂部或尾部,還有選項欄,可以切換到不同的選項卡。

這個選項欄,也是在app.json里面設置,使用tabBar屬性,這里就不展開了。

(二)阮一峰教程之二:頁面樣式

一、總體樣式

微信小程序允許在頂層放置一個 app.wxss 文件,里面采用 CSS 語法設置頁面樣式。這個文件的設置,對所有頁面都有效。

注意,小程序雖然使用 CSS 樣式,但是樣式文件的后綴名一律要寫成 .wxss

打開上一篇教程的示例,在項目頂層新建一個 app.wxss 文件,內容如下。

page {
  background-color: pink;
}

text {
  font-size: 24pt;
  color: blue;
}

上面代碼將整個頁面的背景色設為粉紅,然后將 <text> 標簽的字體大小設為 24 磅,字體顏色設為藍色。

可以看到,頁面的背景色變成粉紅,文本字體變大了,字體顏色變成了藍色。

實際開發中,直接對 <text> 標簽設置樣式,會影響到所有的文本。一般不這樣用,而是通過 class 屬性區分不同類型的文本,然后再對每種 class 設置樣式。

打開 pages/home/home.wxml 文件,把頁面代碼改成下面這樣。

<view>
  <text class="title">hello world</text>
</view>

上面代碼中,我們為 <text> 標簽加上了一個 class 屬性,值為 title

然后,將頂層的 app.wxss 文件改掉,不再直接對 <text> 設置樣式,改成對 class 設置樣式。

page {
  background-color: pink;
}

.title {
  font-size: 24pt;
  color: blue;
}

上面代碼中,樣式設置在 class 上面(.title),這樣就可以讓不同的 class 呈現不同的樣式。修改之后,頁面的渲染結果并不會有變化。

二、Flex 布局

各種頁面元素的位置關系,稱為布局(layout),小程序官方推薦使用 Flex 布局。不熟悉這種布局的同學,可以看看我寫的《Flex 布局教程》

下面演示如何通過 Flex 布局,將上面示例的文本放置到頁面中央。

首先,在pages/home目錄里面,新建一個home.wxss文件,這個文件設置的樣式,只對 home 頁面生效。這是因為每個頁面通常有不一樣的布局,所以頁面布局一般不寫在全局的app.wxss里面。

然后,home.wxss文件寫入下面的內容。


page {
  height: 100%;
  width: 750rpx;
  display: flex;
  justify-content: center;
  align-items: center;
}

下面解釋一下上面這段 WXSS 代碼,還是很簡單的。

  1. height: 100%;:頁面高度為整個屏幕高度。

  2. width: 750rpx;:頁面寬度為整個屏幕寬度。
    注意,這里單位是 rpx,而不是px。rpx是小程序為適應不同 寬度 的手機屏幕,而發明的一種長度單位。不管什么手機屏幕,寬度一律為750rpx。它的好處是換算簡單,如果一個元素的寬度是頁面的一半,只要寫成width: 375rpx;即可。

  3. display: flex;:整個頁面(page)采用 Flex 布局。

  4. justify-content: center;:頁面的一級子元素(這個示例是 <view>)水平居中。

  5. align-items: center;:頁面的一級子元素(這個示例是 <view>)垂直居中。一個元素同時水平居中和垂直中央,就相當于處在頁面的中央了。

三、WeUI

如果頁面的所有樣式都自己寫,還是挺麻煩的,也沒有這個必要。騰訊封裝了一套 UI 框架 WeUI,可以拿來用。

手機訪問 weui.io,可以看到這套 UI 框架的效果。

這一節就來看看,怎么使用這個框架的小程序版本 WeUI-WXSS,為我們的頁面加上官方的樣式。

首先,進入它的 GitHub 倉庫,在dist/style目錄下面,找到weui.wxss這個文件,將源碼全部復制到你的app.wxss文件的頭部。

然后,將page/home/home.wxml文件改成下面這樣。


<view>
  <button class="weui-btn weui-btn_primary">
    主操作
  </button>
  <button class="weui-btn weui-btn_primary weui-btn_loading">
    <i class="weui-loading"></i>正在加載
  </button>
  <button class="weui-btn weui-btn_primary weui-btn_disabled">
    禁止點擊
  </button>
</view>

可以看到,加入 WeUI 框架以后,只要為按鈕添加不同的 class,就能自動出現框架提供的樣式。你可以根據需要,為頁面選擇不同的按鈕。

這個示例中,<button>元素使用了下面的class

  • weui-btn:按鈕樣式的基類
  • weui-btn_primary:主按鈕的樣式。如果是次要按鈕,就使用weui-btn_default
  • weui-btn_loading:按鈕點擊后,操作正在進行中的樣式。該類內部需要用<i>元素,加上表示正在加載的圖標。
  • weui-btn_disabled:按鈕禁止點擊的樣式。

WeUI 提供了大量的元素樣式,完整的清單可以查看這里

四、加入圖片

美觀的頁面不能光有文字,還必須有圖片。小程序的<image>組件就用來加載圖片。

打開home.wxml文件,將其改為如下代碼。


<view>
  <image src="https://picsum.photos/200"></image>
</view>

開發者工具加載項目代碼,頁面的渲染結果如下,可以顯示圖片了。

<image>組件有很多屬性,比如可以通過style屬性指定樣式。


<view>
  <image
    src="https://picsum.photos/200"
    style="height: 375rpx; width: 375rpx;"
  ></image>
</view>

默認情況下,圖片會占滿整個容器的寬度(這個例子是<view>的寬度),上面代碼通過style屬性指定圖片的高度和寬度(占據頁面寬度的一半),渲染結果如下。

image

當然,圖片樣式不一定寫在<image>組件里面,也可以寫在 WXSS 樣式文件里面。

五、圖片輪播

小程序原生的<swiper>組件可以提供圖片輪播效果。

image

上面頁面的圖片上面,有三個提示點,表示一共有三張圖片,可以切換顯示。

它的代碼很簡單,只需要改一下home.wxml文件即可。


<view>
  <swiper
    indicator-dots="{{true}}"  
    autoplay="{{true}}"
    style="width: 750rpx;">
    <swiper-item>
      <image src="https://picsum.photos/200"></image>
    </swiper-item>
    <swiper-item>
      <image src="https://picsum.photos/250"></image>
    </swiper-item>
    <swiper-item>
      <image src="https://picsum.photos/300"></image>
    </swiper-item>
  </swiper>
</view>

上面代碼中,<swiper>組件就是輪播組件,里面放置了三個<swiper-item>組件,表示有三個輪播項目,每個項目就是一個<image>組件。

<swiper>組件的indicator-dots屬性設置是否顯示輪播點,autoplay屬性設置是否自動播放輪播。它們的屬性值都是一個布爾值,這里要寫成{{true}}。這種{{...}}的語法,表示里面放置的是 JavaScript 代碼,這個放在下一次講解。

(三)阮一峰教程之三:腳本編程

一、數據綁定

前面的所有示例,小程序的頁面都是寫死的,也就是頁面內容不會變。但是,頁面數據其實可以通過腳本傳入,通過腳本改變頁面,實現動態效果。

小程序提供了一種特別的方法,讓頁面可以更方便地使用腳本數據,叫做"數據綁定"(data binding)。

所謂"數據綁定",指的是腳本里面的某些數據,會自動成為頁面可以讀取的全局變量,兩者會同步變動。也就是說,腳本里面修改這個變量的值,頁面會隨之變化;反過來,頁面上修改了這段內容,對應的腳本變量也會隨之變化。這也叫做 MVVM 模式。

下面看一個例子。打開 home.js 文件,改成下面這樣。

Page({
  data: {
    name: '張三'
  }
});

上面代碼中,Page() 方法的配置對象有一個 data 屬性。這個屬性的值也是一個對象,有一個 name 屬性。數據綁定機制規定,data 對象的所有屬性,自動成為當前頁面可以讀取的全局變量。也就是說, home 頁面可以自動讀取 name 變量。

接著,修改 home.wxml 文件,加入 name 變量。

<view>
  <text class="title">hello {{name}}</text>
</view>

上面代碼中,name變量寫在 {{...}} 里面。這是小程序特有的語法,兩重大括號表示,內部不是文本,而是 JavaScript 代碼,它的執行結果會寫入頁面。因此,{{name}} 表示讀取全局變量 name 的值,將這個值寫入網頁。

注意,變量名區分大小寫,nameName 是兩個不同的變量名。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,923評論 6 535
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,740評論 3 420
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,856評論 0 380
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,175評論 1 315
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,931評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,321評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,383評論 3 443
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,533評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,082評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,891評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,067評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,618評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,319評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,732評論 0 27
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,987評論 1 289
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,794評論 3 394
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,076評論 2 375

推薦閱讀更多精彩內容