Schema Options

Options in schemas are always prefixed with x- (e.g. x-assertFormat) to not collide with future JSON schema spec keywords.

x-addPropertyContent

Type: boolean

Text content for "add property" buttons.

x-arrayAdd

Type: boolean

Default: true

If array "add" buttons should be displayed.

x-arrayAddContent

Type: boolean

Text content for array "add" buttons.

x-arrayDelete

Type: boolean

Default: true

If array "delete" buttons should be displayed.

x-arrayDeleteContent

Type: boolean

Text content for array "delete" buttons.

x-arrayDragContent

Type: boolean

Text content for array "drag" buttons.

x-arrayMove

Type: boolean

Default: true

If array "move up" and "move down" buttons should be displayed.

x-arrayMoveDownContent

Type: boolean

Text content for array "move down" buttons.

x-arrayMoveUpContent

Type: boolean

Text content for array "move up" buttons.

x-assertFormat

Type: boolean

Default: false

Treats "format" as a validator rather than just an annotation.

x-collapseToggleContent

Type: boolean

Text content for "collapse" buttons.

x-containerAttributes

Type: object

Editors container HTML attributes can be set using this option. Attributes such as class or data-* will be applied to the container element.

x-deactivateNonRequired

Type: boolean

Whether the editor should deactivate (hide) or activate (show) non required properties. Works only with object type editors.

x-enableCollapseToggle

Type: boolean

Display a collapse button used to collapse or expand editors that support collapse like object and arrays.

x-enforceConst

Type: boolean

Default: true

Value will remain whatever is defined in schema "const".

x-enforceEnum

Type: boolean

Default: true

Whether the editor initial value will be the first item in the "enum".

x-enumTitles

Type: string[]

Used to display user-friendly labels in the editor instead of those listed in "enum".

x-format

Type: string

Determines which editor UI will be used to edit the json instance.

x-grid

Type: object

A configuration object to determine the position of the property editor in the parent's grid.

Options:

  • columns: How many columns should the editor occupy. The number of columns can vary between css frameworks and their configuration.
  • offset: How many columns should the editor be offsetted
  • newRow: Whether the editor should be put in a new row

x-hidden

Type: boolean

Editors can be hidden using this option. When set to true, the editor is hidden.

x-info

Type: object

Used to display extra information.

Options:

  • variant: "modal"
  • title: Plain text or markdown
  • content: Plain text or markdown

x-inputAttributes

Type: object

Used to set attributes for the editor input if it has one.

x-messages

Type: object | string[]

Validation error messages can be customized using this option in the schema.

x-propertiesToggleContent

Type: boolean

Text content for "properties" buttons.

x-showErrors

Type: string

Default: "change"

Options: "never", "change", "always"

Determines when to display validation errors.

x-sortable

Type: boolean

Default: false

Items can be sorted via drag and drop if Sortable.js is available.

x-startCollapsed

Type: boolean

Whether the editor should start expanded or collapsed. Works on editors that support collapse like object and arrays.

x-switcherTitle

Type: string

Default: property name or "title"

The text displayed in the multiple editor switcher to select this sub-schema editor.

x-titleHidden

Type: boolean

Default: false

Hides the editor title.

x-titleIconClass

Type: string

Icon class to use in titles if using any.

x-titleTemplate

Type: string

A template to form titles dynamically.