项目结构

一、基础结构

• pages：用来存放所有小程序的页面
• utils：用来存放工具性质的模块
• app.js：小程序项目的入口文件
• app.json：小程序项目的全局配置文件
• app.wxss：小程序项目的全局样式文件
• project.config.json：项目的配置文件
• sitemap.json：用来配置小程序及其页面是否允许被微信索引

二、结构详解

JSON配置文件

• JSON是一种数据格式，在实际开发中，JSON总是以配置文件的形式出现。小程序项目中也不例外：通过不同的.json配置文件，可以对小程序项目进行不同级别的配置。

1. app.json文件

• app.json是当前小程序的全局配置，包括小程序的所有页面路径、窗口外观、界面表现等。
• 内容如下:
  • pages：用来记录当前小程序所有页面的路径
  • window：全局定义小程序所有页面的背景色、文字颜色等
  • style：全局定义小程序组件所使用的样式版本
  • sitemapLocation：用来指明 sitemap.json 的位置

2. project.config.json 文件

• project.config.json 是项目配置文件，用来记录我们对小程序开发工具所做的个性化配置，例如：
  • setting 中保存了编译相关的配置
  • projectname 中保存的是项目名称
  • appid 中保存的是小程序的账号 ID

3. sitemap.json 文件

• 微信现已开放小程序内搜索，效果类似于 PC 网页的 SEO。sitemap.json 文件用来配置小程序页面是否允许微信索引。

注意：sitemap 的索引提示是默认开启的，如需要关闭 sitemap 的索引提示，可在小程序项目配置文件 project.config.json 的 setting 中配置字段 checkSiteMap 为 false

4. 页面的 .json 配置文件

• 小程序中的每一个页面，可以使用 .json 文件来对本页面的窗口外观进行配置，页面中的配置项会覆盖 app.json 的 window 中相同的配置项。

5. 新建小程序页面

• 只需要在 app.json->pages 中新增页面的存放路径，小程序开发者工具即可帮我们自动创建对应的页面文件。

6. 修改项目首页

• 只需要调整 app.json -> pages 数组中页面路径的前后顺序，即可修改项目的首页。小程序会把排在第一位的页面，当作项目首页进行渲染。

WXML 模板

1. 定义

• WXML(WeiXin Markup Language) 是小程序框架设计的一套标签语言，用来构建小程序页面的结构，其作用类似于网页开发中的HTML。

2. WXML 和 HTML 的区别

• 标签名称不同
  • HTML (div，span，img，a)
  • WXML （view，text，image，navigator）
• 属性节点不同
  • <a href="#">超链接</a>
  • <navigator url="/pages/home/home"></navigator>
• 提供了类似于 Vue 中的模板语法
  • 数据绑定
  • 列表渲染
  • 条件渲染

WXSS 样式

1. 定义

• WXSS (WeiXin Style Sheets) 是一套样式语言，用于描述 WXML 的组件样式，类似于网页开发中的CSS。

2. WXSS 和 CSS 的区别

• 新增了 rpx 尺寸单位
  • CSS 中需要手动进行像素单位换算
  • WXSS 在底层支持新的尺寸单位 rpx，在不同大小的屏幕上小程序会自动进行换算
• 提供了全局样式和局部样式
  • 项目根目录中的 app.wxss 会作用于所有小程序页面
  • 局部页面的 .wxss 样式仅对当前页面生效
• wxss 仅支持部分 css 选择器
  • .class 和 #id
  • element
  • 并集选择器、后代选择器
  • ::after 和 ::before 等伪类选择器

JS 逻辑交互

1. 小程序中 .js 文件的分类

• app.js：是整个小程序项目的入口文件，通过调用 App() 函数来启动整个小程序
• 页面的 .js 文件：是页面的入口文件，通过调用 Page() 函数来创建并运行页面
• 普通的 .js 文件：是普通的功能模块文件，用来封装公共的函数或属性供页面使用