dropdown_search

New Feature:

• Add adaptive platform Ui feature: Material, Cupertino and Adaptive

• Add autocomplete new popup mode

• add transitionBuilder, transitionDuration, reverseTransitionDuration to menuProps

    transitionDuration: Duration(milliseconds: 500),
    transitionBuilder: (context, animation, secondaryAnimation, child) {
      return SlideTransition(
        position: Tween<Offset>(
          begin: const Offset(1, 0),
          end: Offset.zero,
        ).animate(animation),
        child: child,
      );
    }
  

• add new property animationBuilder to DropdownButtonProps, examples of uses

   /* Example 1: animation with only one icon ("iconClosed") like rotation */
   animationBuilder: (child, isOpen) {
     return AnimatedRotation(
       turns: isOpen ? .5 : 0,
       duration: Duration(milliseconds: 400),
       child: child,
     );
   }

  /* Example 2 : animation with two icons like switch */
  dropdownButtonProps: DropdownButtonProps(
    iconClosed: Icon(Icons.arrow_drop_down),
    iconOpened: Icon(Icons.arrow_drop_up),
    animationBuilder: (child, isOpen) {
      return AnimatedSwitcher(
        switchOutCurve: Curves.easeIn,
        switchInCurve: Curves.easeIn,
        duration: Duration(milliseconds: 400),
        child: child,
      );
    },
  )

• add new property layoutDelegate to MenuProps and CupertinoMenuProps, you can extend SingleChildLayoutDelegate to create your own positioning strategy

  example of use

    layoutDelegate: (context, padding, position) => _PopupMenuRouteLayout(context, position)
  
    class _PopupMenuRouteLayout extends SingleChildLayoutDelegate {
      final RelativeRect position;
      final BuildContext context;
  
      const _PopupMenuRouteLayout(this.context, this.position);
  
    @override
    BoxConstraints getConstraintsForChild(BoxConstraints constraints) {
      // pick any properties from the context to calculate proper constraints
      final mediaQuery = MediaQuery.of(context);
      final keyBoardHeight = mediaQuery.viewInsets.bottom;
      final safeArea = mediaQuery.padding;
  
      return BoxConstraints(/* calculate new constraints based on your needs */);
    }
  
      @override
      Offset getPositionForChild(Size size, Size childSize) {
        // The position where the child should be placed.
      }
  
      @override
      bool shouldRelayout(covariant SingleChildLayoutDelegate oldDelegate) => false;
    }
  

• add SuggestionsProps to popupProps

• add builder property for SuggestionsProps to override the hole suggestion widget

• add properties to scrollView and wrap widget for selected items in multiSelection mode

• Chips are fully customizable in multiSelection and suggestions

• replace padding in searchFieldProps with containerBuilder

• add onDisplayed callback to popupProps

• add errorBuilder for InfiniteScrollProps

• add possibility to reload item using myGlobalKey.currentState?.reloadItems(String filter) or myGlobalKey.currentState?.loadMoreItems(String filter, int skip)

• add textProps to have the ability to pass default text props through the context to selectedItem

• add new property for TextFieldProps

• add the ability to listen to focus changes using onFocusChange

• add new callbacks onBeforeClear and onClear to handle dropdown clear button action

Breaking changes

• change onChanged to onSelected
• PopupPropsMultiSelection changed to MultiSelectionPopupProps
• suggestedItemsProps is placed inside SuggestionsProps
• Semantics is removed from searchBox, to add it use containerBuilder like this you have full access to Semantic properties.

Fix bugs:

• BottomSheet background color 726

New Feature:

• add Semantics to searchBox to support voiceOver/TalkBack ...

Fix bugs:

• duplicated GlobalKey issue 672
• multiSelection chips height issue 602
• hint and dropdownBuilder issue 515

New features:

• infinite list / lazy loading
• add click properties to the dropdown
• add custom mode
• dropdown button can be changed depending on state (opened/closed)
• add property cacheItems for popupProps
• add property onItemLoaded
• adding new properties for a lot of widget (scrollBar, modal, bottomSheet,...)
• add to possibility to change position of clearButton and dropdownButton using direction property

Breaking changes :

• AsyncItems and items are replaced by items:(filter, infiniteScrollProps)
• Add isDisabled to itemBuilder params
• FavoriteItems renamed to SuggestedItems
• isFilterOnline renamed to disableFilter
• selectionWidget renamed to checkBoxBuilder
• dropdownDecoratorProps renamed to decoratorProps
• clearButtonProps and dropdownButtonProps are placed to suffixProps

Fix bugs:

• Search delay issue 542,
• Multiselection triggers didChange issue 668,
• ModalBottomSheet Keyboard issue 650,
• ScrollBar padding top issue 512
• Disabled color issue 553
• MultiSelection overflow issue 526
• Popup does not close after dropdown dispose issue 554
• Suffix space issue 670

Fix bugs

• 542
• 485

fix lint errors

add 'textDirection' in multiSelection mode to handle checkbox alignment

add useSafeArea for modal

[5.0.5] - 2022.12.05

Fix analysis warning and formatting issues

Breaking changes:

• onFind to AsyncItem
• isFilteredOnline to isFilterOnline
• replace all popup customization with popupProps
• change default mode to MENU
• remove 'dropdownBuilderSupportsNullItem' because now we support nullSafety
• remove safeArea settings, the popup should always shown in safeArea

update readme.md

improve menu mode

improve dialog mode

fix large text in chips in multiSelection mode

fix bug 84

add new mode BOTTOM_SHEET

support Flutter v3

• remove hint and label properties, use dropdownSearchDecoration instead
• remove showAsSuffixIcons property, now always are as suffixIcon
• replace 'clearButtonSplashRadius' and 'clearButtonBuilder' into one property 'IconButtonProps'
• replace 'dropdownButtonSplashRadius' and 'dropdownButtonBuilder' into one property ' IconButtonProps'

• searchBoxDecoration removed: replaced by searchFieldProps _ autoFocusSearchBox removed : replaced by searchFieldProps _ searchBoxStyle removed : replaced by searchFieldProps _ searchBoxController removed : replaced by searchFieldProps

  - showSelectedItem replaced by showSelectedItems