Color Coding of Fields and Rows in Lists

To support color coding in lists (on List pages and in related item lists), a List object and ListRow object are required respectively for the list, and specific rows in the list. A custom handler must be registered for the List object and this handler is automatically executed on initial page load, on paging, and when a field on any of the rows is edited inline. For information about methods of the List object, see the table in Methods for the List Object, and for an example of a custom handler, see About the Custom Handler for a List Object.

In the custom handler you can use:

• Methods of the ListRow object to get and set the background color of rows, see the table in Methods for the ListRow Object.

• Methods of the Field object to get and set colors for the values of fields within rows, see the table in JavaScript API Reference.

Note: In lists, if both the background and text color for a specific field within a row, and the background color for the entire row are set using the JavaScript API, then within the row, the color coding for the specific field overrides the color coding for the row.

For information about finding the field names that you must use when working with these methods, see Finding Field Names.

For information about finding list names, see Finding List Names.