React Native Dropdown

Simple, customizable dropdown component for iOS and Android

Cross-Platform

Works seamlessly on both iOS and Android

Customizable

Fully customizable styling and behavior

Lightweight

Minimal bundle size with maximum performance

Quick Start

Get up and running in minutes with our simple React Native dropdown component.

npm install react-native-simple-dropdown

Features

Everything you need for a seamless dropdown experience

Cross-Platform Support

Built for both iOS and Android with native performance and consistent behavior across platforms.

Customizable Styling

Full control over colors, fonts, animations, and layout to match your app design perfectly.

Lightweight & Fast

Minimal bundle size with optimized performance for smooth scrolling and instant response.

TypeScript Support

Full TypeScript definitions included for better development experience and type safety.

Accessibility

Built with accessibility in mind, following WCAG guidelines for inclusive design.

Usage

Get started in minutes with our simple API

Step 1: Import

import Dropdown from 'react-native-simple-dropdown'

Step 2: Add to Component

{``}

Step 3: Customize

{``}

Basic Usage

Simple dropdown with default styling

{`const items = [
  { label: 'Option 1', value: '1' },
  { label: 'Option 2', value: '2' }
]`}

Man in black shirt using laptop computer and flat screen monitor

Advanced Usage

Custom styling and event handling

{` setSelected(item.value)}
/>`}

Installation

Get up and running in minutes with our simple setup

A computer desk with two monitors and a mouse

1. Install via NPM

npm install react-native-simple-dropdown

2. Install via Yarn

yarn add react-native-simple-dropdown

3. Import the component

import Dropdown from 'react-native-simple-dropdown'

Quick Setup

Zero configuration required. Works out of the box with your existing React Native project.

A close up of a keyboard with a computer screen in the background

System Requirements

Requires React Native 0.60+ and supports both iOS 11+ and Android 5.0+.

🚀

TypeScript Ready

Full TypeScript support with complete type definitions included.

Verify Installation

Test that everything is working correctly

Import Check

import Dropdown from 'react-native-simple-dropdown'

Usage Example

{` {}} />`}

Props

Complete API reference for all available props

Prop	Type	Default	Description
data	array	[]	Array of items to display
value	any	null	Currently selected value
onSelect	function	null	Callback when item selected
placeholder	string	"Select..."	Placeholder text
style	object	{}	Custom styles
disabled	boolean	false	Disable interaction

TypeScript Support

Full IntelliSense support with complete type definitions.

Female software engineer codes at her desk with computers

Event Props

Handle user interactions with callback functions.

Style Props

Customize appearance with style objects.

Quick Reference

Required Props

• data (array)
• onSelect (function)

Optional Props

• value
• placeholder
• style
• disabled

Examples

See real-world implementations in action

Basic Dropdown

Simple dropdown with default styling

{``}

Styled Dropdown

Dropdown with custom colors and borders

{``}

Multi-Select

Dropdown with multiple selection enabled

{``}

Complete Example

{`import React, { useState } from 'react'
import { View } from 'react-native'
import Dropdown from 'react-native-simple-dropdown'

const App = () => {
  const [language, setLanguage] = useState(null)
  
  const languages = [
    { label: 'JavaScript', value: 'js' },
    { label: 'TypeScript', value: 'ts' },
    { label: 'Python', value: 'py' }
  ]

  return (
    
      
    
  )
}`}

Customization

Make it yours with endless styling options

Colors & Themes

Customize every color to match your brand

{`colors: {
  primary: '#3B82F6',
  background: '#FFFFFF',
  border: '#E5E7EB'
}`}

Typography

Full control over fonts and text styling

{`fonts: {
  size: 16,
  family: 'System',
  weight: '500'
}`}

Layout & Spacing

Adjust padding, margins, and border radius

{`layout: {
  padding: 12,
  borderRadius: 8,
  height: 48
}`}

Style Object

{`const customStyles = {
  container: {
    backgroundColor: '#FFFFFF',
    borderRadius: 12,
    borderWidth: 1,
    borderColor: '#E5E7EB',
    paddingHorizontal: 16,
    height: 50,
  },
  text: {
    fontSize: 16,
    color: '#111827',
    fontWeight: '500',
  },
  dropdown: {
    backgroundColor: '#FFFFFF',
    borderRadius: 12,
    borderWidth: 1,
    borderColor: '#E5E7EB',
    marginTop: 4,
  },
  item: {
    paddingHorizontal: 16,
    paddingVertical: 12,
  },
  selectedItem: {
    backgroundColor: '#F3F4F6',
  },
  disabled: {
    opacity: 0.5,
  },
}`}

Animation Options

• Duration: 150-300ms
• Easing: ease-in-out
• Scale animation
• Fade in/out effects

Icons & Images

• Custom dropdown icons
• Item icons support
• Image placeholders
• Custom checkmarks

Responsive Design

• Auto-adjust for screen size
• Platform-specific styles
• Dynamic font scaling
• Touch-friendly sizing