NezhaUI
轻量、优雅且专业的 Flutter 移动端组件库。
NezhaUI 是一套基于 Flutter 构建的移动端设计系统，致力于为现代应用开发提供丝滑、灵敏且高度可定制的 UI 组件。
特性
- 流畅交互：每个组件都经过细致的性能调优，确保动画过渡自然顺滑。
- 品牌定制：深度集成 NZTheme 系统，支持无缝切换主题与品牌色。
- 生产就绪：提供包括按钮、分割线、下拉刷新和悬浮按钮在内的全套核心组件。
- 动态布局：具备边缘吸附、滚动关联可见性等高级交互逻辑。
- 详尽文档：为每个组件提供详细的 API 参考及实现示例。
安装
在 pubspec.yaml 文件中添加以下依赖：
dependencies:
nezha_ui: ^1.0.1
或者通过命令行安装：
flutter pub add nezha_ui
快速开始
使用 NezhaApp 初始化应用，即可接入该设计系统：
import 'package:flutter/material.dart';
import 'package:nezha_ui/nezha.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return NezhaApp(
title: 'NezhaUI 示例',
theme: NZTheme.lightTheme(),
home: const MyHomePage(),
);
}
}
组件概览
文本排版 (Text)
高度规范化的排版组件，内置 H1-H3 标题、副标题、正文及说明文字样式。
抽屉组件 (Drawer)
灵活的抽屉导航，支持从左、上、右、下四个方向弹出，支持自定义圆角与尺寸。
回到顶部 (BackToTop)
自动监听滚动状态，点击后平滑滚动回顶部，提升长列表阅读体验。
按钮 (Buttons)
支持主要、次要、描边及文字样式，包含进度追踪和图片背景变体。
下拉刷新 (Pull to Refresh)
高度可定制的刷新交互，支持配置标签与加载动画。
悬浮按钮 (Floating Action Button)
具备滚动隐藏、自由拖拽及智能边缘吸附功能。
代码查看器 (Code View)
专业的语法高亮组件，内置 GitHub Light/Dark 主题，支持多语言识别。
Markdown 渲染 (Markdown View)
纯原生实现的轻量级 Markdown 解析组件，支持基础语法及高度样式定制。
导航栏 (NavBar)
多功能顶栏，提供标准、搜索、Logo 及小程序胶囊控制四种模式，深度适配亮/暗色主题。
公告栏 (NoticeBar)
用于循环播放重要信息。支持水平/垂直滚动，内置金融新闻、成功、警告等多种专业样式。
弹窗 (PopUp)
微信风格的对话框组件，用于重要的交互提示或确认操作。支持横向/纵向按钮排列及警示操作样式。
滑动操作 (Swipe Action)
模拟原生移动端滑动交互，支持左/右/上/下四个方向滑出操作按钮，完美适配各类列表操作场景。
瀑布流 (NZMasonry)
高性能瀑布流布局，支持多列等宽不等高排列、交错入场动画及 Builder 模式。经过深度算法优化，即使在处理海量数据时也能保持极高的渲染效率。
进度按钮 (NZProgressButton)
带有实时进度条背景的专业级按钮，适用于下载、上传或长耗时异步操作，提供极具沉浸感的直观状态反馈。
日历组件 (Calendar)
专业级日历组件，支持多样式切换、农历显示、平滑动画及自定义主题。
轻提示 (Toast)
简洁的全局浮层提示，支持成功、失败、加载中等多种状态，自动处理堆栈与消失逻辑。
文档
请参考 doc/nezha_ui.md 获取完整的组件指南。
📚 API 引用
- Full API Reference - 自动生成的详细代码文档。
📖 核心指南
- 颜色规范
- 主题配置
- 按钮组件
- 文本组件
- 抽屉组件
- 回到顶部
- 悬浮按钮
- 下拉刷新
- 代码查看器
- Markdown 渲染
- 导航栏组件
- 分割线组件
- 公告栏组件
- 日历组件
- 弹窗组件
- 滑动操作
- 轻提示
- K线盘面
- 标签组件
- 对话框组件
- 分页器
- 步骤条
- 瀑布流
- 下拉菜单
- 应用入口
- 图片按钮
- 进度按钮
- 悬浮按钮
- 拖拽按钮
贡献
欢迎任何形式的贡献。如有改进建议，请提交 Issue 或 Pull Request。
如果这个项目对你有帮助，请给它一个 ⭐️ 星标！
🌐 全球捐赠通道
国内用户
🔵 支付宝（小企鹅在收金币哟~） |
🟢 微信支付（小绿龙在收金币哟~） |
国际用户
📌 开发者社交图谱
技术交流
社交互动
Libraries
- components/back_to_top
- components/calendar
- components/code_view
- components/dialog
- components/divider
- components/drawer
- components/kpan
- components/markdown_view
- components/masonry
- components/notice_bar
- components/pagination
- components/pop_up
- components/pull_to_refresh
- components/steps
- components/swipe_list_tile
- components/text
- components/toast
- components/tradingview
- functions/database
- model/nzorm
- nezha
- nezha_ui
- theme/colors
- theme/theme
- utilities/utilities