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

cool_dropdown 封面
套件詳情v2.1.1

cool_dropdown

可自訂的冷酷下拉式 UI,您可以自訂選取項目、下拉方塊的 BoxDecoration,以及下拉輸入。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
1540
喜歡數
209
Pub 分數
150

安裝套件

flutter pub add cool_dropdown

套件介紹

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

一個可自訂的下拉式 UI 元件,適用於 Flutter,讓開發者能客製化選取項目、下拉框的 BoxDecoration 及輸入欄位的外觀。支援多個平台,包括 Android、iOS、Web、macOS、Windows 與 Linux。此套件透過平滑的動畫與彈性的樣式選項,提升使用者體驗,非常適合用於表單與選擇介面。以簡潔與客製化為設計核心,能順暢整合至現有的 Flutter 專案中。

適用情境

  • 具有自定下拉選單的表單輸入
  • 使用者偏好選擇器
  • 動態選項選擇器
  • 行動與網頁介面增強
  • 可自定義的 UI 組件

主要特色

  • 可自訂的選取項目樣式
  • 可設定的 BoxDecoration 用於下拉選單
  • 可擴充的輸入欄位設計
  • 跨平台相容性
  • 平滑的動畫過渡
  • 與 Flutter 表單輕鬆整合

適合對象

  • 尋求樣式化下拉選單的開發者
  • 需要跨平台一致 UI 的專案
  • 具有複雜表單互動的應用程式
  • 注重設計的 Flutter 應用程式
  • 重視客製化與彈性化的團隊

使用建議

  • 需要理解 BoxDecoration 和 Flutter 佈局
  • 可能需要額外的樣式來處理邊緣情況
  • 有限的內建驗證
  • 最適合簡單到中等複雜度的下拉選項需求

原始 README

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

Cool drop down

pub package version

Features

  • All customizable style(font, fontsize. color, icon, result, dropdown decoration...).

  • Auto scroll to selected item position.

  • Dropdown is automatically placed. It's based on the position of the result on the screen(top/bottom).

  • Marquee effect.

  • Customizable animation.

  • Error handling.

  • "COOL"

Samples

Installing

command:

 $ flutter pub add cool_dropdown

pubspec.yaml:

dependencies:
  cool_dropdown: ^(latest)

Cool Dropdown options

Option Type Default Description
dropdownList List<CoolDropdownItem> [] Dropdown item list.
defaultItem CoolDropdownItem? null Default item of the dropdown.
onChange Function(T) required When user selects one of the items, you will get T type value.
onOpen Function(bool) null When user either open or close the dropdown, you will get bool value.
resultOptions ResultOptions -
dropdownOptions DropdownOptions - Check below.
dropdownItemOptions DropdownItemOptions - Check below.
dropdownTriangleOptions DropdownTriangleOptions - Check below.
dropdownController DropdownController required Check below.

Result Options(result<v1.3.0> -> ResultOptions<v.2.0.0>)

Option Type Default Description
width double 220
height double 50
space double 10 Space between (label + icon) and arrow icon.
padding EdgeInsets EdgeInsets.zero
alignment Alignment Alignment.center Alignment of (label + icon).
render ResultRender ResultRender.all Set the order of the result elements to render.
boxDecoration BoxDecoration BoxDecoration of the result box.
openBoxDecoration BoxDecoration BoxDecoration of when result box is open.
errorBoxDecoration BoxDecoration BoxDecoration of when result box is on error.
textStyle TextStyle TextStyle of the label in result box.
placeholderTextStyle TextStyle TextStyle of the placeholder in result box.
textOverflow TextOverFlow TextOverflow of the label in result box.
isMarquee bool false A marquee effect when the label overflows.
duration Duration Duration(milliseconds: 300) When dropdown value is changed.
marqueeDuration Duration Duration(milliseconds: 6000) Duration of the marquee effect
backDuration Duration Duration(milliseconds: 800) Reverse animation duration of the marquee effect
pauseDuration Duration Duration(milliseconds: 800) Pause duration after marquee effect.

Dropdown Options(dropdown<v1.3.0> -> dropdownOptions<v2.0.0>)

Option Type Default Description
width double? result width Dropdown width.
height double 50 Dropdown height.
top double 0 Top position of the dropdown.
left double 0 Left position of the dropdown.
color Color Colors.white Dropdown color.
borderRadius BorderRadius BorderRadius.all(Radius.circular(10)) BorderRadius of the dropdown.
shadow List [] BoxShadow list of the dropdown.
animationType DropdownAnimationType DropdownAnimationType.scale Animation type of the dropdown.
align DropdownAlign DropdownAlign.center The alignment of the dropdown. If the dropdown and result box are different sizes, the dropdown will be aligned to the result box.
align SelectedItemAlign SelectedItemAlign.center The scroll alignment of the selected item in the dropdown.
gap DropdownGap DropdownGap.zero The gap between the dropdown and dropdown items.
padding EdgeInsets EdgeInsets.zero
duration Duration Duration(milliseconds: 300) Duration of the dropdown scroll animation.
curve Curve Curves.easeInOut Curve of the dropdown scroll animation.

Dropdown Item Options(new)

Option Type Default Description
height double 50 Dropdown item height.
padding EdgeInsets EdgeInsets.symmetric(horizontal: 10) Padding of the dropdown item.
alignment Alignment Alignment.centerLeft Vertical alignment of the dropdown item.
mainAxisAlignment MainAxisAlignment MainAxisAlignment.start Horizontal alignment of the dropdown item(label + icon).
render DropdownItemRender DropdownItemRender.all Set the order of the dropdown item elements to render.
boxDecoration BoxDecoration BoxDecoration of the result box.
selectedBoxDecoration BoxDecoration BoxDecoration of when dropdown item is selected.
textStyle TextStyle TextStyle of the label in dropdown item.
selectedTextStyle TextStyle Selected TextStyle of the label in dropdown item.
textOverflow TextOverFlow TextOverflow of the label in dropdown item.
isMarquee bool false A marquee effect when the label overflows.
duration Duration Duration(milliseconds: 300) When dropdown value is changed.
marqueeDuration Duration Duration(milliseconds: 6000) Duration of the marquee effect
backDuration Duration Duration(milliseconds: 800) Reverse animation duration of the marquee effect
pauseDuration Duration Duration(milliseconds: 800) Pause duration after marquee effect.

Dropdown triangle options(new)

Option Type Default Description
width double 10 Triangle width of the dropdown.
height double 10 Triangle height of the dropdown.
left double 0 Left position of the triangle.
borderRadius BorderRadius 0 BorderRadius of the triangle.
align DropdownTriangleAlign DropdownTriangleAlign.center Alignment of the triangle on the dropdown.

Dropdown Controller(new)

Option Type Default Description
duration Duration Duration(milliseconds: 500) Dropdown staggered animation duration.
errorDuration Duration Duration(milliseconds: 500) Result box decoration error animation duration.
resultArrowInterval Interval Interval(0.0, 0.5, curve: Curves.easeOut) Result arrow animation interval.
resultBoxInterval Interval Interval(0.0, 0.5, curve: Curves.easeOut) Result box animation interval.
showDropdownInterval Interval Interval(0.5, 1.0, curve: Curves.easeOut) Show dropdown animation interval.
showErrorCurve Curve Curves.easeIn Show error animation curve.
open method - Open the dropdown.
close method - Close the dropdown.
error method - Occur an error of the dropdown.
resetError method - Reset an error of the dropdown.
resetValue method - Reset the value of the dropdown.

所屬分類

原始碼儲存庫

使用此套件的專案