react-native-sectioned-multi-select

# Changelog ## 0.10.0 - 2023-05-11 ### Fixed - Add Various Accessibility Properties #290 - adds rolls and accessibility states for selected state, expanded state - readme fixes #275, #287 ## 0.9.1 - 2022-01-09 ### Fixed - remove accidental console log #259 ## 0.9.0 - 2021-12-17 ### Fixed - Changed the way styles and colors are recalculated. Style/color prop changes will now correctly reflect to sub items. This isn't a breaking change per se but it will cause different results to previous versions when changing styles/colors dynamically. ## 0.8.4 - 2021-12-14 ### Fixed - More type related fixes - IconRenderer prop should have been required ## 0.8.3 - 2021-12-14 ### Fixed - more type related fixes ### Added - added exampleapp version using typescript with ItemType generic and ref methods ### Fixed ## 0.8.2 - 2021-12-13 ### Added - onChangeSearchText event #210 ### Fixed - Various types fixes - all props that return components are now `ReactNode`. #253 - `icons` individual icon objects are now optional and allow any extra properties you wish to be added to your icon component. #253 #232 - added types for some useful internal methods. - Fix TypeError: undefined is not an object (evaluating 'item[subKey]') with unpopulated items. #237 ## 0.8.1 - 2020-11-03 ### Fixed - React Native's UIManager.setLayoutAnimationEnabledExperimental causing tests fail. This version has fix for it. \n Details: ```sh TypeError: _reactNative.UIManager.setLayoutAnimationEnabledExperimental is not a function ``` ## 0.8.0 - 2020-10-01 ### Fixed - 0.7.8 introduced a bug with an attempted fix of the iconRenderer. This update addresses that and icons in general. ### Added - the `icons` prop is an object that maps the names and sizes used for the icons (all properties are spread onto the `IconRenderer`). In conjunction with `IconRenderer` you can now easily switch out the icon library. See Icons section of Readme. ### Changed - BREAKING: `IconRenderer` is now required (also note the casing change). The lib no longer depends on `react-native-vector-icons`. For the default Material Icons icon set, you must import Icon from `react-native-vector-icons/MaterialIcons` yourself, and pass that to the`IconRenderer` prop. See Icons section of Readme. ## 0.7.8 - 2020-09-25 ### Fixed - fix global icon assignment #203 - check for subkey here idk #173 - fix recipe #111 ## 0.7.7 - 2020-04-20 ### Fixed - types definition fixes ## 0.7.6 - 2019-12-05 ### Fixed - fixed chip padding when using `hideChipRemove` ## 0.7.5 - 2019-12-05 ### Added - added `hideChipRemove` boolean prop to hide chips' remove (x) touchable #150 ## 0.7.4 - 2019-12-05 ### Added - added type definitions file #63 ## 0.7.3 - 2019-11-28 ### Fixed - remove `ScrollView` that wraps the `FlatList` #151 (the style prop remains as scrollView for now but the element is a View) ## 0.7.2 - 2019-10-14 ### Fixed - remove deprecated `componentWillReceiveProps` #147 - fix subitem `iconRenderer` usage #142 ## 0.7.1 - 2019-08-01 ### Added - added `itemsFlatListProps` and `subItemsFlatListProps` to be able to pass in custom FlatList props object ## 0.7.0 - 2019-06-25 ### Fixed - fixed regression with backdrop / SafeAreaView. Styles: `modalWrapper` wraps the modal and `backdrop` is the backdrop view inside it. ### Added - Added `iconRenderer` prop. Material Icons is no longer required to be installed fo the lib to work. You can pass `iconRenderer` your own icon component function. - Added Recipes doc with more details customization examples. ### Changed - Made readme example more concise - cleand up example app style ## 0.6.7 - 2019-05-2 ### Fixed - fixed bug with backdropView + `modalWithTouchable` taking touches from select list. - fixed a couple of cases where items didn't update / future proofed chip remove working inside modal ## 0.6.6 - 2019-05-1 ### Added - added `parentChipsRemoveChildren` boolean prop. If true, pressing a parent chip's remove button will remove all of its selected children. - added `parentChipContainer` and `parentChipText` to styles, so you can style parent item chips differently. - added `selectedIconOnLeft` boolean prop. If true, selected icons show to the left of the text. #104 - added `selectedSubItem` to styles ## 0.6.5 - 2019-02-19 ### Added - added `unselectedIconComponent` #93 ## 0.6.4 - 2019-01-17 ### Added - added ability to show an icon before the item text #87. Use prop `iconKey`, then add the key to your item as either a string (to show a material icons `Icon` component by `name`), object (to show an image e.g {uri: 'imageUrl' }, or a number (that is returned from require('./localimage.png') )). use style key `itemIconStyle` to style the Icon / Image - added `autoFocus` prop (bool) #86, to autofocus the search input when the modal is opened. ## 0.6.3 - 2018-11-27 ### Added - Add `modalWithTouchable` prop. Set to true to wrap the backdrop in a `TouchableWithoutFeedback`, which will close the selector (also fires `onToggleSelector(false)`) #76 ## 0.6.1 - 2018-10-23 ### Fixed - properly escape regex special chars for test in filter function #64 ### Added - Add `hideConfirm` prop - hides the confirm button from the modal #62 - Add `stickyFooterComponent` shows below the confirm button (but, unlike `footerComponent`, outside of the scroll view so it's always visible) - Add `chipsPosition` to position the chips above or below the select. Sstring, either 'top' or 'bottom' #56 - Add `customChipsRenderer` function. receives all props. #56 - Add `modalSafeAreaView` prop. Set to true to use a `SafeAreaView` instead of a `View` as the backdrop inside the `Modal`. ## 0.6.0 - 2018-10-02 ### Fixed - prevent crash when pressing select toggle rapidly - fix formatting of this document ### Added - Add `onToggleSelector` callback function #48 - Add `noItemsComponent` to be shown when there are no items - Add `loading` boolean prop for loading state ### Changed - Change `loadingComponent` to be shown when `loading` prop is true (previously was shown when items were empty) ## 0.5.2 - 2018-07-10 ### Fixed - Added `keyboardShouldPersistTaps` props where needed ### Added - Add `selectedItemText` and `selectedSubItemText` styles (previously only the parent view style was editable when selected). ## 0.5.1 - 2018-06-29 ### Added - Add `chipRemoveIconComponent`, this icon wasn't user replaceable before. - Add `filterItems` function prop. It will replace the filter used for searching. parameters are `searchTerm`, `items`, `props`. You need to return an array of item objects. (example in `exampleapp/App.js`). ## 0.5.0 - 2018-06-12 ### Added - Add `expandDropDowns` prop. Set to true to expand all parent dropdowns (when using `showDropDowns`). - Add `animateDropDowns` prop. Set to false to not use LayoutAnimation when toggling the dropdowns. - Add `customLayoutAnimation` prop. Use your own LayoutAnimation preset or custom layout animation object for the toggling of dropdowns. - Add `selectLabelNumberOfLines` prop. - Add `renderSelectText` function that receives props. This allows you to fully customize what the select label says and when, overriding `selectText`, `selectedText` etc. ### Changed - `numberOfLines` is now `itemNumberOfLines`, to avoid confusion. - There were serious perf issues for things like toggling dropdowns with larger lists. To mitigate this, the sub items have been moved inside of the parent items and some functions have been rafactored or moved. The only noticeable difference should be that the parent item's `itemSeparator` shows at the bottom of the group of items, rather than always being directly below the parent item. ### Fixed - Cast keyExtractor ids to string #31 - Should be generally faster... ## 0.4.7 - 2018-05-07 ### Changed - Removed lodash dependency: replaced get and reject functions with internal functions. ## 0.4.4 - 2018-04-13 ### Added - `alwaysShowSelectText` prop - if true the select label won't show the amount selected + `selectedText` or the name of the selected item if only one items is selected. Not applied when `single` is true as single shows the `dispayKey` on the select label only. #23 - `searchAdornment` prop - function that receives the text of the search input, and is output on the right hand side of the search input. Useful if you need to do something with the search text like add a new item. ## 0.4.2 - 2018-03-29 ### Fixed / Added - disabled items - sub item Touchable wasn't being disabled when a truthy disabled key is present - make item text colors.disabled when item has truthy disabled key ## 0.4.1 - 2018-03-26 ### Fixed - cancel / confirm buttons not displaying properly on iOS. Cancel takes a fixed width instead of a flex ratio now. #19 ## 0.4.0 - 2018-03-23 ### Added - Cancel button #15 - shows on the modal to the left of the confirm button. Pressing it dismisses the modal AND removes all selected items. - show with `showCancelButton` prop. - `cancelButton` style and `cancelIconComponent` are available. (It is a 'close' icon by default, but you could make it a text component if you want). - Hide select #16 - hide the select entirely with `hideSelect` prop. - Display key #14 - customize the title key with `displayKey` prop, instaed of being forced to use 'name'. - Added `headerComponent` prop - goes above search bar #17 - Added `onCancel` and `onConfirm` function props ### Changed - `SelectedText` now allowed to be a function, for more complex translations/ ## 0.3.5 - 2018-03-08 ### Added - customizable `selectedText` string (defaults to 'selected'). #13 ## 0.3.4 - 2018-02-14 ### Fixed - fixed `onSelectedItemObjectsChange` for single select mode #9 ## 0.3.3 - 2018-01-30 ### Added - Added `numberOfLines` prop, so long labels can be truncated (defaults to null - no truncation). ### Changed - add flex to label text so checkmark is visible for long items ## 0.3.2 - 2018-01-18 ### Changed - Make remove all chip use chipColor ## 0.3.1 - 2018-01-17 ### Changed - Add changelog to Readme ## 0.3.0 - 2018-01-16 ### Added - disabled color. When highlightChildren is true, the child checkmarks become the disabled color - highlighted children TouchableOpacity disabled. You can't / it doesn't make sense to cherry pick sub items in this mode - Custom component for no results text - `noResultsComponent` - More customizable than a string. - custom component for loading - `loadingComponent` - display an ActivityIndicator (default) component when items are empty / undefined - Custom components for icons - `selectToggleIconComponent` - The icon to the right of the dropdown in its initial state (Default arrow down) - `searchIconComponent` - The search input icon (default Magnifying glass) - `selectedIconComponent` - The icon to the left of the selected item (default Checkmark) - `dropDownToggleIconUpComponent` - The parent dropdown icon in closed state - `dropDownToggleIconDownComponent` - The parent dropdown icon in opened state - Select all child ids when a parent is selected - `selectChildren` - boolean - Highlight (but don't broadcast to state) all child ids when a parent is selected - `highlightChildren` - boolean - ### Removed - Removed No results text string in favour of a component (object) to allow for more customization. - removed / streamlined fonts ### Changed - Moved row item and sub item to separate classes, in order to enhance performance for long lists. Use `shouldComponentUpdate` to not re-render every item on toggle. - moved RowItem and SubRowItem into separate files ### Fixed - fixed `reduceSelected` function - rejecting children works properly now - Erroneously used `item.id` instead of `item[uniqueKey]` ## [0.2.0] - 2017-12-06 ### Added - `hideSearch` Prop to hide search bar entirely ## [0.1.2] - 2017-11-29 ### Added - Style for sub item separator ## [0.1.1] - 2017-11-22 ### Added - Props for Modal animation and orientation ## [0.1.0] - 2017-11-22 ### Added - Init