Skip to content

Commit 1b29dc7

Browse files
committed
Update packages readme files.
1 parent 2b65359 commit 1b29dc7

File tree

10 files changed

+128
-121
lines changed

10 files changed

+128
-121
lines changed

README.md

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,6 @@ Data Driven Forms is a React library used for rendering and managing forms with
2929

3030
:book: For more information please visit the [documentation](https://data-driven-forms.org/). :book:
3131

32-
Used by [ManageIQ](http://manageiq.org/), Red Hat Cloud Services.
33-
3432
**Table of Contents**
3533

3634
- [Installation](#installation)
@@ -51,7 +49,7 @@ Used by [ManageIQ](http://manageiq.org/), Red Hat Cloud Services.
5149

5250
### Installation
5351

54-
You neet to add React Form Renderer
52+
Add React Form Renderer
5553

5654
#### [React Form Renderer](https://www.npmjs.com/package/@data-driven-forms/react-form-renderer)
5755

@@ -65,39 +63,42 @@ $ yarn add @data-driven-forms/react-form-renderer
6563

6664
Optionally you can install one of provided mappers:
6765

68-
#### [PatternFly 3 Mapper](https://www.npmjs.com/package/@data-driven-forms/pf3-component-mapper)
66+
67+
#### [Material-UI Mapper](https://www.npmjs.com/package/@data-driven-forms/mui-component-mapper)
6968

7069
```console
71-
$ npm install @data-driven-forms/pf3-component-mapper -S
70+
$ npm install @data-driven-forms/mui-component-mapper -S
7271
```
7372

7473
```console
75-
$ yarn add @data-driven-forms/pf3-component-mapper
74+
$ yarn add @data-driven-forms/mui-component-mapper
7675
```
7776

78-
#### [PatternFly 4 Mapper](https://www.npmjs.com/package/@data-driven-forms/pf4-component-mapper)
77+
#### [PatternFly 3 Mapper](https://www.npmjs.com/package/@data-driven-forms/pf3-component-mapper)
7978

8079
```console
81-
$ npm install @data-driven-forms/pf4-component-mapper -S
80+
$ npm install @data-driven-forms/pf3-component-mapper -S
8281
```
8382

8483
```console
85-
$ yarn add @data-driven-forms/pf4-component-mapper
84+
$ yarn add @data-driven-forms/pf3-component-mapper
8685
```
8786

88-
#### [Material-UI Mapper](https://www.npmjs.com/package/@data-driven-forms/mui-component-mapper)
87+
#### [PatternFly 4 Mapper](https://www.npmjs.com/package/@data-driven-forms/pf4-component-mapper)
8988

9089
```console
91-
$ npm install @data-driven-forms/mui-component-mapper -S
90+
$ npm install @data-driven-forms/pf4-component-mapper -S
9291
```
9392

9493
```console
95-
$ yarn add @data-driven-forms/mui-component-mapper
94+
$ yarn add @data-driven-forms/pf4-component-mapper
9695
```
9796

97+
Component libraries in mappers are external dependencies. Make sure to install them in your bundles.
98+
9899
### Usage
99100

100-
For using Data Driven Forms in your component you need the renderer and a component mapper, which provides formFields components and layoutFields components.
101+
In order to Data Driven Forms in your component you need the renderer and a component mapper, which provides component mapper and form template
101102

102103
```jsx
103104
import React from 'react';
@@ -138,6 +139,8 @@ Data Driven Forms supports all kinds of component, basic set is consisted of:
138139
- Sub-form
139140
- Wizard
140141

142+
Any other components can be added to mapper and renderer with the form renderer. Existing components can be also overriden.
143+
141144
### Documentation
142145

143146
Please use our [documentation site](https://data-driven-forms.org/). In case of any problem, you can access documentation files directly in GitHub.

packages/blueprint-component-mapper/README.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,11 @@
1-
[![npm version](https://badge.fury.io/js/%40data-driven-forms%2Fpf4-component-mapper.svg)](https://badge.fury.io/js/%40data-driven-forms%2Fpf4-component-mapper)
1+
[![npm version](https://badge.fury.io/js/%40data-driven-forms%2Fblueprint-component-mapper.svg)](https://badge.fury.io/js/%40data-driven-forms%2Fblueprint-component-mapper)
22

33
[![Data Driven Form logo](images/logo.png)](https://data-driven-forms.org/)
44

55
Blueprint component mapper for [Data Driven Forms](https://github.com/data-driven-forms/react-forms).
66

77
:book: For more information please visit the [documentation](https://data-driven-forms.org/). :book:
88

9-
Used by [ManageIQ](http://manageiq.org/), Red Hat Cloud Services.
10-
119
**Table of Contents**
1210

1311
- [Installation](#installation)
@@ -156,7 +154,7 @@ Format:
156154
```
157155
[type]([package]): message
158156
159-
fix(pf4): title accepts node
157+
fix(blueprint): title accepts node
160158
```
161159

162160
Types:

packages/common/README.md

Lines changed: 13 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,30 +4,23 @@
44
55
This package exists to share code used by more than one data-driven-forms package, such as:
66

7-
* shared interfaces - propTypes
8-
* common mapper code - `condition` implementation
7+
- shared interfaces - propTypes
8+
- common mappers code
9+
- wizard
10+
- select
11+
- multiplechoice list
12+
- form template
13+
- dual list select
14+
- demo schema
15+
16+
...and some boring config files etc.
17+
918
19+
This packages is not released but can be referenced in mapper packages. Demo packages does not have access to common package!
1020

1121
## Usage
1222
1323
```
14-
const common = require('@data-driven-forms/common');
15-
16-
// shared props
17-
function MyComponent() {...}
18-
19-
MyComponent.propTypes = {
20-
...common.children.propTypes,
21-
isMulti: PropTypes.bool.isRequired,
22-
};
23-
24-
MyComponent.defaultProps = {
25-
...common.children.defaultProps,
26-
};
24+
import demoSchema from '@data-driven-forms/common/src/demoschema';
2725
28-
// condition code
29-
common.condition.evaluate({
30-
when: "field",
31-
in: ["foo", "bar"],
32-
}, { field: "baz" }); // false
3326
```

packages/mui-component-mapper/README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@ Material-UI component mapper for [Data Driven Forms](https://github.com/data-dri
66

77
:book: For more information please visit the [documentation](https://data-driven-forms.org/). :book:
88

9-
Used by [ManageIQ](http://manageiq.org/), Red Hat Cloud Services.
9+
[Material-IU docs](https://material-ui.com/)
10+
1011

1112
**Table of Contents**
1213

packages/parsers/README.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,9 +54,11 @@ const mozillaSchema = [
5454
}
5555
]
5656

57+
const parsedSchema = mozilla(mozillaSchema)
58+
5759
const Form = () => (
5860
<FormRenderer
59-
schema={mozilla(mozillaSchema)}
61+
schema={parsedSchema}
6062
componentMapper={componentMapper}
6163
FormTemplate={FormTemplate}
6264
onSubmit={console.log}

packages/pf3-component-mapper/README.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,6 @@ Patternfly 3 component mapper for [Data Driven Forms](https://github.com/data-dr
66

77
:book: For more information please visit the [documentation](https://data-driven-forms.org/). :book:
88

9-
Used by [ManageIQ](http://manageiq.org/), Red Hat Cloud Services.
10-
119
**Table of Contents**
1210

1311
- [Installation](#installation)

packages/pf4-component-mapper/README.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,6 @@ Patternfly 4 component mapper for [Data Driven Forms](https://github.com/data-dr
66

77
:book: For more information please visit the [documentation](https://data-driven-forms.org/). :book:
88

9-
Used by [ManageIQ](http://manageiq.org/), Red Hat Cloud Services.
10-
119
**Table of Contents**
1210

1311
- [Installation](#installation)

packages/react-form-renderer/README.md

Lines changed: 55 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,12 @@
1+
[![codecov](https://codecov.io/gh/data-driven-forms/react-forms/branch/master/graph/badge.svg)](https://codecov.io/gh/data-driven-forms/react-forms)
2+
[![CircleCI](https://circleci.com/gh/data-driven-forms/react-forms/tree/master.svg?style=svg)](https://circleci.com/gh/data-driven-forms/react-forms/tree/master)
13
[![npm version](https://badge.fury.io/js/%40data-driven-forms%2Freact-form-renderer.svg)](https://badge.fury.io/js/%40data-driven-forms%2Freact-form-renderer)
24

35
[![Data Driven Form logo](images/logo.png)](https://data-driven-forms.org/)
46

57
Data Driven Forms is a React library used for rendering and managing forms with a lot of provided features based on [React Final Form](https://github.com/final-form/react-final-form).
68

9+
710
:question: Why to use Data Driven Forms? :question:
811
- All forms shared the same functionality!
912
- Components are controlled in one place!
@@ -26,8 +29,6 @@ Data Driven Forms is a React library used for rendering and managing forms with
2629

2730
:book: For more information please visit the [documentation](https://data-driven-forms.org/). :book:
2831

29-
Used by [ManageIQ](http://manageiq.org/), Red Hat Cloud Services.
30-
3132
**Table of Contents**
3233

3334
- [Installation](#installation)
@@ -48,7 +49,7 @@ Used by [ManageIQ](http://manageiq.org/), Red Hat Cloud Services.
4849

4950
### Installation
5051

51-
You neet to add React Form Renderer
52+
Add React Form Renderer
5253

5354
#### [React Form Renderer](https://www.npmjs.com/package/@data-driven-forms/react-form-renderer)
5455

@@ -62,39 +63,42 @@ $ yarn add @data-driven-forms/react-form-renderer
6263

6364
Optionally you can install one of provided mappers:
6465

65-
#### [PatternFly 3 Mapper](https://www.npmjs.com/package/@data-driven-forms/pf3-component-mapper)
66+
67+
#### [Material-UI Mapper](https://www.npmjs.com/package/@data-driven-forms/mui-component-mapper)
6668

6769
```console
68-
$ npm install @data-driven-forms/pf3-component-mapper -S
70+
$ npm install @data-driven-forms/mui-component-mapper -S
6971
```
7072

7173
```console
72-
$ yarn add @data-driven-forms/pf3-component-mapper
74+
$ yarn add @data-driven-forms/mui-component-mapper
7375
```
7476

75-
#### [PatternFly 4 Mapper](https://www.npmjs.com/package/@data-driven-forms/pf4-component-mapper)
77+
#### [PatternFly 3 Mapper](https://www.npmjs.com/package/@data-driven-forms/pf3-component-mapper)
7678

7779
```console
78-
$ npm install @data-driven-forms/pf4-component-mapper -S
80+
$ npm install @data-driven-forms/pf3-component-mapper -S
7981
```
8082

8183
```console
82-
$ yarn add @data-driven-forms/pf4-component-mapper
84+
$ yarn add @data-driven-forms/pf3-component-mapper
8385
```
8486

85-
#### [Material-UI Mapper](https://www.npmjs.com/package/@data-driven-forms/mui-component-mapper)
87+
#### [PatternFly 4 Mapper](https://www.npmjs.com/package/@data-driven-forms/pf4-component-mapper)
8688

8789
```console
88-
$ npm install @data-driven-forms/mui-component-mapper -S
90+
$ npm install @data-driven-forms/pf4-component-mapper -S
8991
```
9092

9193
```console
92-
$ yarn add @data-driven-forms/mui-component-mapper
94+
$ yarn add @data-driven-forms/pf4-component-mapper
9395
```
9496

97+
Component libraries in mappers are external dependencies. Make sure to install them in your bundles.
98+
9599
### Usage
96100

97-
For using Data Driven Forms in your component you need the renderer and a component mapper, which provides formFields components and layoutFields components.
101+
In order to Data Driven Forms in your component you need the renderer and a component mapper, which provides component mapper and form template
98102

99103
```jsx
100104
import React from 'react';
@@ -119,6 +123,39 @@ const Form = () => (
119123
)
120124
```
121125

126+
#### Custom mapper
127+
128+
You can also custom mapper for your applications
129+
130+
```jsx
131+
import React from 'react';
132+
import FormRenderer, { componentTypes, useFieldApi } from '@data-driven-forms/react-form-renderer';
133+
134+
const TextField = props => {
135+
const {label, input, meta, ...rest} = useFieldApi(props)
136+
return (
137+
<div>
138+
<label htmlForm={input.name}>{label}</label>
139+
<input {...input} {...rest} id={input.name}/>
140+
{meta.error && <p>{meta.error}</p>}
141+
</div>
142+
)
143+
}
144+
145+
const componentMapper = {
146+
[componentTypes.TEXT_FIELD]: TextField,
147+
'custom-type': TextField
148+
}
149+
150+
const schema = {
151+
fields: [{
152+
component: componentTypes.TEXT_FIELD,
153+
name: 'name',
154+
label: 'Your name'
155+
type: 'search',
156+
}]
157+
}
158+
122159
### Basic provided components
123160

124161
Data Driven Forms supports all kinds of component, basic set is consisted of:
@@ -135,15 +172,11 @@ Data Driven Forms supports all kinds of component, basic set is consisted of:
135172
- Sub-form
136173
- Wizard
137174

138-
### Documentation
175+
Any other components can be added to mapper and renderer with the form renderer. Existing components can be also overriden.
139176

140-
Please use our [documentation site](https://data-driven-forms.org/). In case of any problem, you can access documentation files directly in GitHub:
177+
### Documentation
141178

142-
- [Documentation pages](packages/react-renderer-demo/src/docs-components/)
143-
- [Form renderer API](packages/react-renderer-demo/src/docs-components/renderer-api.md)
144-
- [Components API](packages/react-renderer-demo/src/docs-components/component-api.md)
145-
- [Components mapping](packages/react-renderer-demo/src/docs-components/component-mapping.md)
146-
- [Field provider](packages/react-renderer-demo/src/docs-components/field-provider.md)
179+
Please use our [documentation site](https://data-driven-forms.org/). In case of any problem, you can access documentation files directly in GitHub.
147180

148181
### Useful links
149182

@@ -212,7 +245,7 @@ Format:
212245
```
213246
[type]([package]): message
214247
215-
fix(renderer): title accepts node
248+
fix(pf3): title accepts node
216249
```
217250

218251
Types:
@@ -236,4 +269,4 @@ We welcome any community contribution. Don't be afraid to report bug or to creat
236269
237270
### LICENSE
238271
239-
Apache License 2.0
272+
Apache License 2.0

0 commit comments

Comments
 (0)