SharePoint field properties

This article describes common properties available to all fields, which you can edit in the designer, but also shows how the same properties can be used dynamically with JavaScript.

SharePoint Field

The properties in this section are read-only. Some properties can be modified in the SharePoint column settings.

Id

A unique identifier of the SahrePoint column. Can’t be modified.

Field's id

Name

The internal name of the SharePoint column.

Field's name

JavaScript

The Name property allows to work with the field via JavaScript code, like this:

fd.spRendered(function() {
   //can access the field using its Name:
   fd.field('Title').value = 'Project Delta';
});

Important

The Internal name can’t be changed. You can only change the display name of the column.

Required

Indicates whether the field is required.

Field's required status

You can change this property in the SharePoint column settings:

Column settings page - required

Or using the JavaScript:

//returns the field's required status as true/false
fd.field('Text1').required;

//sets the field's required status
fd.field('Text1').required = true;

Type

Indicates the column type.

Column type

You can change the column type in the SharePoint column settings:

Column settings page - type

General

Title

Specify text of the title that will appear next to the field.

Field's title

JavaScript

This code will allow you to get or set the field’s title dynamically:

//returns the field's title as a string
fd.field('Field1').title

//sets the field's title
fd.field('Field1').title = 'Last Name'

Hint

Defines a placeholder text that appears in the input before a user starts typing:

Hint property

JavaScript

This code will allow you to get or set the field’s placeholder text dynamically:

//sets the field's Hint
fd.field('Field1').placeholder = "Enter your name";

Orientation

Select if the title will appear to the left of the field, or right above it.

Field's orientation

Read-only

Define whether a user can view or edit the contents of the field:

Read-only property

Class

Add a CSS class to the field, which comes in handy with CSS or even JavaScript code. This will work like class attribute for an HTML tag.

Field's class

Same class can be applied to multiple fields, and then you can use CSS to modify the appearance of these fields. For example, here we’ve used the following CSS code in CSS editor to give fields with my-class a blue background, white text and rounded corners, with a little bit of padding:

.my-class {
    color: #FFFFFF;
    padding: 10px;
    background-color: #1E90FF;
    border-radius: 30px;
}

Style

Add custom CSS style to the field. This will work like style attribute for an HTML tag.

Field's style

This style will allow you to hide the field, making it invisible to user (but still usable with JavaScript):

display: none;

You can also apply different styles to it. For example, the following style will allow you to add a thin gray border around the field:

padding: 10px;
border: 1px solid #CED4DA;

Title

Visible

Select if the field’s title will be visible or not.

Field's Title visibility

Width

Specify in pixels how much space should the field’s title take.

Field's Title width

Font Size

Specify the font size for the field’s title.

Field's Title font size

Font Style

Select if you want Normal or Italic text in the title.

Field's Title font style

Font Weight

Select if you want Normal, Semibold or Bold text in the title.

Field's Title font weight

Font Color

Specify a color for the field’s title text. Select the color from the palette or enter the Hex color code.

Field's Title font color

Wrap

Select if the title’s text should wrap in multiple lines when there is not enough space, or just be shortened until it fits (with dots… at the end).

Field's Title wrap

Control

Width

Specify in pixels how much space should the field’s field take.

Field control's width

Font Size

Specify the font size for the field’s control.

Field field's font size

Font Style

Select if you want Normal or Italic text in the control.

Field control's font styling

Font Weight

Select if you want Normal, Semibold, or Bold text in the control.

Field control's font weight

Font Color

Specify color for the field’s control text. Select the color from the palette or enter the Hex color code.

control's font color