0.0.2 • Published 1 year ago

expo-hamro-image-picker v0.0.2

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

expo-hamro-image-picker

Dynamic Image/Files Picker For Expo

1234

Installation

To get started install the package in your Expo project by running:

yarn add expo-hamro-image-picker

or

npm i expo-hamro-image-picker

Basic Usage

import React from 'react';
import { View, Button } from 'react-native';
import ExpoHamroImagePicker from 'expo-hamro-image-picker';

export default function Test() {
    const [showPicker, setShowPicker] = useState(false);

    const handleSubmit = (data) => {
        console.log(data)
    }

    render() {
        return (
            <View style={{ flex: 1, backgroundColor: '#000000' }}>
                <ExpoHamroImagePicker
                    handlePickerClose={()=>{
                        console.log("picker closed");
                        setShowPicker(false);
                    }}
                    enablePicker={showPicker}
                    handleSubmit={handleSubmit}
                    enableEditor={true}
                    enableMultiSelect={true}
                    headerText="New Image"
                />
                <Button title="Open Image Picker" onPress={()=>setShowPicker(true)}/>
            </View>
        )
    }
}

Props

Parametertyperequireddefaultdescription
enablePickerbooleanYesopen/hide image picker
headerTextstringNoNew Postheader text shows at top
enableAlbumsbooleanNotrueallows select albums
enableCameraCapturebooleanNotrueallows capture image using camera
enableMultiSelectbooleanNofalseallows select multiple image/file
multiSelectOptionsMultiSelectOptionsPropsNo{ minimumImageCount: 1, maximumImageCount: -1 }configuration for multi image/file select
backButtonClosebooleanNotrueclose image picker on back button press
coverScreenbooleanNotruecovers entire screen
swipeToClosebooleanNotrueswipe down to close
multipleSelectEnabledbooleanNofalsemultiple image/file select enabled by default when picker opens
ImageComponentComponentNoImageBackgroundallows to use different Image Component. i.e. Image/FastImage etc.
handlePickerClosefunctionNo()=>{console.log("picker closes")}triggers when picker closes
handleSubmitfunctionNo(data)=>{console.log("picked image", data)}triggers when everything is done
enableEditorbooleanNotrueenable editor to allow edit picked image
editorOptionsImageEditorPropsNo{fixedCropAspectRatio={16 / 9} lockAspectRatio={false}}Image Editor Configurations: https://github.com/thomas-coldwell/expo-image-editor

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT