expo-images-picker

Multiple Asset Photos | Videos selecting package for Expo SDK 41+. For users who use React native and managed workflow + Styled Components.

MediaLibrary.

Image-manipulator.

Permissions

styled-components

Best Practice

Simple How to Video => https://youtu.be/xcMcVZTw6xA

Demo Snack => https://snack.expo.io/@natysoz/expo-images-picker-example

Features

• Permission requests built in.
• Getting Multi Assets from the device.
• Support Both landscape and portrait.
• Simple Indicator for the selected Assets.
• Custom Indicator for the selected Assets.
• Using custom navbar component.
• Allow selecting multiply Photos or Videos.
• Optimized , using react hooks , memo and callback to fully optimize performances.

Usage

1. Install with

   $ npm install --save expo-images-picker

   or

   $ yarn add expo-images-picker

2. import to the top of your file like

   import { AssetsSelector } from 'expo-images-picker'

3. install @expo-vectors package and send icons as props to the widget

   import { Ionicons } from '@expo/vector-icons'

4. Use the imported as Following =>

   <AssetsSelector
       options={{
           /* Add only when u want to Manipulate Assets.
             manipulate: {
             width: 512,
             compress: 0.7,
             base64: false,
             saveTo: 'jpeg',
           },*/
           assetsType: ['photo', 'video'],
           maxSelections: 5,
           margin: 3,
           portraitCols: 4,
           landscapeCols: 5,
           widgetWidth: 100,
           widgetBgColor: bgColor,
           selectedBgColor: mainColor,
           spinnerColor: mainColor,
           videoIcon: {
               Component: Ionicons,
               iconName: 'ios-videocam',
               color: 'white',
               size: 20,
           },
           selectedIcon: {
               Component: Ionicons,
               iconName: 'ios-checkmark-circle-outline',
               color: 'white',
               bg: 'white',
               size: 20,
           },
           defaultTopNavigator: {
               selectedText: 'Selected',
               continueText: 'Finish',
               goBackText: 'Back',
               midTextColor: 'red',
               buttonStyle: validViewStyleObject,
               textStyle: validTextStyleObject,
               backFunction: goBack,
               doneFunction: (data) => onDone(data),
           },
           noAssets: CustomNoAssetsComponent,
       }}
   />

##[📚 Params]

Options:

• assetsType Could be 'video' , 'photo' or an array with both ['photo','video'].

• maxSelections Maximum number of assets selection.

• margin Margin the Grid items by Pxs.

• portraitCols Number of columns in portrait Mode.by default 4.

• landscapeCols Number of columns in landscape Mode, by default 6.

• widgetWidth Widget container width , by default 100.

• widgetBgColor Widget background color expect to get Hex color.

• spinnerColor Loading spinner color.

---

• You can Resize , Compress and Base64 your assets with the following

  **Note that using manipulate might result with crash or slow loading times on older phones.

manipulate works only with "photo" Assets.

• width Manipulate image width (optional).

• height Manipulate image height (optional).

• compress Compress 0.1 Super low quality 1.0 leave as is (high quality).

• base64 Will add an extra field on response with an image as Base64 string.

• saveTo Manipulate File extension , can be "jpeg" or "png".

• * All fields are optional , in order to resize and keep images Ratio its recommend sending only width or height, and it will resize using this axis only.

---

---

selectedIcon

• Component Send in the Library you want to use ,Like Ionicons.
• iconName Send in the name property for the icon, Like 'ios-checkmark-circle-outline'.
• color Send in the color property for the icon,Like white.
• bg The Fill color of selected component, Like #ffffff50.
• size Send in the size property for the icon, Like 22.

---

• You can control the colors , texts of the default nav with the following:

defaultTopNavigator

• continueText Text for next Button , by default Continue.
• goBackText Text for Back Button , by default Back.
• midTextColor Middle text override color default as black.
• buttonTextStyle Text Style Object , design the text inside the buttons.
• buttonStyle View Style Object, design the button itself.
• backFunction Send in a function to go back to your screen.
• doneFunction Send in a function to go back and send the returned data.

---

noAssets:

• Component Send your custom Component that display no assets .

---

CustomTopNavigator:

• Component Send in your Custom nav bar.
• props Send any props your Custom Component needs.

• usage With Custom Component

Make sure your CustomTopNavigator can receive onFinish

And bind this onFinish function on the correct button.

the onFinish type: onFinish: ()=>void

<AssetsSelector
    options={{
        ...otherProps,
        CustomTopNavigator: {
            Component: CustomNavImageSelection,
            props: {
                backFunction: true,
                text: translator(T.PICK_IMAGES),
                doneFunction: (data: Asset[]) => onDone(data),
            },
        },
    }}
/>