小程序（一）WePy框架的使用

WePy教程

[TOC]

基本示例

import wepy from 'wepy';//引入wepy框架说明
// 通过继承自wepy.page的类创建页面逻辑
export default class Index extends wepy.page {
  //用于页面模板绑定的数据
  data={
    motto: 'hello world',
    userInfo: {}
  }

//事件处理函数(集中保存在methonds对象中)
methods = {
  bindViewTap(){
    console.log('button clicked');
  }
}
  
onLoad () {//页面的声明周期方法
  console.log('onLoad');
}
}

WePy的基本配置

• WePy根据npm命令来安装：

  npm install wepy-cli -g
  

  ​

• 在指定的目录创建项目

  wepy new myproject
  

• 切换到指定项目

  cd myproject
  

• 开启实时编译

  wepy build --watch
  

WePy项目的目录结构

├── dist                   微信开发者工具指定的目录（该目录由WePY的build指令自动编译生成，请不要直接修改该目录下的文件）
├── node_modules           
├── src                    代码编写的目录（该目录为使用WePY后的开发目录）
|   ├── components         WePY组件目录（组件不属于完整页面，仅供完整页面或其他组件引用）
|   |   ├── com_a.wpy      可复用的WePY组件a
|   |   └── com_b.wpy      可复用的WePY组件b
|   ├── pages              WePY页面目录（属于完整页面）
|   |   ├── index.wpy      index页面（经build后，会在dist目录下的pages目录生成index.js、index.json、index.wxml和index.wxss文件）
|   |   └── other.wpy      other页面（经build后，会在dist目录下的pages目录生成other.js、other.json、other.wxml和other.wxss文件）
|   └── app.wpy            小程序配置项（全局数据、样式、声明钩子等；经build后，会在dist目录下生成app.js、app.json和app.wxss文件）
└── package.json           项目的package配置

事件绑定语法

官网语法	替换后
bindtap="click"	@tap="click"
catchtap="click"	@tap.stop="click“

catchtap和bindtap区别

bind事件绑定不会阻止冒泡事件向上冒泡，catch事件绑定可以阻止冒泡事件向上冒泡

repeat语法

组件化开发

import wepy from 'wepy';

export default class MyComponent extends wepy.component {
    methods = {
        bindtap () {
            let rst = this.commonFunc();
            // doSomething
        },

        bindinput () {
            let rst = this.commonFunc();
            // doSomething
        },
    }

    //正确：普通自定义方法在methods对象外声明，与methods平级
    customFunction () {
        return 'sth.';
    }

}

示例：

promise处理

import wepy from 'wepy';

async onLoad() {
    await wepy.login();
    this.userInfo = await wepy.getUserInfo();
}

关键字：async await 可以直接对promise类型进行支持

wepy从以下几点能提供便利：

• 类Vue开发风格
• 支持自定义组件开发
• 支持引入NPM包
• 支持Promise
• 支持ES2015+特性，如Async Functions
• 支持多种编译器，Less/Sass/Styus、Babel/Typescript、Pug
• 支持多种插件处理，文件压缩，图片压缩，内容替换等
• 支持 Sourcemap，ESLint等
• 小程序细节优化，如请求列队，事件优化等

CSS

层叠样式表【Cascading Style Sheets】
基本的页面样式是用CSS来做支持的。所以CSS样式对页面来讲是一个脸面的存在
注：以下CSS部分来自 https://developer.mozilla.org/en-US/docs/Web/CSS

层叠样式表（CSS）是一种样式表语言,用于描述用HTML或 XML（包括XML方言，如 SVG或 XHTML）编写的文档的表示。CSS描述了元素如何在屏幕上，纸上，语音或其他媒体上呈现。

CSS主要能影响以下几点：

• 【文本样式】Styling text
• 【盒子样式】Styling boxes
• 【CSS布局】CSS layout

文本样式

• 字体

  术语	定义	例
  serif	有衬线字体的字体（在某些字体的笔触结尾处看到的蓬勃发展和其他细节）	我的大红象
  sans-serif	没有衬线的字体。	我的大红象
  monospace	每个字符具有相同宽度的字体，通常用于代码清单中。	我的大红象
  cursive	旨在模仿手写的字体，流畅的笔画。	我的大红象
  fantasy	打算装饰的字体。	我的大红象

• 颜色

  ​

ems :1em等于在我们设计的当前元素的父元素上设置的字体大小（更具体地说，包含在父元素中的大写字母M的宽度

font-style:Used to turn italic text on and off.

CSS布局

justify-content:用于设置或检索弹性盒子元素在主轴（横轴）方向上的对齐方式。

测试页面：
http://www.runoob.com/try/playit.php?f=playcss_justify-content&preval=flex-start

align-items:属性定义flex子项在flex容器的当前行的侧轴（纵轴）方向上的对齐方式。
测试页面：
http://www.runoob.com/try/playit.php?f=playcss_align-items&preval=stretch

p:last-child：指定属于其父元素的最后一个子元素

display: flex:Flex 是 Flexible Box 的缩写，意为"弹性布局"，用来为盒状模型提供最大的灵活性。

• 任何一个容器都可以指定为 Flex 布局。
• Webkit 内核的浏览器，必须加上-webkit前缀。

.box{
  display: -webkit-flex; /* Safari */
  display: flex;
}

注意，设为 Flex 布局以后，子元素的float、clear和vertical-align属性将失效。
Flex布局：http://www.ruanyifeng.com/blog/2015/07/flex-examples.html

遗留问题：

• 在wepy中对TypeScript的引入的支持
• TypeScript编译的目录始终没能和wepy编译生成的目录在一块
• wepy虽然在issue中提供了一些对TypeScript支持线索，但是具体的文档没有提供，实在是一件遗憾的事