微信小程序-weUI组件库

article/2025/9/22 21:15:45

微信小程序的开发过程中,常常会出现很多重复性的功能翻来覆去地使用,那么直接用一套封装好的组件库,就能大大提升开发速度。

微信小程序的UI组件库有很多,可以参考下面这个内容:

微信小程序UI组件库合集 | 微信开放社区 (qq.com)https://developers.weixin.qq.com/community/develop/article/doc/000ecc775a86807f7ba9b7dc956c13        但是很多组件库不稳定,天知道什么时候会停止维护和更新,所以这款weUI组件库,就很突出了,这是一套基于样式库weui-wxss (opens new window)开发的小程序扩展组件库,同微信原生视觉体验一致的UI组件库,由微信官方设计团队和小程序团队为微信小程序量身设计,令用户的使用感知更加统一。

目录

weUI组件库的引入与使用

一:引入weUI组件库到项目中

app.json文件

二:页面引入所需weUI组件

1.在index.json中引入对话框组件

2.在index.wxml中使用这个mp-dialog标签

3.在index.js文件中配置wxml中用到的数据和方法

4.页面显示的效果

weUI组件库在开发中的使用步骤

 1.下载weUI组件库样例代码

 2.weUI官网效果示例

​ 3.粘贴样例代码到自己的项目中

 4.使用中的注意事项

复制时不要漏

weUI组件中的js事件代码不要漏

组件的属性字段要看文档


weUI组件库的引入与使用

一:引入weUI组件库到项目中

你的微信小程序项目中,想要引入weUI组件库,非常简单,网上有很多什么粘贴wxss文件,再import 巴拉巴拉的,太麻烦了

其实你只需要在小程序的【app.json文件】中,粘贴几行代码就行了。

app.json文件

{"pages": ["pages/index/index"],"window": {"backgroundTextStyle": "light","navigationBarBackgroundColor": "#fff","navigationBarTitleText": "Weixin","navigationBarTextStyle": "black"},"style": "v2","sitemapLocation": "sitemap.json",/*注意:json文件中不能有注释,这里只是方便说明粘贴下面这几行代码,就表示引入weUI组件库了引入weUI框架,就可以直接在各个页面使用引入组件的形式来导入weui框架的功能使用而且,通过 useExtendedLib 扩展库 的方式引入,这种方式引入的组件将不会计入代码包大小*/"useExtendedLib": {"kbone": true,"weui": true}
}

现在,你就能在项目里使用weUI组件库了,接下来将说明如何在页面中引入需要使用的weUI组件  


二:页面引入所需weUI组件

要在对应的页面引入组件,你得先去看看weUI组件库的官网文档,因为里面有组件的字段属性,虽然没有很明确的使用指引,但是对后续的使用仍有一定的帮助:

快速上手 | wechat-miniprogram / weuihttps://wechat-miniprogram.github.io/weui/docs/quickstart.html#%E5%BC%95%E5%85%A5%E7%BB%84%E4%BB%B6

 举例:此时我需要在index页面中使用一个对话框,那么,

1.在index.json中引入对话框组件

//index.json文件
{"usingComponents": {
// 引入weUI的dialog对话框组件到这个页面"mp-dialog": "weui-miniprogram/dialog/dialog"},"navigationBarTitleText": "weUI学习"
}

2.在index.wxml中使用这个mp-dialog标签


<view class="page" data-weui-theme="{{theme}}"><view class="page__hd"><view class="page__title">Dialog</view><view class="page__desc">对话框</view></view><view class="page__bd"><view class="weui-btn-area"><button class="weui-btn" type="default" bindtap="openConfirm">确认取消按钮</button><button class="weui-btn" type="default" bindtap="tapOneDialogButton">只有确认按钮</button></view></view><mp-dialog title="test" show="{{dialogShow}}" bindbuttontap="tapDialogButton" buttons="{{buttons}}"><view>test content</view></mp-dialog><mp-dialog title="test1" show="{{showOneButtonDialog}}" bindbuttontap="tapDialogButton" buttons="{{oneButton}}"><view>test content1</view></mp-dialog>
</view>

3.在index.js文件中配置wxml中用到的数据和方法

Page({/*** 页面的初始数据*/data: {dialogShow: false,showOneButtonDialog: false,buttons: [{ text: '取消' }, { text: '确定' }],oneButton: [{ text: '确定' }]},
//点击按钮后显示对话框openConfirm: function () {this.setData({dialogShow: true})},tapDialogButton (e) {this.setData({dialogShow: false,showOneButtonDialog: false})},tapOneDialogButton (e) {this.setData({showOneButtonDialog: true})}
})

4.页面显示的效果


        看了上面的演示效果,你应该就知道这样引用和复制代码是完全可以使用weUI的对吧,但是估计你正皱褶眉头,心里想着这些wxml代码那里来的?样式文件那里来的?js代码那里来的? 满脸的黑人问号,不要着急,上面只是通过两个步骤来说明,要在项目中使用weUI是多么的快捷方便接下来我会说明这些复制的代码来源和开发中的使用步骤


weUI组件库在开发中的使用步骤

1.下载weUI组件库样例代码

GitHub - wechat-miniprogram/weui-miniprogram: 小程序WeUI组件库https://github.com/wechat-miniprogram/weui-miniprogram下载组件库代码:

 找到样例代码文件目录:

 反正我下载了代码后是没法运行的,所以就只保留了这个【example文件夹】作为后续开发中使用weUI时的参考代码,其他的文件全删了,没啥用

 2.weUI官网效果示例

既然示例代码运行不起来,那么怎么知道那个组件的效果是什么样子呢?这里就可以通过官网的示例效果来对照着看,示例代码的内容就是官网的一样的,自己复制后改改就行~

WeUI官网效果演示https://weui.io/    

再打开这个样例代码,你看,代码就跟样例一样~

 3.粘贴样例代码到自己的项目中

 现在你有样例代码了,直接复制,粘贴到自己的项目中去,嘿嘿,你以为粘过去运行就能有上面的效果了吗?too young to simple~,你直接粘贴过去,运行得到的结果就是这样:

怎么没有官网示例效果里的效果!?不要急,那是因为你没有引入示例文件的wxss样式文件,所以没有这些布局样式

 仔细看一下【example文件夹】的里面,是不是有个common.wxss文件

 所以,你需要把这些样例代码的样式文件也搞过来

现在,你复制过来的代码,就能在你的项目中运行出效果了,你也就完成了weUI组件库的使用。

weUI组件库中还有很多效果,具体的你可以参考官网的示例,点一点,就会发现很多方便的效果可以直接复制过来使用~ 


 4.使用中的注意事项

  • 复制时不要漏

 有些组件,本身就引入了其他的组件,就以上面的这个徽章组件为例,你会发现它也使用了cell行组件

 

 再看示例代码中,它的json文件:

所以,一个weUI的组件,甚至会包含好几个组件的杂糅使用,在复制的时候,一定要注意看示例代码中的文件,不要复制漏代码

另外:示例代码里引用组件时用的时绝对路径,我们直接按照官方文档里

"mp-dialog": "weui-miniprogram/dialog/dialog"

这样引用就行,不用在意。

  • weUI组件中的js事件代码不要漏

 以dialog对话框为例:

样例代码里是有js代码的,里面的数据在渲染页面和触发事件时都要用到,所以不能漏复制! 

  •  组件的属性字段要看文档

 所以要注意看官方文档里,各个组件的属性字段,这样你才知道哪个组件有哪些属性可以用,虽然官方文档写的也是非常的意识流了,但是聊胜于无,哎~


到此,基础的weUI组件库的使用,已经介绍完了,还有很多其他的微信小程序组件库,但毕竟这个组件库是最类似微信小程序的了,学习一下~


http://chatgpt.dhexx.cn/article/LkKJp78D.shtml

相关文章

微信小程序之WeUI组件库的使用

本文主要介绍微信小程序中的 WeUI组件库的具体使用方法&#xff0c;通过具体的示例代码进行介绍&#xff0c;相信能够对大家的学习和工作都有一定的参考学习意义&#xff0c;欢迎大家一起学习进步。 WeUI组件库 官方文档 一、前言 WeUI 是一套同微信原生视觉体验一致的基础样…

WeUI使用步骤

先去下载 小程序版weui下载地址&#xff1a;https://github.com/Tencent/weui-wxss可以将整个文件下载下来&#xff0c;将其中的dist文件夹导入到独立的小程序中作为参考如下图 注意&#xff1a;样式文件可直接引用dist/style/weui.wxss&#xff0c;或者单独引用dist/style/wi…

npm引入小程序官方WeUI组件库weui-miniprogram

1、打开cmd&#xff0c;在小程序根目录内&#xff0c;初始化npm npm init2、执行命令安装 npm 包&#xff1a; npm install --save weui-miniprogram3、安装完成后&#xff0c;在微信开发者工具中的菜单栏&#xff1a;工具 ------ 构建 npm &#xff1a; 4、在微信开发者工具中…

WeUI 详细介绍

WeUI 是由微信官方设计团队专为微信移动 Web 应用设计的 UI 库。 WeUI 是一套同微信原生视觉体验一致的基础样式库&#xff0c;为微信 Web 开发量身设计&#xff0c;可以令用户的使用感知更加统一。包含button、cell、dialog、toast、article、icon等各式元素。 使用 方法一…

WeUI组件库

一套基于样式库weui-wxss开发的小程序扩展组件库&#xff0c;同微信原生视觉体验一致的UI组件库&#xff0c;由微信官方设计团队和小程序团队为微信小程序量身设计&#xff0c;令用户的使用感知更加统一。 ***全局布置UI组件库&#xff1a;1.引入app.json "useExtende…

微信小程序使用WeUI入门教程

微信小程序使用WeUI入门教程 在学习微信小程序过程中&#xff0c;很多组件的样式需要自己调整&#xff0c;且很多不是我们想要的样子。所以找到了WeUI这样的扩展组件库&#xff0c;预览了组件库&#xff0c;真的非常nice&#xff01; 但是找不到怎么去引用。网上资料又很少&a…

微信公众号weui的使用

hello,i’m Shendi 最近在弄微信公众号&#xff0c;于是记录一下 文章目录 预览下载地址官方文档使用 预览 官方给的演示链接 https://weui.io/ 下载地址 https://github.com/Tencent/weui 将整个仓库下载下来即可 官方文档 https://github.com/Tencent/weui/wiki 使用 …

WeUI for 小程序使用教程文档总结

WeUI 是一套同微信原生视觉体验一致的基础样式库&#xff0c;由微信官方设计团队为微信 Web 开发量身设计&#xff0c;可以令用户的使用感知更加统一。包含按钮button、组件cell、弹框dialog、 进度条progress、 提示toast、文章article、弹出菜单actionsheet、图标icon等各式元…

weui 开发文档

weui开发简单入门 一系列文档地址项目中使用步骤本地起测试demo 一系列文档地址 今天需要用到weui&#xff0c;这里记录一下开发文档地址 开发文档&#xff1a;http://old.jqweui.com/components js文档&#xff1a; https://github.com/Tencent/weui.js/blob/master/docs/R…

Maven 项目查找 jar 包是由哪个配置引入的

maven依赖结构图 1.项目查询所有的Maven查看JAR包的依赖关系 mvn dependency:tree 如查询junit.jar 是依赖谁导入进来的 这样就知道是被谁依赖而导入到项目的 其中“-”符号表示该包后面还有其它依赖包&#xff0c;“\-”表示该包后面不再依赖其它jar包了。 2.搜索具体的某一…

SpringBoot 打成的 jar 包和普通的 jar 包有什么区别

Spring Boot 中默认打包成的 jar 叫做可执行 jar&#xff0c;这种jar包可以通过可以通过命令&#xff08;java -jar xxx.jar&#xff09;来运行的&#xff0c;但这种jar包不能被其他项目所依赖&#xff0c;因为它和普通 jar 的结构不同&#xff0c;即使被依赖了也不能直接使用其…

jar包结构

闲来无事&#xff0c;看了一下jar包的结构&#xff0c;今天来学习一下 就用这个spring-aop的jar包来举例子&#xff1a; 首先是META-INF文件夹下的文件&#xff1a;INDEX.LIST INDEX.LIST&#xff1a;顾名思义&#xff0c;索引列表。这个应该就是描述了当前jar包下所有的资源…

jar包

第三方API就是别人写的类&#xff0c;把别人的众多class拿来直接用&#xff0c;然后做一个集合压缩包&#xff0c;也就是jar包 案例&#xff1a; public class Memo04 { public static void main(String[] args) { //今天你购买了 航空意外保险 //今天是 20230508 //购买了 5…

Maven 项目查找 jar 包是由哪个依赖引入的

文章目录 1. 命令格式2. 使用示例 直接使用mvn dependency:tree可以查看项目完整的依赖树。 1. 命令格式 mvn dependency:tree -Dverbose -Dincludes要查询的内容dependency:tree&#xff1a;表示树状显示。-Dverbose&#xff1a;表示可以显示所有的引用&#xff0c;包括因为…

jar包应该怎么打?

1》首先确保你的项目能正常启动并运行 2》选中你的项目&#xff0c;点右键&#xff0c;选export&#xff08;导出&#xff09;&#xff0c;如下图&#xff1a; 3》选择runnable jar file,下一步&#xff0c;如下图&#xff1a; 4》如下图&#xff0c;直接看图&#xff1a; 5》…

jar包的结构

原模块 <parent><artifactId>cloud-demo</artifactId><groupId>cn.itcast.demo</groupId><version>1.0</version> </parent> <artifactId>feign-api</artifactId>maven install 在本地仓库就生成了下面的文件夹和…

java中的JAR包

使用JAR文件 JAR文件的全称是 Java Archive File&#xff0c;意思就是Java档案文件。通常JAR文件是一种压缩文件&#xff0c;与常见的ZIP压缩文件兼容&#xff0c;通常也被称为JAR包。JAR文件与ZIP文件的区别就是在JAR文件中默认包含了一个名为META-INF/MANIFEST.MF 的清单文…

什么是java包?java包作用是什么?

在Java中的包是一种封装一组类、子包和接口的机制,可用于组织一组相关的类和接口。那么具体什么是java包&#xff1f;java包作用是什么&#xff1f;本篇来简单解答下。 什么是java包&#xff1f; Java 包(package) package是一个为了方便管理组织java文件的目录结构&#xf…

Java 包(什么是包?)

包 概念导入包中的类静态导入将类放到包中基本规则操作步骤 包的访问权限控制常见的系统包 概念 包(package) 是组织类的一种方式. 使用包的主要目的是保证类的唯一性. 例如&#xff1a;你在代码中写了一个 Test 类. 然后你的舍友也可能写一个 Test 类. 如果出现两个同名的类,…

一、JAR包

一、JAR包 1、什么是jar包 **jar包就是 Java Archive File&#xff0c;顾名思义&#xff0c;它的应用是与 Java 息息相关的&#xff0c;是 Java 的一种文档格式&#xff0c;是一种与平台无关的文件格式&#xff0c;可将多个文件合成一个文件。**jar 包与 zip 包非常相似——准…