Skip to main content

String

The string property can be used with many form fields, from simple text fields, to select fields, markdown or file uploads (the storage key, or the url gets saved).

import { buildProperty } from "./builders";
const nameProperty = buildProperty({
title: "Name",
description: "Basic string property with validation",
validation: { required: true },
dataType: "string"
});

config#

storageMeta#

You can specify a StorageMeta configuration. It is used to indicate that this string refers to a path in Google Cloud Storage.

  • mediaType Media type of this reference, used for displaying the preview.
  • storagePath Absolute path in your bucket. You can specify it directly or use a callback
  • acceptedFiles File MIME types that can be uploaded to this reference.
  • metadata Specific metadata set in your uploaded file.
  • fileName You can specify a fileName callback if you need to customize the name of the file
  • storeUrl When set to true, this flag indicates that the download URL of the file will be saved in Firestore instead of the Cloud storage path. Note that the generated URL may use a token that, if disabled, may make the URL unusable and lose the original reference to Cloud Storage, so it is not encouraged to use this flag. Defaults to false.
import { buildProperty } from "./builders";
const imageProperty = buildProperty({
dataType: "string",
config: {
storageMeta: {
mediaType: "image",
storagePath: (context) => {
return "images";
},
acceptedFiles: ["image/*"],
fileName: (context) => {
return context.file.name;
}
}
}
});

url#

If the value of this property is a URL, you can set this flag to true to add a link, or one of the supported media types to render a preview.

import { buildProperty } from "./builders";
const amazonLinkProperty = buildProperty({
dataType: "string",
title: "Amazon link",
config: {
url: true
}
});

enumValues#

You can use the enum values providing a map of possible exclusive values the property can take, mapped to the label that it is displayed in the dropdown. You can use a simple object with the format value => label, or with the format value => EnumValueConfig if you need extra customization, (like disabling specific options or assigning colors). If you need to ensure the order of the elements, you can pass a Map instead of a plain object.

import { buildProperty } from "./builders";
const amazonLinkProperty = buildProperty({
dataType: "string",
title: "Amazon link",
config: {
enumValues: {
"es": "Spanish",
"de": "German",
"en": "English",
"it": "Italian",
"fr": {
label: "French",
disabled: true
}
}
}
});

multiline#

Is this string property long enough, so it should be displayed in a multiple line field. Defaults to false. If set to true, the number of lines adapts to the content.

import { buildProperty } from "./builders";
const property = buildProperty({
title: "Description",
dataType: "string",
config: {
multiline: true
}
});

markdown#

Should this string property be displayed as a markdown field. If true, the field is rendered as a text editors that supports markdown highlight syntax. It also includes a preview of the result.

import { buildProperty } from "./builders";
const property = buildProperty({
dataType: "string",
title: "Text",
config: {
markdown: true
}
});

previewAsTag#

Should this string be rendered as a tag instead of just text.

import { buildProperty } from "./builders";
const property = buildProperty({
title: "Tags",
description: "Example of generic array",
dataType: "array",
of: {
dataType: "string",
config: {
previewAsTag: true
}
}
});

validation#

  • required Should this field be compulsory.
  • requiredMessage Message to be displayed as a validation error.
  • unique The value of this field must be unique in this collection.
  • uniqueInArray If you set it to true, the user will only be allowed to have the value of that property once in the parent ArrayProperty. It works on direct children properties or on first level children of a MapProperty (if set as the .of property of the ArrayProperty).
  • length Set a required length for the string value.
  • min Set a minimum length limit for the string value.
  • max Set a maximum length limit for the string value.
  • matches Provide an arbitrary regex to match the value against.
  • email Validates the value as an email address via a regex.
  • url Validates the value as a valid URL via a regex.
  • trim Transforms string values by removing leading and trailing whitespace.
  • lowercase Transforms the string value to lowercase.
  • uppercase Transforms the string value to uppercase.

Based on your configuration the form field widgets that are created are:

  • TextField generic text field
  • StorageUploadField the property has a storage configuration.
  • MarkdownField. the property has a markdown configuration.
  • Select if enumValues are set in the string config, this field renders a select where each option is a colored chip.

Links: