Skip to main content

antd_picker 1.0.1 copy "antd_picker: ^1.0.1" to clipboard
antd_picker: ^1.0.1 copied to clipboard

Ant Design picker, cascader, date and time pickers for Flutter, with wheel columns and antd-mobile v5 interaction.

example/lib/main.dart

/// antd_picker example — 弹层选择器族演示画廊(Picker / DatePicker / TimePicker / Cascader)。
///
/// - 数据源全部使用用户自定义模型([_Season] / [_Fruit] / [_Region]),
///   通过 `keyOf` / `childrenOf` / `labelBuilder` 驱动,不构造组件库模型。
/// - 主题经 antd_theme(P03 桥接)注入:`AntThemeData.light/dark().toThemeData()`
/// - R35.4 多平台适配:AntResponsiveInit + AntResponsive.breakpointOf 断点布局
///   (desktop 宽屏双栏 / phone 窄屏单栏),窗口缩放无溢出
/// - 暗色切换:AppBar 按钮联动 AntTheme + themeMode
/// - 覆盖关键形态:Picker 单列/多列联动、受控操作;DatePicker 年月日;
///   TimePicker 时分秒;Cascader 级联 / CascaderView 内嵌
library;

import 'package:antd_icons_flutter/antd_icons_flutter.dart';
import 'package:antd_picker/antd_picker.dart';
import 'package:antd_theme/antd_theme.dart';
import 'package:material_ui/material_ui.dart';

void main() {
  runApp(const AntdPickerGalleryApp());
}

/// 演示卡片:标题 + 内容。
typedef _DemoCard = (String, Widget);

/// antd 选择器画廊根组件。
class AntdPickerGalleryApp extends StatefulWidget {
  const AntdPickerGalleryApp({super.key});

  @override
  State<AntdPickerGalleryApp> createState() => _AntdPickerGalleryAppState();
}

class _AntdPickerGalleryAppState extends State<AntdPickerGalleryApp> {
  bool _isDark = false;

  static const List<String> _sectionTitles = [
    'Picker 滚轮选择',
    'DatePicker 日期',
    'TimePicker 时间',
    'Cascader 级联',
    'CascaderView 内嵌',
    '受控操作',
  ];

  static final List<List<_DemoCard>> _sectionCards = [
    _pickerCards,
    _datePickerCards,
    _timePickerCards,
    _cascaderCards,
    _cascaderViewCards,
    [], // 受控分区为 StatefulWidget,见 _buildSectionBody
  ];

  @override
  Widget build(BuildContext context) {
    // 结构对齐 antd_image_viewer / antd_splitter example:AntTheme 包裹 MaterialApp,
    // theme + darkTheme + themeMode 三件套联动,Scaffold 背景跟随 colorBgLayout。
    return AntTheme(
      data: _isDark ? AntThemeData.dark() : AntThemeData.light(),
      child: AntResponsiveInit(
          builder: (context, layout, _) => MaterialApp(
            title: 'AntdPicker Demo',
            debugShowCheckedModeBanner: false,
            themeMode: _isDark ? ThemeMode.dark : ThemeMode.light,
            theme: AntThemeData.light().toThemeData(),
            darkTheme: AntThemeData.dark().toThemeData(),
            home: DefaultTabController(
              length: _sectionTitles.length,
              child: Scaffold(
                backgroundColor: AntTheme.of(context).colorBgLayout,
                appBar: AppBar(
                  title: const Text('Picker 选择器族'),
                  actions: [
                    IconButton(
                      onPressed: () => setState(() => _isDark = !_isDark),
                      icon: Icon(
                        _isDark ? AntIcons.sunOutlined : AntIcons.moonOutlined,
                      ),
                    ),
                  ],
                  bottom: TabBar(
                    isScrollable: true,
                    tabs: [for (final t in _sectionTitles) Tab(text: t)],
                  ),
                ),
                // R35.4:desktop 宽屏双栏、phone 窄屏单栏,缩放窗口不溢出。
                body: TabBarView(
                  children: [
                    for (var i = 0; i < _sectionTitles.length; i++)
                      _sectionBody(context, layout, i),
                  ],
                ),
              ),
            ),
          ),
        ),
    );
  }

  Widget _sectionBody(
    BuildContext pageContext,
    AntLayoutData layout,
    int index,
  ) {
    final theme = AntTheme.of(pageContext);
    final cards = index == _sectionTitles.length - 1
        ? const _ControlledSection().cards
        : _sectionCards[index];
    final isWide =
        layout.width >= 768 ||
        layout.breakpoint == AntBreakpoint.lg ||
        layout.breakpoint == AntBreakpoint.xl ||
        layout.breakpoint == AntBreakpoint.xxl;
    return SingleChildScrollView(
      padding: EdgeInsets.all(theme.s(16)),
      child: isWide
          ? Wrap(
              spacing: theme.s(16),
              runSpacing: theme.s(16),
              children: [
                for (final card in cards)
                  ConstrainedBox(
                    constraints: BoxConstraints(maxWidth: theme.s(480)),
                    child: _sectionCard(pageContext, card.$1, card.$2),
                  ),
              ],
            )
          : Column(
              children: [
                for (final card in cards)
                  Padding(
                    padding: EdgeInsets.only(bottom: theme.s(16)),
                    child: _sectionCard(pageContext, card.$1, card.$2),
                  ),
              ],
            ),
    );
  }
}

/// 卡片容器。
Widget _sectionCard(BuildContext context, String title, Widget child) {
  final theme = AntTheme.of(context);
  return Container(
    width: double.infinity,
    padding: EdgeInsets.all(theme.s(16)),
    decoration: BoxDecoration(
      color: theme.colorBgContainer,
      borderRadius: BorderRadius.circular(theme.borderRadiusLG),
      border: Border.all(color: theme.colorSplit),
    ),
    child: Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        Padding(
          padding: EdgeInsets.only(bottom: theme.s(12)),
          child: Text(
            title,
            style: TextStyle(fontWeight: FontWeight.bold, fontSize: theme.s(15)),
          ),
        ),
        child,
      ],
    ),
  );
}

/// 触发器外壳(带边框的入口文本)。
Widget _triggerBox(BuildContext context, String text) {
  final theme = AntTheme.of(context);
  return Container(
    padding: EdgeInsets.symmetric(horizontal: theme.s(12), vertical: theme.s(8)),
    decoration: BoxDecoration(
      border: Border.all(color: theme.colorSplit),
      borderRadius: BorderRadius.circular(theme.borderRadius),
    ),
    child: Text(text, style: TextStyle(fontSize: theme.s(14))),
  );
}

Widget _resultText(BuildContext context, String label, String value) {
  final theme = AntTheme.of(context);
  return Text(
    value.isEmpty ? '$label:未选择' : '$label:$value',
    style: TextStyle(fontSize: theme.s(14), color: theme.colorText),
  );
}

// ── 用户自定义模型 ──────────────────────────────────────────
/// 通用选项模型(季节 / 水果共用,演示多列可共享同一泛型)
class _NamedOption {
  const _NamedOption(this.id, this.name);

  final String id;
  final String name;
}

/// 地区(树形)
class Region {
  const Region(
    this.code,
    this.name, [
    this.children = const [],
    this.disabled = false,
  ]);

  final String code;
  final String name;
  final List<Region> children;
  final bool disabled;
}

const _seasons = <_NamedOption>[
  _NamedOption('spring', '春'),
  _NamedOption('summer', '夏'),
  _NamedOption('autumn', '秋'),
  _NamedOption('winter', '冬'),
];

const _fruits = <_NamedOption>[
  _NamedOption('apple', '苹果'),
  _NamedOption('banana', '香蕉'),
  _NamedOption('orange', '橙子'),
  _NamedOption('grape', '葡萄'),
];

const _regions = <Region>[
  Region('zj', '浙江', [
    Region('hz', '杭州', [Region('xh', '西湖区'), Region('yh', '余杭区')]),
    Region('nb', '宁波', [Region('yz', '鄞州区')]),
  ]),
  Region('js', '江苏', [
    Region('nj', '南京', [Region('xw', '玄武区')]),
  ]),
];

AntPickerColumn<_NamedOption> _optionColumn(List<_NamedOption> dataSource) =>
    AntPickerColumn<_NamedOption>(
      dataSource: dataSource,
      keyOf: (option) => option.id,
      labelBuilder: (context, option) => Text(option.name),
    );

// ── Picker 滚轮选择 ─────────────────────────────────────────
final List<_DemoCard> _pickerCards = [
  (
    '单列选择(自定义模型)',
    AntPicker<_NamedOption>(
      columns: [_optionColumn(_seasons)],
      title: '请选择季节',
      child: const _TriggerBox(text: '打开单列选择器'),
    ),
  ),
  (
    '多列选择(列间独立滚动)',
    AntPicker<_NamedOption>(
      columns: [_optionColumn(_seasons), _optionColumn(_fruits)],
      title: '选择季节与水果',
      child: const _TriggerBox(text: '打开多列选择器'),
    ),
  ),
];

/// 触发器入口(const 构造)。
class _TriggerBox extends StatelessWidget {
  const _TriggerBox({required this.text});

  final String text;

  @override
  Widget build(BuildContext context) => _triggerBox(context, text);
}

// ── DatePicker 日期(年月日) ────────────────────────────────
final List<_DemoCard> _datePickerCards = [
  (
    '基础(年月日)',
    AntDatePicker(
      defaultValue: DateTime(2026, 1, 1),
      onChange: (d) => debugPrint('date: $d'),
    ),
  ),
  ('允许清除', const AntDatePicker(allowClear: true, placeholder: '选择日期')),
  (
    '自定义展示(labelBuilder)',
    AntDatePicker(
      defaultValue: DateTime(2026, 1, 1),
      labelBuilder: (context, date) =>
          Text('${date.year} 年 ${date.month} 月 ${date.day} 日'),
    ),
  ),
];

// ── TimePicker 时间(时分秒) ────────────────────────────────
final List<_DemoCard> _timePickerCards = [
  (
    '时分秒选择',
    AntTimePicker(
      defaultValue: const TimeOfDay(hour: 9, minute: 30),
      onChange: (t) => debugPrint('time: $t'),
    ),
  ),
  ('步进(小时步进 2)', const AntTimePicker(hourStep: 2, placeholder: '选择时间')),
  (
    '自定义展示(labelBuilder)',
    AntTimePicker(
      defaultValue: const TimeOfDay(hour: 9, minute: 30),
      labelBuilder: (context, time) => Text('${time.hour} 时 ${time.minute} 分'),
    ),
  ),
];

// ── Cascader 级联 ───────────────────────────────────────────
final List<_DemoCard> _cascaderCards = [
  (
    '弹层级联选择(选中即变更)',
    AntCascader<Region>(
      dataSource: _regions,
      keyOf: (region) => region.code,
      childrenOf: (region) => region.children,
      disabledOf: (region) => region.disabled,
      labelBuilder: (context, region) => Text(region.name),
      placeholder: '请选择地区',
      changeOnSelect: true,
    ),
  ),
  (
    '禁用态',
    AntCascader<Region>(
      dataSource: _regions,
      keyOf: (region) => region.code,
      childrenOf: (region) => region.children,
      labelBuilder: (context, region) => Text(region.name),
      disabled: true,
    ),
  ),
];

// ── CascaderView 内嵌 ───────────────────────────────────────
final List<_DemoCard> _cascaderViewCards = [
  (
    '内嵌级联视图(不弹层)',
    AntCascaderView<Region>(
      dataSource: _regions,
      keyOf: (region) => region.code,
      childrenOf: (region) => region.children,
      labelBuilder: (context, region) => Text(region.name),
    ),
  ),
];

// ── 受控操作 ────────────────────────────────────────────────
class _ControlledSection {
  const _ControlledSection();

  List<_DemoCard> get cards => [
    ('AntPicker 受控(value + 重置)', _ControlledPickerCard()),
    ('Cascader / DatePicker 受控', _ControlledFieldCard()),
  ];
}

class _ControlledPickerCard extends StatefulWidget {
  const _ControlledPickerCard();

  @override
  State<_ControlledPickerCard> createState() => _ControlledPickerCardState();
}

class _ControlledPickerCardState extends State<_ControlledPickerCard> {
  List<_NamedOption> _pickerValue = <_NamedOption>[_seasons.first];

  @override
  Widget build(BuildContext context) {
    final theme = AntTheme.of(context);
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        AntPicker<_NamedOption>(
          columns: [_optionColumn(_seasons)],
          value: _pickerValue,
          onConfirm: (options) => setState(() => _pickerValue = options),
          child: _triggerBox(
            context,
            '当前:${_pickerValue.map((option) => option.name).join('、')}',
          ),
        ),
        SizedBox(height: theme.s(8)),
        OutlinedButton(
          onPressed: () =>
              setState(() => _pickerValue = <_NamedOption>[_seasons.first]),
          child: const Text('重置为「春」'),
        ),
      ],
    );
  }
}

class _ControlledFieldCard extends StatefulWidget {
  const _ControlledFieldCard();

  @override
  State<_ControlledFieldCard> createState() => _ControlledFieldCardState();
}

class _ControlledFieldCardState extends State<_ControlledFieldCard> {
  List<Region> _cascaderValue = <Region>[];
  DateTime? _dateValue;

  @override
  Widget build(BuildContext context) {
    final theme = AntTheme.of(context);
    return Column(
      crossAxisAlignment: CrossAxisAlignment.start,
      children: [
        AntCascader<Region>(
          dataSource: _regions,
          keyOf: (region) => region.code,
          childrenOf: (region) => region.children,
          labelBuilder: (context, region) => Text(region.name),
          value: _cascaderValue.isEmpty ? null : _cascaderValue,
          onChange: (regions) => setState(() => _cascaderValue = regions),
        ),
        SizedBox(height: theme.s(8)),
        _resultText(
          context,
          '级联值',
          _cascaderValue.map((region) => region.name).join(' / '),
        ),
        SizedBox(height: theme.s(12)),
        AntDatePicker(
          value: _dateValue,
          placeholder: '受控日期',
          onChange: (d) => setState(() => _dateValue = d),
        ),
        SizedBox(height: theme.s(8)),
        _resultText(context, '日期值', _dateValue?.toIso8601String() ?? ''),
        SizedBox(height: theme.s(8)),
        OutlinedButton(
          onPressed: () => setState(() => _dateValue = null),
          child: const Text('清空日期'),
        ),
      ],
    );
  }
}
0
likes
160
points
--
downloads

Documentation

API reference

Publisher

unverified uploader

Ant Design picker, cascader, date and time pickers for Flutter, with wheel columns and antd-mobile v5 interaction.

Homepage
Repository (GitHub)
View/report issues

Topics

#ui #components #design-system #ant-design #picker

License

MIT (license)

Dependencies

antd_flutter_ui, antd_icons_flutter, antd_theme, cupertino_ui, flutter, material_ui

More

Packages that depend on antd_picker