budibase/packages/standard-components
Andrew Kingston 4630699f13 Merge branch 'master' of github.com:Budibase/budibase into form-builder 2021-02-01 09:11:48 +00:00
..
public Changing record -> row in this update, completing the update of renaming in the builder, this release needs further testing. 2020-10-09 19:10:28 +01:00
scripts Linting. 2020-10-21 15:29:13 +01:00
src Merge branch 'master' of github.com:Budibase/budibase into form-builder 2021-02-01 09:11:48 +00:00
.gitignore Remove old test dir and add yarn lockfile 2020-12-01 10:47:48 +00:00
LICENSE Correct licenses 2020-11-24 16:04:44 +00:00
README.md WIP component management and definition refactor 2021-01-12 20:00:35 +00:00
manifest.json Automatically make forms use latest data context if it matches 2021-01-29 16:40:19 +00:00
package.json Merge branch 'master' of github.com:Budibase/budibase into form-builder 2021-02-01 09:11:48 +00:00
rollup.config.js Add initial work on new Form component, spectrum styles and new text field 2021-01-26 08:55:44 +00:00
yarn.lock Merge branch 'master' of github.com:Budibase/budibase into form-builder 2021-02-01 09:11:48 +00:00

README.md

Manifest

The manifest.json file exports the definitions of all components available in this version of the client library. The manifest is used by the builder to correctly display components and their settings, and know how to correctly interact with them.

Component Definitions

The object key is the name of the component, as exported by index.js.

  • name - the name displayed in the builder
  • description - not currently used
  • icon - the icon displayed in the builder
  • hasChildren - whether the component accepts children or not
  • styleable - whether the component accepts design props or not
  • dataProvider - whether the component provides a data context or not
  • bindable - whether the components provides a bindable value or not
  • settings - array of settings displayed in the builder

###Settings Definitions

The type field in each setting is used by the builder to know which component to use to display the setting, so it's important that this field is correct. The valid options are:

  • text - A text field
  • select - A select dropdown. Accompany these with an options field to provide options
  • datasource - A datasource (e.g. a table or a view)
  • boolean - A boolean field
  • number - A numeric text field
  • detailURL - A URL to a page which displays details about a row. Exclusively used for grids which link to row details.

The available fields in each setting definition are:

  • type - the type of field which determines which component the builder will use to display the setting
  • key - the key of this setting in the component
  • label - the label displayed in the builder
  • defaultValue - the default value of the setting
  • placeholder - the placeholder for the setting