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
- Id
- Name
- Required
- Type
General
- Title
- Hint
- Orientation
- Read-only
- Class
- Style
Title
- Visible
- Width
- Font Size
- Font Style
- Font Weight
- Font Color
- Wrap
Control
- Width
- Font Size
- Font Style
- Font Weight
- Font Color

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;