npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2022 – Pkg Stats / Ryan Hefner

@react-native-community/image-picker-ios

v1.0.1

Published

React Native Image Picker for iOS

Downloads

73

Readme

@react-native-community/image-picker-ios

CircleCI Status Supports iOS MIT License

React Native ImagePicker for iOS. It allows you to get information on:

  • Can you use the Camera
  • Can you record video

Getting started

Install the library using either Yarn:

yarn add @react-native-community/image-picker-ios

or npm:

npm install --save @react-native-community/image-picker-ios

You then need to link the native parts of the library for the platforms you are using. The easiest way to link the library is using the CLI tool by running this command from the root of your project:

react-native link @react-native-community/image-picker-ios

If you can't or don't want to use the CLI tool, you can also manually link the library using the instructions below (click on the arrow to show them):

Either follow the instructions in the React Native documentation to manually link the framework or link using Cocoapods by adding this to your Podfile:

pod 'react-native-image-picker-ios', :path => '../node_modules/@react-native-community/image-picker-ios'

Migrating from the core react-native module

This module was created when the ImagePickerIOS was split out from the core of React Native. To migrate to this module you need to follow the installation instructions above and then change you imports from:

import { ImagePickerIOS } from "react-native";

to:

import ImagePickerIOS from "@react-native-community/image-picker-ios";

Note that the API was updated after it was extracted from ImagePickerIOS to support some new features, however, the previous API is still available and works with no updates to your code.

Usage

Import the library:

import ImagePickerIOS from "@react-native-community/image-picker-ios";

Can you use the camera:

ImagePickerIOS.canUseCamera(canUseCamera => {
  console.log("canUseCamera", canUseCamera);
});

Can you record videos:

ImagePickerIOS.canRecordVideos(canRecordVideos => {
  console.log("canRecordVideos", canRecordVideos);
});

API

Types

OpenCameraDialogOptions

Describes the settings for the camera:

| Property | Type | Description | | --------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------- | | videoMode | boolean | Should the camera open in video mode. |

OpenSelectDialogOptions

Describes the settings for the camera:

| Property | Type | Description | | --------------- | ------------------------------------------------ | -------------------------------------------------------------------------------------------------- | | showImages | boolean | Should the results include images | | showVideos | boolean | Should the results include videos|

Methods

canUseCamera()

Executes a callback with the a boolean value stating whether or not you can use the camera.

Example:

ImagePickerIOS.canUseCamera(canUseCamera => {
  console.log("canUseCamera", canUseCamera);
});

canRecordVideos()

Executes a callback with the a boolean value stating whether or not you can record videos.

Example:

ImagePickerIOS.canRecordVideos(canRecordVideos => {
  console.log("canRecordVideos", canRecordVideos);
});

openCameraDialog()

Opens the camera dialog with the specified OpenCameraDialogOptions and two callbacks, one for success and one for cancel.

Example:

ImagePickerIOS.openCameraDialog({
  unmirrorFrontFacingCamera: false
  videoMode: false
}, () => {
  // success
}, (error) => {
  // cancel
});

openSelectDialog()

Opens the camera dialog with the specified OpenSelectDialogOptions and two callbacks, one for success and one for cancel.

Example:

ImagePickerIOS.openCameraDialog({
  showImages: true,
  showVideos: false
}, (imageUrl, height, width) => {
  // success
}, (error) => {
  // cancel
});

Troubleshooting

Errors while running Jest tests

If you do not have a Jest Setup file configured, you should add the following to your Jest settings and create the jest.setup.js file in project root:

setupFiles: ['<rootDir>/jest.setup.js']

You should then add the following to your Jest setup file to mock the ImagePickerIOS Native Module:

import { NativeModules } from 'react-native';

NativeModules.RNCImagePickerIOS = {
  canRecordVideos: jest.fn(),
  canUseCamera: jest.fn(),
  openCameraDialog: jest.fn(),
  openSelectDialog: jest.fn(),
};

Issues with the iOS simulator

As your simulator doesn't have a camera, there is no way to open the camera on the simulator.

Maintainers

Contributing

Please see the contributing guide.

License

The library is released under the MIT license. For more information see LICENSE.