nezha_ui 1.0.1
nezha_ui: ^1.0.1 copied to clipboard
轻量、优雅且专业的 Flutter 移动端组件库。NezhaUI 致力于为现代应用开发提供丝滑、灵敏且高度可定制的 UI 组件。
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。
如果这个项目对你有帮助,请给它一个 ⭐️ 星标!
🌐 全球捐赠通道 #
国内用户
🔵 支付宝(小企鹅在收金币哟~) |
🟢 微信支付(小绿龙在收金币哟~) |