1.0.4 • Published 6 months ago

multi-select-react-native v1.0.4

Weekly downloads
5
License
ISC
Repository
github
Last release
6 months ago

:warning: **This is not maintained anymore.. Sorry 😢

Multi Select React Native

A customizable react native component that lets you select multiple items.

Installation

Run

npm i multi-select-react-native

in your project directory.

Usage

This snippet would produce the output shown in the above gif

import * as React from "react";
import { View, StyleSheet } from "react-native";
import MultiSelect from "multi-select-react-native";
const DATA = [
  {
    id: "bd7acbea-c1b1-46c2-aed5-3ad53abb28ba",
    title: "First Item"
  },
  {
    id: 1,
    title: "Second Item"
  },
  {
    id: "1a",
    title: "Third Item"
  }
];

export default function App() {
  const [selectedItems, setSelectedItems] = React.useState([]);

  return (
    <View style={styles.container}>
      <MultiSelect
        data={DATA}
        selectedItems={selectedItems}
        setSelectedItems={setSelectedItems}
        componentStyle={styles.centeredView}
      />
    </View>
  );
}

const styles = StyleSheet.create({
  centeredView: {
    flex: 1,
    justifyContent: "center",
    alignItems: "center",
    marginTop: 22,
    fontSize: 20
  }
});

Props

PropsExplanationdefault value
highlightTo highlight the selected items with the tint color or notfalse
datathe data is an array of objects of id and title ex. {id:1,title:'first'}[]
textText of the buttonSelect Item
selectedItemsThe selected ids of items: must be a state to re-render every select[]
setSelectedItemsfunction that set the selected items
tintColorThe color of the selected itemsyellow
componentStyleThe style of the whole component
buttonStyleThe style of the select button
containerItemsStyleThe style of the container of the item in the menu
hasResetButtonIf it has a reset button or nottrue

Contributing

This component mean to be very customizable so feel free to add any issue here.