搜尋套件、儲存庫與 APP 分類

datepicker_dropdown 封面
套件詳情v1.0.2

datepicker_dropdown

一個可自定義選項的 Flutter 下拉日期選擇器。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
1190
喜歡數
48
Pub 分數
160

安裝套件

flutter pub add datepicker_dropdown

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

一個 Flutter 套件,提供可自訂選項的下拉式日期選擇器,用於選擇日期。它能無縫整合至表單與介面中,以緊湊且使用者友善的方式選擇日期,而無需開啟完整的日曆對話方塊。支援多個平台,包括 Android、iOS、Web、macOS、Windows 和 Linux。此組件輕量級,專為尋求簡單、易存取之標準日期選擇器替代方案的開發者設計。自訂功能包含樣式、日期格式與選擇行為。

適用情境

  • 需要日期選擇的表單輸入
  • 輕量級日期輸入,適用於行動和網頁應用
  • 在受限的UI空間中可自定義的日期選擇器
  • 將日期選擇整合到下拉選單中
  • 面向可存取性的日期輸入元件

主要特色

  • 基於下拉框的日期選擇
  • 跨平台相容性
  • 可自訂的外觀與行為
  • 支援多種日期格式
  • 與現有表單的輕鬆整合
  • 所需的樣板程式碼最少

適合對象

  • 需要緊湊型日期選擇器的開發者
  • UI 上有空間限制的專案
  • 針對多個平台的應用程式
  • 重視可存取性的團隊
  • 需要一致日期輸入設計的 UI

使用建議

  • 僅限單日期選擇
  • 無內建驗證
  • 需要手動處理日期解析
  • 不適用於複雜日期範圍
  • 與完整日曆選擇器相比,視覺反饋較少

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

Date Picker Dropdown

pub package

A customizable dropdown date picker for Flutter with support for multiple field orders, validation, localization, and form-friendly callbacks.

Web demo: datepicker.robertrobinson.in

Features

  • Day, month, and year dropdowns with configurable order
  • Optional form validation for each field
  • Locale-specific month labels
  • Configurable year range, spacing, flex, styles, and decorations
  • Safe handling of invalid date combinations such as 31 February
  • Controlled-widget support when the parent rebuilds with new selected values

Main View Month View Date View Year View

Getting Started

Add the package to your pubspec.yaml:

dependencies:
  datepicker_dropdown: ^1.0.2

Then run:

flutter pub get

Basic Usage

import 'package:datepicker_dropdown/datepicker_dropdown.dart';
import 'package:datepicker_dropdown/order_format.dart';
import 'package:flutter/material.dart';

class BirthDateField extends StatefulWidget {
  const BirthDateField({super.key});

  @override
  State<BirthDateField> createState() => _BirthDateFieldState();
}

class _BirthDateFieldState extends State<BirthDateField> {
  int? _day;
  int? _month;
  int? _year;

  @override
  Widget build(BuildContext context) {
    return DropdownDatePicker(
      dateFormatOrder: OrderFormat.ydm,
      startYear: 1900,
      endYear: DateTime.now().year,
      selectedDay: _day,
      selectedMonth: _month,
      selectedYear: _year,
      onChangedDay: (String? value) {
        setState(() {
          _day = int.tryParse(value ?? '');
        });
      },
      onChangedMonth: (String? value) {
        setState(() {
          _month = int.tryParse(value ?? '');
        });
      },
      onChangedYear: (String? value) {
        setState(() {
          _year = int.tryParse(value ?? '');
        });
      },
    );
  }
}

Form Example

DropdownDatePicker(
  dateFormatOrder: OrderFormat.mdy,
  isFormValidator: true,
  isDropdownHideUnderline: true,
  startYear: 1900,
  endYear: 2025,
  hintDay: 'Day',
  hintMonth: 'Month',
  hintYear: 'Year',
  inputDecoration: InputDecoration(
    enabledBorder: const OutlineInputBorder(),
    border: OutlineInputBorder(
      borderRadius: BorderRadius.circular(10),
    ),
    contentPadding: const EdgeInsets.symmetric(horizontal: 12),
  ),
  onChangedDay: (String? value) {
    debugPrint('day: $value');
  },
  onChangedMonth: (String? value) {
    debugPrint('month: $value');
  },
  onChangedYear: (String? value) {
    debugPrint('year: $value');
  },
)

Notes

  • dateFormatOrder is the preferred property name.
  • dateformatorder is still supported as a deprecated backwards-compatible alias.
  • If the current day becomes invalid after a month or year change, the widget automatically adjusts it to the last valid day and notifies onChangedDay.
  • The widget syncs correctly when the parent rebuilds with new selectedDay, selectedMonth, or selectedYear values.

Supported Locales

en, en_abbv, num, ar, de_DE, el_GR, es_ES, fr_FR, gu_IN, hi_IN, id_ID, it_IT, ja, kn_IN, ko_KR, ml_IN, mr_IN, nl_NL, pl_PL, pt_BR, ru_RU, sv_SE, ta_IN, te_IN, th, tr, vi, zh_CN

Example App

See the example app in example/lib/main.dart for a complete integration.

Repository

Source code: github.com/Robertrobinson777/dropdown_date_picker

Support

Buy Me A Coffee

所屬分類

原始碼儲存庫

使用此套件的專案

暫無相關資料。