antd_flutter_ui 1.0.3
antd_flutter_ui: ^1.0.3 copied to clipboard
Ant Design v6 Flutter UI component library (base layer). Shared engines and basic/generic components, ported from antd and antd-mobile.
antd_flutter_ui - Base component layer for Ant Design Flutter #
Positioning & design #
antd_flutter_ui is the base component layer of the Ant Design Flutter suite. It provides the shared widgets that the umbrella package and every standalone component package build on, plus the shared engines behind popups, pickers and keyboard interaction. It is not a standalone design system: it works together with antd_theme, which owns AntThemeData, the design tokens and the scaling model.
- Base layer with a fixed dependency direction. Standalone packages →
antd_flutter_ui→antd_theme/antd_tokens/antd_color/antd_icons_flutter. Standalone packages never depend on each other. - Two upstream styles, one API. Desktop widgets follow Ant Design v6; mobile widgets follow antd-mobile v5. The choice is derived from platform and layout data, not from a global build flag.
- Generic data parameters. Data-driven widgets take
List<T>plus accessors such askeyOf,labelOf,labelBuilderanditemBuilder, so business models do not need conversion into component-specific option objects. - One sizing system. Design values go through
theme.s(...), which applies the activeAntScale. Components never readScreenUtiland never hard-code pixel values, so one scale factor rescales typography, control heights, radii and spacing together. - Shared engines live here. Popup placement, wheel-picker columns, hotkeys and the calendar grid are implemented once under
lib/src/engines/and reused by the standalone packages. - No application shell. The package never creates a
MaterialApp. Wrap your app inAntThemeyourself; it injects both the Ant scope and a derived Flutter theme, so Material widgets pick up Ant styling automatically.
Installation #
Requires Dart >=3.0.0 <4.0.0 and Flutter >=3.10.0.
dependencies:
antd_flutter_ui: ^1.0.0
antd_theme: ^1.0.0
material_ui: ^1.11.0
antd_theme is a direct dependency because you pass AntThemeData to AntTheme. material_ui supplies MaterialApp, Scaffold and the widget re-exports used in the examples.
Quick start #
The following application is complete and runnable:
import 'package:antd_flutter_ui/antd_flutter_ui.dart';
import 'package:antd_theme/antd_theme.dart';
import 'package:material_ui/material_ui.dart';
void main() => runApp(const UiDemoApp());
class UiDemoApp extends StatelessWidget {
const UiDemoApp({super.key});
@override
Widget build(BuildContext context) {
return AntTheme(
data: AntThemeData.light(),
child: MaterialApp(
theme: AntThemeData.light().toThemeData(),
home: const UiDemoPage(),
),
);
}
}
class UiDemoPage extends StatelessWidget {
const UiDemoPage({super.key});
@override
Widget build(BuildContext context) {
final theme = AntTheme.of(context);
return Scaffold(
backgroundColor: theme.colorBgLayout,
appBar: PreferredSize(
preferredSize: const Size.fromHeight(45),
child: AntAppBar(title: const Text('Ant Design Flutter')),
),
body: ListView(
padding: EdgeInsets.all(theme.s(16)),
children: [
AntButton(
type: AntButtonType.primary,
onTap: () {},
child: const Text('Primary button'),
),
SizedBox(height: theme.s(12)),
AntInput(
placeholder: 'Type something',
onChange: (value) {},
),
],
),
);
}
}
API #
Import only the widgets you use, for example import 'package:antd_flutter_ui/antd_flutter_ui.dart' show AntButton, AntButtonType, AntInput;. Theme types come from antd_theme.
Button #
AntButton uses onTap rather than Material's onPressed, and accepts any child widget.
AntButton(
type: AntButtonType.primary,
onTap: () {},
child: const Text('Submit'),
);
Input #
AntInput is controlled when value is supplied and uncontrolled when defaultValue is used.
AntInput(
placeholder: 'Type something',
onChange: (value) {},
);
Theme #
AntTheme takes an AntThemeData and derives the Flutter theme from it. Read the active theme with AntTheme.of(context) and scale design values with theme.s(...).
final data = AntThemeData.light(scale: const AntScale(1.15));
AntTheme(
data: data,
child: MaterialApp(
theme: data.toThemeData(),
home: const Scaffold(body: Text('Hello')),
),
);
Demo #
- Live demo: https://flutter-open.github.io/antd-flutter/
- Found a bug or have a question? Open an issue
Project structure #
packages/antd_flutter_ui/
├── lib/
│ ├── antd_flutter_ui.dart # Public barrel (all exports)
│ └── src/
│ ├── basic/ # Button, typography, layout, grid, space, divider, tooltip
│ ├── data_entry/ # Input, select, checkbox, radio, switch, slider, rate, uploader
│ ├── display/ # Avatar, badge, card, list, popover family, statistic, tour
│ ├── feedback/ # Alert, dialog, drawer, message, modal, toast, progress
│ ├── navigation/ # Tabs family, menu, breadcrumb, pagination, steps, bars
│ ├── general/ # FloatButton family
│ ├── misc/ # App, ConfigProvider, Affix, BorderBeam
│ └── engines/ # Popup, wheel picker, hotkeys, calendar grid
├── docs/api-index.md # Generated API index
├── test/ # Widget and engine tests
├── CHANGELOG.md
├── README.md
├── README_CN.md
└── pubspec.yaml
License #
MIT. See the repository root LICENSE.
☕ Buy Me a Coffee #
If this project has been helpful to you, you are welcome to buy me a coffee. Thank you for your support!
| Alipay | |
|---|---|
![]() |
![]() |

