This field plug-in is designed to display a symbol either before or after an input field. It was developed for a field plug-in development demonstration for beginners which you can learn more about in this recorded webinar and in this Support Center article.
If you're looking for more advanced symbol formatting capabilities with flexible layout options, precise control over placement and sizing, you might want to check out the format-symbol-advanced plug-in instead, which extends the functionality of this basic format-symbol field plug-in.
- Define symbol to be displayed.
- Choose where the symbol should appear.
This field plug-in also inherits functionality from the baseline-decimal field plug-in.
This field plug-in requires the decimal field type.
To use this plug-in as-is
- Download the sample form from this repo and upload it to your SurveyCTO server.
- Download the format-symbol.fieldplugin.zip file from this repo, and attach it to the sample form on your SurveyCTO server.
| Parameter key | Parameter value |
|---|---|
symbol |
The symbol to be displayed. |
placement |
The positioning of they symbol. This can take two values:
|
To display a percent symbol on the right of the textbox, the following would be placed in the appearance column of the spreadsheet form definition:
custom-format-symbol(symbol='%', placement='right')
| Feature / Property | Support |
|---|---|
| Supported field type(s) | decimal |
| Default values | Yes |
| Constraint message | Uses default behavior |
| Required message | Uses default behavior |
| media:image | Yes |
| media:audio | Yes |
| media:video | Yes |
show-formatted appearance |
No |
-
Sample form
Download sample form -
Developer documentation
Instructions and resources for developing your own field plug-ins.
https://github.com/surveycto/Field-plug-in-resources -
User documentation
How to get started using field plug-ins in your SurveyCTO form.
https://docs.surveycto.com/02-designing-forms/03-advanced-topics/06.using-field-plug-ins.html