[Status] Document status capability

...in the developer guide. Includes a table for listing
status names and classes, per code review feedback,
nasa/openmctweb#319.
This commit is contained in:
Victor Woeltjen 2015-11-19 15:12:03 -08:00
parent 5b9e43f8ff
commit b5d1118a3f

View File

@ -2056,6 +2056,31 @@ objects which has a `relationships` property in their model, whose value is an
object containing key-value pairs, where keys are strings identifying object containing key-value pairs, where keys are strings identifying
relationship types, and values are arrays of domain object identifiers. relationship types, and values are arrays of domain object identifiers.
## Status Capability
The `status` capability provides a way to flag domain objects as possessing
certain states, represented as simple strings. These states, in turn, are
reflected on `mct-representation` elements as classes (prefixed with
`s-status-`.) The `status` capability has the following interface:
* `get()`: Returns an array of all status strings that currently apply
to this object.
* `set(status, state)`: Adds or removes a status flag to this domain object.
The `status` argument is the string to set; `state` is a boolean
indicating whether this status should be included (true) or removed (false).
* `listen(callback)`: Listen for changes in status. The provided `callback`
will be invoked with an array of all current status strings whenever status
changes.
Plug-ins may add and/or recognize arbitrary status flags. Flags defined
and/or supported by the platform are:
Status | CSS Class | Meaning
-----------|--------------------|-----------------------------------
`editing` | `s-status-editing` | Domain object is being edited.
`pending` | `s-status-pending` | Domain object is partially loaded.
## Telemetry Capability ## Telemetry Capability
The telemetry capability provides a means for accessing telemetry data The telemetry capability provides a means for accessing telemetry data