Lazy loaded image
微信小程序
02小程序目录结构与配置
字数 1105阅读时长 3 分钟
2023-9-25
2023-9-27
type
status
date
slug
summary
category
tags
password
icon
 

云开发目录结构

|-- cloudfunctions/ # 云函数目录 | |-- login/ # 一个名为 "login" 的云函数 | |-- index.js # 云函数主体文件 | |-- package.json # npm 配置文件 |-- miniprogram/ # 小程序主体部分 | |-- components/ # 组件目录 | |-- images/ # 图片资源目录 | |-- pages/ # 页面文件目录 | |-- index/ # index 页面 | |-- index.wxml | |-- index.wxss | |-- index.js | |-- index.json | |-- app.js # 小程序逻辑 | |-- app.json # 小程序公共设置 | |-- app.wxss # 小程序公共样式表
| |-- sitemap.json. # 小程序页面是否被索引 |-- project.config.json # 工程配置文件

重要的目录和文件解释:

  1. cloudfunctions/: 这个目录用于存放所有的云函数。每一个子目录都是一个单独的云函数,其中的 index.js 文件用于编写云函数的主体逻辑。
  1. miniprogram/: 这个目录用于存放小程序的主体部分,包括页面文件、组件、图片资源等。
  1. components/: 在 miniprogram/ 目录下的 components/ 用于存放自定义组件。
  1. images/: 存放图片资源。
  1. pages/: 存放小程序的各个页面。
  1. app.js: 小程序的全局逻辑处理文件。
  1. app.json: 包含了小程序的全局配置,如页面路径、窗口表现、网络超时等。
  1. app.wxss: 全局样式。
  1. project.config.json: 包含了项目的配置信息,如 AppID、项目名、项目图标等。
 
注意:目录名和文件名不应包含空格和中文,以防出现不可预知的错误。
 
详细配置请参考官方文档:

页面结构

在每一个页面文件夹里都有四个文件,这四个文件的名称都是一样的,它们分别为:
  • json文件,和上面的app.json作用基本相同,只是app.json控制的是整个小程序的设置,而页面的json文件只控制单个页面的配置(因为有时候全局配置就够用了,所以页面配置有时候是空的);
  • wxml文件,小程序的页面结构,文字、图片、音乐、视频、地图、轮播等组件都会放在这里;
  • wxss文件,小程序的页面样式,和app.wxss一样是控制样式,而页面的wxss文件是控制单个页面的样式;
  • js文件,这个是控制小程序页面的逻辑(这个可以先放着,不用管)

小程序的全局配置

在app.json中配置,可参考文档:

json讲解

JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,易于人阅读和编写,同时也易于机器解析和生成。由于其易于阅读和解析,JSON 已经成为 Web 开发中用于数据交换的一种常用格式,尤其在 AJAX 应用和 RESTful API 中。

JSON 的基础规则

  1. 数据是键值对(Key-Value)的形式:键(Key)是字符串,值(Value)可以是多种数据类型(数字、字符串、布尔值、对象、数组、null)。
    1. 键名(Key)必须用双引号包围
      1. 字符串也必须用双引号包围
        1. 值(Value)可以是对象或数组
          1. 支持简单的数据类型:字符串、数字、布尔值、null
            1. 不支持注释

            注意

            • JSON 是语言无关的,尽管它源于 JavaScript。
            • JSON 是纯文本格式,不含任何执行代码。
            • JSON 文件通常以 .json 为文件扩展名。

            示例

            下面是一个 JSON 对象的示例:
            这个 JSON 对象包含了多种数据类型,包括字符串、数字、布尔值、数组和嵌套对象。这种多层次的结构在 JSON 中是非常常见的。
             
            上一篇
            01注册小程序与开发工具配置
            下一篇
            03开发一个第一个静态页面