SuperAPI AI 工具集

flutter-add-widget-preview

通用与其它

查看项目

更新于 10-15 21:43

技能介绍

用途:为 Flutter 项目添加交互式 Widget 预览,借助 previews.dart 系统在隔离于完整应用上下文的环境中实时渲染组件,便于开发新 UI 组件或更新现有界面。

主要能力:使用 @Preview 注解标记顶层函数、类内静态方法,或无必需参数且返回 Widget/WidgetBuilder 的公开构造函数/工厂;通过继承 Preview 创建自定义注解以注入主题、包装器等公共属性;对同一目标应用多个 @Preview 生成多个预览实例,或继承 MultiPreview 封装多预览配置;可重写 transform() 在运行时动态修改预览配置。

使用方式:导入 package:flutter/widget_previews.dart;选择合法目标并应用 @Preview,按需配置 name、group、size、theme、brightness 等参数。在支持的 IDE(Android Studio、IntelliJ、Flutter 3.38+ 的 VS Code)中预览器自动启动,打开侧边栏的 Flutter Widget Preview 标签;命令行方式为在项目根目录运行 flutter widget-preview start,随后在自动打开的 Chrome 中查看。修改代码后预览自动更新,必要时使用全局或单个预览卡片的热重启按钮。

限制:预览器运行在 Web 环境,不能使用原生插件或 dart:io、dart:ffi API,存在相关传递依赖的组件会抛异常,可用条件导入绕过;资源需使用基于包的路径(如 packages/my_package_name/assets/my_image.png);回调参数须为公开且常量;无约束组件应通过 size 参数显式约束,否则默认约为视口一半。

适用场景:组件开发、界面迭代与视觉验证。其他细节暂未提供。