微信小程序的基础配置和目录结构

Posted 地中海真帅

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了微信小程序的基础配置和目录结构相关的知识,希望对你有一定的参考价值。

介绍:昨天学习了小程序的安装和作用,今天就开始小程序的基础知识了,今天主要讲一下目录结构,全局配置和页面配置的一些属性

官方文档地址

https://developers.weixin.qq.com/miniprogram/dev/framework/structure.html.

一.目录结构

如图

  1. components : 放自定义组件的地方,之前小程序是不支持组件化开发的,后来为了贴合大众开发口味,开始支持自定义组件。组件模版会在后面讲,这里只是了解一下目录构成。

  2. images:存放静态图片的地方,这个项目我只是拿来练手的,所以创建了静态图片,一般商业化应用的小程序图片最好是用cdn来完成。

  3. pages:小程序页面存放的位置,如图:

每个小程序页面都有四个文件组成,分别是:

  1. js:负责页面逻辑
  2. json :负责页面配置,如顶部颜色、个性化设置
  3. wxml:类似于html,页面元素组成。(PS:不像html支持很多标签,小程序支持 view text 和button 等标签
  4. wxss:负责页面样式。

注意:为了方便开发者减少配置项,描述页面的四个文件必须具有相同的路径与文件名

全局配置

小程序根目录下的 app.json 文件用来对微信小程序进行全局配置。文件内容为一个 JSON 对象,有以下属性:

配置项


属性类型必填描述最低版本
entryPagePathstring小程序默认启动首页
pagesstring[]页面路径列表
windowObject全局的默认窗口表现
tabBarObject底部 tab 栏的表现
networkTimeoutObject网络超时时间
debugboolean是否开启 debug 模式,默认关闭
functionalPagesboolean是否启用插件功能页,默认关闭2.1.0
subpackagesObject[]分包结构配置 1.7.3
workersstringWorker 代码放置的目录1.9.90
requiredBackgroundModesstring[]需要在后台使用的能力,如「音乐播放」
pluginsObject使用到的插件1.9.6
preloadRuleObject分包预下载规则2.3.0
resizablebooleanPC 小程序是否支持用户任意改变窗口大小(包括最大化窗口);iPad 小程序是否支持屏幕旋转。默认关闭2.3.0
usingComponentsObject全局自定义组件配置 开发者工具1.02.1810190
permissionObject小程序接口权限相关设置微信客户端 7.0.0
sitemapLocationstring指明 sitemap.json 的位置
stylestring指定使用升级后的weui样式 2.8.0
useExtendedLibObject指定需要引用的扩展库2.2.1
entranceDeclareObject微信消息用小程序打开微信客户端7.0.9
darkmodeboolean小程序支持 DarkMode2.11.0
themeLocationstring指明 theme.json 的位置,darkmode为true为必填 开发者工具1.03.2004271
lazyCodeLoadingstring配置自定义组件代码按需注入2.11.1
singlePageObject单页模式相关配置2.12.0

常见属性配置图

注意

  1. 当你在pages下面配置文件时,如果你没有当前文件他会自动在该路径下创建文件
  2. 他会优先展现你pages里面配置的第一个文件,比如第一个配置的是index页面,他的页面上就会显示index页面

页面配置

常见属性

如果你创建的是index文件,那么在index文件里index.json中进行配置,

  1. “navigationBarBackgroundColor”: “#0094aa”,背景颜色

  2. “navigationBarTitleText”: “我的应用” 文本

  3. navigationBarTitleText string 导航栏标题文字内容

  4. backgroundColor HexColor #ffffff 窗口的背景色

  5. backgroundTextStyle string dark 下拉 loading 的样式,仅支持 dark / light

  6. backgroundColorTop string #ffffff 顶部窗口的背景色,仅 ios 支持

详细属性请参考官方文档

https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/page.html.

总结:

今天主要学习了小程序的目录结构和其一些配置,刚开始学的时候有的懵,到后面如果你学习过js和vue的话你会发现他们的语法结构非常相似,页面配置和全局配置官方文档提供了非常多的属性,但这些属性不用全学,根据自己的需要进行学习就行,最后呢希望大家在学习过程中,边写边记,如果有不会的及时在网上查询答案

最后:作者创作不易,如果文章对你有帮助的话,记得留下你的关注和点赞呦

以上是关于微信小程序的基础配置和目录结构的主要内容,如果未能解决你的问题,请参考以下文章

微信小程序基础 文件结构&配置项

微信小程序基础详解

微信小程序基础详解

微信小程序的概要

微信小程序 - 结构目录 | 配置介绍

微信小程序-口味王