new (require("nmodule/webEditors/rc/wb/mgr/model/columns/TypeMgrColumn"))()
API Status: Development
Manager column used to display and edit the component type of a row.
Extends:
Methods
-
buildCell(row, dom)
-
Builds the cell contents using the type's display name.
Parameters:
Name Type Description row
module:nmodule/webEditors/rc/wb/table/model/Row dom
JQuery -
coalesceRows(rows)
-
For the given array of rows, this will produce a single value from
from the intersection of the available types. The types will have been
set as a data value on the row by either theNewCommand
orAddCommand
.
This will create a dynamic enum with each tag representing one of the
intersected types.If there are no available types (i.e. the rows are being edited, rather
than added), it will return a 'cannot edit' message string to be displayed
in the batch component editor. In this situation,getConfigFor()
will
return a DisplayOnlyEditor.Parameters:
Name Type Description rows
Array.<module:nmodule/webEditors/rc/wb/table/model/Row> Returns:
- Type
- baja.DynamicEnum | string
-
<abstract> commit(value, row [, params])
-
Should read the value and "officially" apply it back to the selected rows.
Ifparams.batch
is received, thenparams.progressCallback
must be
called withMgrColumn.COMMIT_READY
when this function is done using that
batch (even if no network calls are added to it).Note: sometimes you may want to abort the entire process of saving changes
to the Manager, for instance, if one of your columns requires the user to
confirm a dialog before committing. Returning a Promise that rejects will
show an error dialog to the user, which may not be what you want if you've
already shown a dialog. Another option is to return a Promise that never
resolves or rejects, which will drop the user back at the edit screen
without committing any changes (all commit calls must resolve for any
changes to post to the station). A more explicit API for this may be
provided in the future.Parameters:
Name Type Argument Description value
* the proposed value to commit to the row
row
module:nmodule/webEditors/rc/wb/table/model/Row params
Object <optional>
Properties
Name Type Argument Description editor
module:nmodule/webEditors/rc/fe/baja/BaseEditor <optional>
the editor from which the value was read. If the column is not editable,
this parameter will beundefined
, as no editor will have been created for
the value. This situation may occur when a value obtained via discovery is
set on row for a non-editable column.batch
baja.comm.Batch <optional>
a batch to use to commit changes
up to the stationprogressCallback
function <optional>
call this with
MgrColumn.COMMIT_READY
when this function is done adding network calls to
the batch.- Inherited From:
Returns:
- Type
- Promise
-
destroyCell(row, dom)
-
Called when the table is destroying the DOM element built for a cell in this column. This
gives aColumn
implementation the chance to clean up any resources that might have been
created during the earlier call to#buildCell
, perhaps destroying a widget in the cell,
for example. As with#buildCell
, if this completes synchronously and doesn't return a
Promise, the caller must wrap this in a call toPromise.resolve()
.Parameters:
Name Type Description row
module:nmodule/webEditors/rc/wb/table/model/Row dom
jQuery - Inherited From:
Returns:
- Type
- Promise | *
-
getColumnIcon()
-
Return the icon to be used for the column in the batch component editor.
Returns:
- Type
- baja.Icon
-
getConfigFor(rows)
-
Create the config object for the editor based on the coalesced value.
If there are no available types on the rows, it will return the configuration
for a display only editor.Parameters:
Name Type Description rows
Array.<module:nmodule/webEditors/rc/wb/table/model/Row> Returns:
- Type
- Object
-
getFlags()
-
Get the flags set on this column.
- Inherited From:
Returns:
- Type
- Number
-
getName()
-
Get the column name or
null
if none was given.- Inherited From:
Returns:
- Type
- String
-
getProposedValueFor(row)
-
Get the currently proposed value for the given row. If no value proposed
yet, will return the actual column value (getValueFor
).Parameters:
Name Type Description row
module:nmodule/webEditors/rc/wb/table/model/Row Returns:
- Type
- *
-
getValueFor(row)
-
Returns the baja.Type of the
Row
's subject as the value.Parameters:
Name Type Description row
module:nmodule/webEditors/rc/wb/table/model/Row Returns:
- Type
- baja.Type
-
hasFlags(flags)
-
Return true if the column has all of the given flags.
Parameters:
Name Type Description flags
Number flags to check for
- Inherited From:
Returns:
- Type
- Boolean
-
isEditable()
-
Return true if the column is editable.
- Inherited From:
Returns:
- Type
- Boolean
-
isEditorSuitable(editor, rows)
-
If an editor has already been built, it may be possible to reuse it,
simply loading in a new coalesced value rather than destroying and
rebuilding the existing editor.This function should return true if the editor is suitable to be reused
for the given rows. By default, will always return true.Parameters:
Name Type Description editor
module:nmodule/webEditors/rc/fe/baja/BaseEditor rows
Array.<module:nmodule/webEditors/rc/wb/table/model/Row> Returns:
- Type
- Boolean
-
isHidable()
-
Return true if the column should available in the table's show/hide context menu.
Defaults to true.- Inherited From:
Returns:
- Type
- Boolean
-
isReadonly()
-
Return true if the column is readonly.
- Inherited From:
Returns:
- Type
- Boolean
-
isSortable()
-
Returns a boolean indicating whether the column should not be sortable via the table headings.
Defaults to true.- Inherited From:
Returns:
- Type
- Boolean
-
isUnseen()
-
Return true if the column is unseen.
- Inherited From:
Returns:
- Type
- Boolean
-
mgrValidate(model, data [, params])
-
Allows this column to validate proposed changes.
Parameters:
Name Type Argument Description model
module:nmodule/webEditors/rc/wb/mgr/model/MgrModel the model to which we're about to apply changes.
data
Array an array of proposed changes to this column, one per
row in theMgrModel
. If a value in this array is null, no change has
been proposed for that row.params
Object <optional>
Properties
Name Type Argument Description editor
module:nmodule/webEditors/rc/fe/baja/BaseEditor <optional>
the editor from which the proposed values were read. Note that the editor
may have been used to edit other rows, so the editor's current value may
not match the proposed new values.- Inherited From:
Returns:
promise that resolves by default
- Type
- Promise
Example
Validating this column may require that I examine the changes I'm about to make to other columns as well.
MyMgrColumn.prototype.mgrValidate = function (model, data, params) { var that = this, rows = model.getRows(), otherColumn = model.getColumn('otherColumn'); //search through all MgrModel rows, and check to see that my proposed //change is compatible with the proposed change to another column. //say, i'm a "password" column, and the other column is a "password //scheme" column - i need to make sure that the proposed password is //considered valid by the proposed password scheme. for (var i = 0; i < rows.length; i++) { var row = rows[i], myValue = data[i], otherValue = otherColumn.getProposedValueFor(row); if (myValue === null) { //no changes proposed for this row, so nothing to validate. } if (!isCompatible(myValue, otherValue)) { return Promise.reject(new Error('incompatible values')); } } };
-
propose(value, row)
-
Set the proposed value for the
Row
. This will normally be the DynamicEnum
created by thecoalesceRows()
function.Parameters:
Name Type Description value
* row
module:nmodule/webEditors/rc/wb/table/model/Row Returns:
- Type
- Promise
-
setEditable(editable)
-
Set or unset the column's
EDITABLE
flag. Emits aflagsChanged
event.Parameters:
Name Type Description editable
boolean - Inherited From:
-
setFlags(flags)
-
Set the column's flags.
Parameters:
Name Type Description flags
Number - Inherited From:
Throws:
-
if a non-Number given
- Type
- Error
-
setHidable(hidable)
-
Set or unset whether the column should be allowed to be hidden or shown by the table's
show/hide context menu.Parameters:
Name Type Description hidable
boolean - Inherited From:
-
setReadonly(readonly)
-
Set or unset the column's
READONLY
flag. Emits aflagsChanged
event.Parameters:
Name Type Description readonly
boolean - Inherited From:
-
setSortable(sortable)
-
Set or unset whether the column should be allowed to be sorted by the table heading.
Parameters:
Name Type Description sortable
boolean - Inherited From:
-
setUnseen(unseen)
-
Set or unset the column's
UNSEEN
flag. Emits aflagsChanged
event.Parameters:
Name Type Description unseen
boolean - Inherited From:
-
toDisplayName()
-
Resolves a display name for this column.
- Inherited From:
Returns:
promise to be resolved when the element's display name
has been fully built. It's also acceptable for overrides of this function
to complete synchronously without returning a promise, so be sure to wrap
calls to this function inPromise.resolve()
when appropriate.- Type
- Promise | *