Toggle menu

Code Editor Input

The code editor field lets a user enter JavaScript, CSS, HTML or Handlebars markup. This field type only works within iCM and is designed to be used in article extra and subsite configuration forms.

Properties

LabelDescriptionType Name
LabelThe label for the fieldLABEL
Show LabelWhether the label for this field will be visible on the form. Set to false to hide the field's labelSHOWLABEL
HintAdditional information displayed alongside the field to assist the user. The value of another field can be used by adding the field's name between # characters. See Common Field Properties for more informationHINT
RequiredWhether or not the field is required to have a value to pass validationREQUIRED
DefaultDefault code for the field. This must meet any field level validation set by the other field settingsDEFAULT
Error MessageThe error message that will be displayed if this field fails its validationERRMSG
Error Message FunctionA function that can be used to override the default error message. You can return a different message for each error type. The message can include the value of another field can be used by adding the field's name between # characters. See Error Message Functions for more information.

This field has the following error types:
 
  • REQUIRED - the field is required but has been left blank
  • VALIDATIONFUNCTION - the result of a custom validation function failing (validation function can also return custom error types)
ERRMSGFUNC
WidthThe editor's display width width in pixels. Leave blank to set the width to 'auto' ie to stretch the width to fitWIDTH
HeightThe height of the field in pixelsHEIGHT
Editor TypeThe type of code to be edited. The editor will be configured to support editing of the selected code type. JavaScript is the defaultFORMAT
Validation FunctionA JavaScript function that can be used to provide custom field validation whenever the field value changes or the form is submitted. This function will be executed client-side, provided JavaScript is enabled in the browser, and repeated server-sideVALFUNC
Default FunctionA JavaScript function you can use to calculate the starting field value. This function is executed server-side when the field HTML is generated. See Common Field Properties for an exampleDEFFUNC
HandlersA JavaScript function that is executed browser-side whenever the page loads or the field value changes. See Common Field Properties for an exampleHANDLERS
Read OnlyDisplay the field as read onlyREADONLY
DocumentationAdd documentation to your field to help explain any complex functionality to future users. You might include information on what the field does and how it relates to other fields on the form. Notes added here are only ever visible in the Forms Designer, they can be searched for, viewed and downloaded from the action panel. See Common Field Properties for an exampleDOCUMENTATION
Last modified on February 26, 2024

Share this page

Facebook icon Twitter icon email icon

Print

print icon