APIs

Show:

Methods

bindToModel

(
  • [model]
)
Undefined

Binds the view to a Model. will explain more later.

Parameters:

  • [model] awa.mvc.Model | Backbone.Model optional

    Model to bind to

Returns:

Undefined:

destroy

() awa.mvc.View

clears out all widgets, grids, and events. Also removes and destroys children

Returns:

awa.mvc.View:

this

doChildrenLayouts

() Undefined

Needed for height fixing and other positioning changes

Returns:

Undefined:

doLayout

() Undefined

Needed for height fixing and other positioning changes

Returns:

Undefined:

getWidget

() Array

get the view controlling a widget by it's selector

Returns:

Array:

widgets

onAddInventory

() type

Called when the user clicks the + Inventory button.

Returns:

type:

[description]

onEditInventory

(
  • id
)
type

Called when the user removes an inventory item in the grid.

Parameters:

  • id Integer

    primary key

Returns:

type:

[description]

onRemoveInventory

(
  • event
)
type

Called when the user removes an inventory item in the grid.

Parameters:

  • event Object

    [description]

Returns:

type:

[description]

onRendered

(
  • callback
  • context
)
Undefined

This is called only once in the lifetime of a view, if you bind to it before the view is rendered, the function will be called after triggerRendered is called.

Parameters:

  • callback Function

    Callback

  • context Object

    Defines scope of callback

Returns:

Undefined:

onTransmitImmunizations

() type

Called when the user clicks the Transmit button.

Transmits the patient's immunizations to a registry.

Returns:

type:

[description]

popup

(
  • [createArgs]
)
Object

Parameters:

  • [createArgs] Object optional

    arguments used on creation of popup

    • [controlsOnTop] Boolean optional

      defaults to false

    • [x] Integer optional

      defaults to false

    • [y] Integer optional

      defaults to false

    • [onRender] Function optional

      defaults to false

Returns:

Object:

popup

refresh

() type

Refreshes the grid

Returns:

type:

[description]

requestChange

(
  • callback
)
Undefined

Parent views should check this before changing/swapping a view. Useful for views that are in edit mode that you want to do confirmation before leaving.

Parameters:

  • callback Function

    function to call when you have determined if the view can close or not. If it can close, return an object with property 'success' set to 1.

Returns:

Undefined:

requestClose

(
  • callback
)
Undefined

Parent views should check this before closing a view. Useful for views that are in edit mode that you want to do confirmation before closing.

Parameters:

  • callback Function

    function to call when you have determined if the view can close or not. If it can close, return an object with property 'success' set to 1.

Returns:

Undefined:

setElement

(
  • element
  • [delegate]
)
Undefined

Overidden setElement method applies the className to the new element the view is applied to. Also, if multiple views are passed in (what is returned from a jquery selector) it will be the top of the list.

Parameters:

  • element Jquery.Selector

    Jquery selector

  • [delegate] ? optional

    ?

Returns:

Undefined:

triggerRendered

(
  • args
)
Undefined

The view should only call this once its completely rendered. This does not include refreshing views (i.e. grids changing pages). This also sets the view's rendered property to true.

Parameters:

  • args Object

    parameter to emit

Returns:

Undefined:

viewOptions

() Array

the constructor uses this function to determine which properties to pull out of the passed in options to directly attach to the view. All other options can be referenced from the view's options property

Returns:

Array:

Acceptable view options

Properties

__parent__

View

Parent view object

Default: undefined

className

Boolean | Function

when this view is rendered, it will create a new element with this class added. If the setElement method is used, this will append itself to the class attribute

Default: "awa-mvc-View"

closeOnReplace

Boolean

Mostly for views that contain multiple views. This allows a parent view to know that the view should be closed and destroyed when another view is swapped in.

Default: false

controlsView

awa.mvc.ControlsView

reference to this contentsView's main controls view. Subsequent controls view will have to be managed another way.

Default: undefined

globalKeys

Object

used for the keymaster plugin. These will be scoped to the entire app.

Default: undefined

keys

Object

used for the keymaster plugin. These will be scoped to this view in the future.

Default: undefined

ModelClass

Constructor

provide model class to derive information from and to fill data

Default: undefined

refreshOnReplace

Boolean

Mostly for views that contain multiple views. This allows a parent view to know that the view should be refreshed when this view is swapped back in.

Default: true

rendered

Boolean

Lets you know if this view object has been rendered or not. If you override the render method without doing a supercall, be sure to set it to true when you are done rendering.

Default: false

title

Strin

Can be used by parent views to put on tabs, control bars, popup headers, etc. Use accessor methods.

Default: "View"

tpl

Function

default template to use with this view, the render method will use this and inject the resulting html into it's $el.

Default: undefined

tplArgs

Object

arguments that are passed to the template

Default: undefined

viewDescription

String

Description for use of view. May also explain a concept. Intended for the user. If set, the content view rendering process will decide where to place his content if needed.

Default: undefined