@visma/rjsf-semantic-ui

rjsf-semantic-ui

Semantic UI theme, fields and widgets for react-jsonschema-form.
Explore the docs »

View Playground · Report Bug · Request Feature

Table of Contents

• About The Project
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Contributing
• Contact

About The Project

Exports semantic-ui theme, fields and widgets for react-jsonschema-form.

Built With

• react-jsonschema-form
• Semantic UI

Getting Started

• See the getting started guide on react-semantic-ui.

Prerequisites

• @semantic-ui-react >= 0.87.0
• @semantic-ui-css >= 2.4.1 (default theme for semantic-ui); see theming guide if you wish to customize
• @visma/rjsf-core >= 2.0.0

yarn add semantic-ui-css semantic-ui-react @visma/rjsf-core

Installation

yarn add @visma/rjsf-semantic-ui

Usage

import Form from '@visma/rjsf-semantic-ui';

or

import { withTheme } from '@visma/rjsf-core';
import { Theme as SemanticUITheme } from '@visma/rjsf-semantic-ui';

// Make modifications to the theme with your own fields and widgets

const Form = withTheme(SemanticUITheme);

Optional Semantic UI Theme properties

• To pass additional properties to widgets, see this guide.

Semantic Widget Optional Properties

• Semantic props for TextWidget
• Semantic props for CheckboxWidget
• Semantic props for SelectWidget
• Semantic props for RangeWidget
• Semantic props for RadioWidget
• Semantic props for PasswordWidget
• Semantic props for UpDownWidget
• Semantic props for TextAreaWidget

Custom Semantic Widget Properties

Below are the current default options for all widgets:

{
  "ui:options":  {
    "semantic": {
      "fluid": true,
      "inverted": false,
      "errorOptions": {
        "size": "small",
        "pointing": "above",
      }
    }
  }
}

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Read our contributors' guide to get started.

Contact

rjsf team: https://github.com/orgs/rjsf-team/people

GitHub repository: https://github.com/rjsf-team/react-jsonschema-form