文章目录

使用 WeUI 前,先分清你需要的是设计资源、微信内网页的样式库,还是小程序组件。设计师可以用视觉资源组合页面,再把组件状态和交互交给研发;把组件拖进设计稿,并不等于已经接入小程序代码。下面从配置与资源调用步骤开始,再用一个登录表单说明设计稿怎样对接实现。

如果要把 WeUI 中常用的输入行和按钮沉淀为团队资产,可以先了解组件的创建与复用,再在本篇案例里补齐默认、错误和提交状态。

WeUI视觉资源、Pixso登录表单状态与小程序组件实现之间的对应关系

1. 视觉标准

WeUI-Design 是微信官方提供的设计参考资源;WeUI Web 样式库面向微信内网页;weui-miniprogram则是小程序扩展组件库。三者可以采用相近的视觉语言,但文件类型、接入方式和维护版本不同。设计评审前先与研发确认项目使用哪一套实现。

资源谁主要使用产生什么结果
设计参考与设计组件设计师页面结构、组件外观和状态说明
Web 样式库网页研发微信内网页中的视觉样式
小程序扩展组件库小程序研发小程序页面中可调用的组件及其属性/事件

设计稿中的 cell、button、dialog 或 toast 名称,是沟通的起点。要实现真实登录,还需要接口、校验和会话处理;这些业务行为不由视觉资源本身完成。

2. 如何配置WeUI

第一步,在全局配置中引入WeUI

图中采用小程序扩展库方式:在 app.json 中用 useExtendedLib 声明 weui。另一种项目可能通过 npm 管理组件依赖,二者的接入与版本管理方式不同。先确认项目采用哪种方式,再核对页面需要的组件,不要把 Web 样式库的安装步骤直接搬到小程序中。

小程序app.json中通过useExtendedLib引入WeUI

第二步,在页面配置中指定使用的组件

在需要使用WeUI组件的页面配置文件中,指定需要使用的具体组件名称。

页面配置中声明所使用的WeUI小程序组件

第三步,在页面中使用WeUI组件

在页面中通过对应的 WXML 标签使用组件,并配置需要的属性与事件;样式类负责视觉表现,组件事件负责把用户动作交给业务处理。下图展示了表单结构,开发时应让标签、组件路径和项目采用的库版本对应。

小程序WXML中组合表单与输入行的代码结构

3. 如何快速应用WeUI组件库

第一步,进入Pixso 社区资源库

在 Pixso 社区中查找 WeUI 设计资源,可以根据项目选择浅色或深色版本。打开资源详情,确认包含的页面和组件,再复制或添加到自己的设计文件;资源说明中的使用范围与授权也应一并保留。

Pixso资源社区中的WeUI浅色与深色设计资源

第二步,一键调用资源

选择需要的 WeUI 资源,按详情页入口添加到自己的文件或资源中。先打开一份副本,检查文字、颜色和组件结构是否符合这次项目的需要,再用于正式页面。

在WeUI资源详情页添加设计资源

第三步,进入Pixso画布开启工作

在资源中,拖拽使用WeUI设计组件库。

在Pixso画布资源面板中使用WeUI组件

用登录表单把设计组件变成一套状态

将资源添加到文件后,新建一个登录画板:上方放页面标题,中间用输入行承载账号和密码,底部放登录按钮。先按资源的结构组织内容,再复制出“填写中”“字段错误”“提交中”和“登录失败”几个画板,保持字段顺序和标签一致。

状态设计稿里要出现什么交给研发的说明
默认字段名、输入位置、登录按钮哪些必填,默认焦点放哪里
字段错误错误字段旁的具体说明何时校验,修改后何时清除错误
提交中按钮的处理中反馈,保留已填内容重复点击如何处理,等待期间哪些内容可编辑
登录失败可读的失败说明与重试入口提示位置、是否保留账号,不在消息中泄露敏感信息
登录成功进入目标页面或明确完成状态返回来源页还是进入首页,避免让toast承担唯一结果

例如密码为空时,在密码行附近说明缺少什么,比只弹出一句“出错了”更容易修正;网络失败时,应保留用户已填的信息并给出重试入口。错误提示和 toast 各有适合的场景,不应把所有异常都做成一闪而过的消息。

将这些状态放在同一份 Pixso 文件里,让设计与研发对照组件名称、文字和触发条件。视觉资源中若没有需要的状态,就为当前项目补一个,并在说明中标出新增部分;不要只复制默认组件后让研发自行猜测。

交付时多给一列“实现对应”

在状态画板旁列出设计组件名称、对应代码组件、关键属性、触发事件和业务处理。设计里的“账号输入行”可能由多个代码组件组成,不必为了名称一致硬凑一一映射;关键是让研发知道边界、状态和行为分别由谁负责。

同时记录所采用的资源版本和修改过的内容,例如输入行的间距、按钮文字或错误提示位置。后续更新资源时,先检查这些差异是否仍然需要保留,避免覆盖已经约定好的业务状态。

4. Pixso在线协作设计工具特点

Pixso是国内 UI/UX 设计师和产品经理都在使用的专业设计工具,大量内置设计系统资源,能帮助你快速启动设计工作。

Pixso社区——内置腾讯、阿里、字节、今日头条、蚂蚁设计等优秀设计规范,提供海量设计模板和素材,本地化字体资源。

设计协作——Pixso实现了团队所有人都能在同一个文档上工作,原型、设计、交付一站式解决,引领新的设计协作趋势。

在线评论反馈——通过文件链接邀请相关成员查看设计,在对应画板或控件旁记录意见,便于对照状态修改。

设计交付——分享文件后,研发可结合设计稿查看尺寸、颜色等标注和资源,并对照组件状态实现页面。文件权限和交付范围应与项目成员的职责对应。

云端协作——在受支持的浏览器中访问设计文件,团队可以查看同一份稿件与修改记录;重要交付节点仍应记录版本和变更内容。

团队协作——团队成员可以协作查看、编辑和同步同一项目的信息,支持UI/UX设计师实时异地完成创作和沟通。