目录结构
小程序包含一个描述整体程序的 app
和多个描述各自页面的 page
。
小程序目录结构
.
├── images // 小程序资源默认路径文件,建议将图片等资源都放在这个目录下,读取时使用 /images/xxx.png 形式绝对路径读取
├── pages // 小程序的页面
│ ├── index.css // 小程序的页面的样式
│ ├── index.dlt // 小程序的页面模板
│ ├── index.js // 小程序的页面逻辑
│ └── index.json // 小程序的页面配置
├── app.css // 小程序全局样式
├── app.js // 小程序全局 js 逻辑
└── app.json // 小程序全局配置
主体组成
一个小程序主体部分由三个文件组成,必须放在项目的根目录,如下:
文件 | 必需 | 作用 |
---|---|---|
app.js | 是 | 小程序逻辑 |
app.json | 是 | 小程序公共配置 |
app.css | 否 | 小程序公共样式表 |
页面组成
一个小程序页面由四个文件组成,分别是:
文件 | 必需 | 作用 |
---|---|---|
js | 是 | 页面逻辑 |
dlt | 是 | 页面结构 |
json | 否 | 页面配置 |
css | 否 | 页面样式表 |
注意:为了方便开发者减少配置项,描述页面的四个文件必须具有相同的路径与文件名。
资源文件夹 images
项目内的图片、视频等资源建议放在项目根目录下 images 目录下,取用资源时的目录用根目录路径 images/xxx.png
。
允许上传的文件
在项目目录中,以下文件会经过编译,因此上传之后无法直接访问到:.js、app.json、.dlt、*.css(其中 dlt 和 css 文件仅针对在 app.json 中配置了的页面)。除此之外,只有后缀名在白名单内的文件可以被上传,不在白名单列表内文件在开发工具能被访问到,但无法被上传。具体白名单列表如下:
- png
- jpg
- jpeg
- gif
- svg
- json
- cer
- mp3
- aac
- m4a
- mp4
- wav
- ogg
- silk
- wasm
- br
- cert