Draft; Still incomplete, but hopefully a bit useful nonetheless.

Overview

Preferences Editors are constructed by combining three main parts:

The Preferences Framework provides all the lifecycle events, configuration hooks, and persistence infrastructure required to support hooking these pieces together, as well as providing some pre-existing panels and enactors that can be re-used if desired.

There are two main ways you will likely use the Preferences Framework:

  1. to add a Preferences Editor to a page
  2. or to add only the data store and enactors to a page

The configuration is the same for both of these modes; only the actual instantiation differs. This tutorial will teach both modes.

General process for creating a preferences editor

  1. Create a primary schema defining your preferences.
  2. Create panel components for your adjustors.
  3. Create enactor components to act on the preferences.
  4. Create an auxiliary schema specifying which panels and enactors to associate with the preferences.
  5. Instantiate:
    1. the preferences editor, along with the settings store and enhancer, or
    2. only the settings store and enhancer
  6. Style the Preferences Editor