@blackbox-vision/rff-rn-paper v0.6.2

RFF React Native Paper UI

React Native Paper UI Wrapper for React Final Form

Table of contents

• Use Case
• Compatibility
• Installation
  • NPM
  • YARN
• Example Usage
• Component APIs
  • Common Props
  • RadioButtoGroup
  • RadioButton
  • TextInput
  • Checkbox
  • Select
  • Switch
• Issues
• Contributing
• License

Use Case

You're working with react-final-form on react-native and you need bindings between react-native-paper and react-final-form.

Compatibility

Since this package uses hooks under the hood, you need at least a minimum React version of 16.8.0.

Installation

YARN

yarn add @blackbox-vision/rff-rn-paper

NPM

npm install --save @blackbox-vision/rff-rn-paper

Example Usage

After reading and performing the previous steps, you should be able to import the library and use it like in this example:

import React from 'react';
import { View } from 'react-native';
import { Form, Field } from 'react-final-form';
import {
  Select,
  Switch,
  Checkbox,
  TextInput,
  RadioButtonGroup,
} from '@blackbox-vision/rff-rn-paper';

const MyForm = props => (
  <Form
    onSubmit={values => alert(values)}
    render={({ handleSubmit }) => (
      <View>
        <Field
          component={TextInput}
          name="firstname"
          label="Firstname"
          placeholder="Enter firstname"
        />
        <Field
          component={TextInput}
          name="lastname"
          label="Lastname"
          placeholder="Enter lastname"
        />
        <Field
          component={Switch}
          name="likeFootball"
          labelPosition="right"
          label="Do you like Football?"
        />
        <Field
          component={Checkbox}
          name="color"
          labelPosition="right"
          label="Do you like red?"
        />
        <Field
          component={Select}
          name="favouriteMeal"
          label="Which is your favourite meal"
          options={[
            { label: 'pizza', value: 0 },
            { label: 'spaghetti', value: 1 },
          ]}
        />
        <Field
          component={RadioButtonGroup}
          name="favouriteDay"
          label="Which is your favourite day?"
          options={[
            { label: 'monday', value: 0 },
            { label: 'thursday', value: 1 },
          ]}
        />
      </View>
    )}
  />
);

MyForm.displayName = 'MyForm';

export default MyForm;

Component APIs

Common Props

All the components have the following base props:

RadioButtonGroup

The RadioButtonGroup component has the following props:

The RadioButtonGroup also inherits its own props from react-native-paper.

RadioButton

The RadioButton component has the following props:

The RadioButton also inherits its own props from react-native-paper.

TextInput

The TextInput component has the following props:

The TextInput also inherits its own props from react-native-paper.

Checkbox

The Checkbox component has the following props:

The Checkbox also inherits its own props from react-native-paper.

Select

The Select component has the following props:

The Select also inherits its own props from react-native.

Switch

The Switch component has the following props:

The Switch also inherits its own props from react-native-paper.

Issues

Please, open an issue following one of the issues templates. We will do our best to fix them.

Contributing

If you want to contribute to this project see contributing for more information.

License

Distributed under the MIT license. See LICENSE for more information.