0.3.1 • Published 1 year ago

@formbricks/react v0.3.1

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

Building React forms just got really easy 🤸

Every developer works with forms, few like their experience. Building Forms, especially in React, can be pretty annoying. State management, validation, form components, accessibility, internationalization and performance are all things you have to deal with, but don't really want to.

We make building - and maintaining - forms easier than ever in the world of React.

Example

import { Form, Text, Email, Checkbox, Submit } from "@formbricks/react";
import "@formbricks/react/styles.css";

export default function WaitlistForm() {
  return (
    <Form onSubmit={({ data, schema }) => console.log("data:", data, "schema:", schema)}>
      <Text name="name" label="What's your name?" validation="required" />
      <Email name="email" label="How can we reach you?" validation="required|email" />
      <Checkbox
        name="terms"
        label="Terms & Conditions"
        help="To use our service, please accept."
        validation="accepted"
      />
      <Submit label="Let's go!" />
    </Form>
  );
}

Why is this easier already?

  • One easy to use syntax for all input types
  • HTML & non-HTML input types available out of the box
  • Easily maintainable with component-based approach
  • All characteristics adjustable via props
  • Automatic schema generation

What is to come?

  • Conditional logic
  • Multi-page forms
  • Accessibility
  • Internationalization
  • Form templates (content & styles)

Custom Styling (CSS & Tailwind)

Giving your form the right look and feel is very likely why you chose to use code. Formbricks React supports styling with a custom style sheet as well as Tailwind CSS.

Custom Stylesheet

Simply create a style sheet, import it and add your CSS to these classes:

Checkbox-input-form-survey-react-lib-easy-build-forms-fast-validation-multi-step

CSS ClassDescription
formbricks-formThe outermost wrapping element.
formbricks-outerA wrapper around the label input, help text and error messages.
formbricks-legendThe legend (often a question)
formbricks-helpThe help text itself.
formbricks-optionsA wrapper around all options.
formbricks-optionA wrapper around each option.
formbricks-wrapperA wrapper around the label and the input field (no help text).
formbricks-labelThe label itself.
formbricks-innerA wrapper around the input element.
formbricks-inputThe input element itself, here the radio button.
formbricks-messageThe element (or many elements) containing a message — often validation and error messages.
formbricks-messagesA wrapper around all the messages.

Tailwind CSS

We love Tailwind! This is why Formbricks React natively supports Tailwind. All you have to do is target the classes using props. For example, to extend “formbricks-outer” class:

<Text name="firstname" label="What's your first name?" outerClassName="bg-gray-800 my-5" />

Validation & Error Messages

Validation prevents users from submitting missing of false data.

To add a validation to your inputs, add the validation prop and write the rules in string syntax. Rules are divided by a pipe (|), e.g.:

<Text name="age" label="What's your age?" validation="required|number|min:0|max:100" />
RuleExplanationExample
requiredOnly accepts non-empty fields“required”
numberOnly accepts fields with a number or float value“number”
minOnly accepts number values that are greater or equal to the value provided“min:10”
maxOnly accepts number values that are greater or equal to the value provided“max:50”
acceptedOnly accepts a truish value (true or 1)"accepted"
urlOnly accepts URLs e.g. "https://formbricks.com""url"
emailOnly accepts email addresses"email"

Docs

Dive into the Docs and join our Discord to request features and report bugs.

Shoutout

The Formbricks React Library is built on top of React Hook Form to make use of their data handling and performance optimizations.

The developer experience is inspired by the great FormKit for Vue.js Library.