Moobile.View

Provides an area in which a user can interract. A view represents a page in your application.

Initialization

Syntax:

var view = new Moobile.View([element], [options], [name]);

Parameters:

Name	Type	Description
element Optional	Element	The view’s element, element id or html string.
options Optional	Object	The view’s options, see below.
name Optional	String	The view’s name.

Options:

Name	Type	Description
className	String	The view’s extended CSS class name, defaults to null.
styleName	String	The view’s default style, defaults to null.
tagName	String	The view’s element tag name, defaults to div.
layout	String	The view’s layout, either horizontal or vertical, defaults to vertical.

Generates:

<div class="view view-layout-vertical">
    <div data-role="content-wrapper" class="view-content-wrapper">
        <div data-role="content" class="view-content"></div>
    </div>
</div>

Defined roles:

Name	Description
view	Defines an element acting as a view. Use the data-view attribute to specify a subclass instead
content	Defines an element acting as a view’s content. If omitted, the contents of the view’s element will act as its view content.

Note:

Upon initialization, the view creates its content element using the view element’s content. For instance, if you create a view like this:

<div data-role="view">
    <div class="element-one"></div>
    <div class="element-two"></div>
</div>

The result will be:

<div data-role="view" class="view view-layout-vertical">
    <div data-role="content-wrapper" class="view-content-wrapper">
        <div data-role="content" class="view-content">
            <div class="element-one"></div>
            <div class="element-two"></div>
        </div>
    </div>
</div>

If you wish to put elements outside of the view’s content element, you will have to specify which element has the view-content role:

<div data-role="view">
    <div class="element-one"></div>
    <div data-role="content"></div>
    <div class="element-two"></div>
</div>

Also, the view will use the CSS class name either provided as either an option or directly in the element to generate the view content’s class name and append the -content suffix. For instance, if you create a view like this:

<div data-role="view" class="my-view">
</div>

The result will be:

<div data-role="view" class="view view-layout-vertical my-view">
    <div data-role="content-wrapper" class="view-content-wrapper">
        <div data-role="content" class="view-content my-view-content"></div>
    </div>
</div>

Subclassing Notes:

This class overrides the following method:

• willBuild: Call the parent method at the top of your implementation if you override this method.
• didBuild: Call the parent method at the top of your implementation if you override this method.
• destroy: Call the parent method at the bottom of your implementation if you override this method
• willAddChildComponent: Call the parent method at thetop` of your implementation if you override this method.
• willRemoveChildComponent: Call the parent method at thetop` of your implementation if you override this method.

Members

contentElement

The element that wraps the content of the view.

Type

• Element

contentWrapperElement

The element that wraps the content element of the view.

Type

• Element

Methods

enableTouch()

Enable touch interaction of the entire view and its hierarchy.

Returns:

• Moobile.View This Moobile.View instance.

---

disableTouch()

Disable touch interaction of the entire view and its hierarchy.

Returns:

• Moobile.View This Moobile.View instance.

---

getContentElement()

Returns the element that wraps the content of this view.

Returns:

• Element The view content element.

---

getContentWrapperElement()

Returns the element that wraps the content element of this view.

Returns:

• Element The view content element.

---

setLayout(layout)

Sets this view’s layout to either horizontal or vertical.

Parameters:

Name	Type	Description
layout	String	The view’s layout, either horizontal or vertical.

Returns:

• Moobile.View This Moobile.View instance.

---

getLayout()

Returns the view’s layout, either horizontal or vertical.

Returns:

• String The view’s layout, either horizontal or vertical.

---

willChangeLayout(layout)

Tell the view its layout is about to change.

Override this method to provide your own implementation.

Parameters:

Name	Type	Description
layout	String	The view’s layout.

---

didChangeLayout(layout)

Tell the view its layout changed.

Override this method to provide your own implementation.

Parameters:

Name	Type	Description
layout	String	The view’s layout.

Other

These methods are added to the Moobile.Component class:

setParentView(parentView)

Sets the parent view of this component.

This method is handled by the Moobile.View class and should not be called manually.

Parameters:

Name	Type	Description
parent	Moobile.Component	The parent.

Returns:

• Moobile.Component This Moobile.Component instance.

---

getParentView()

Returns the parent view of this component.

Returns:

• Moobile.View The parent component.

---

parentViewWillChange(parentView)

Tell the view it’s about to be moved to a new view.

Override this method to provide your own implementation.

Parameters:

Name	Type	Description
parentView	Moobile.View	The view that is about to become the parent view of this view.

---

parentViewDidChange(parentView)

Tell the view it has been moved to a new view.

Override this method to provide your own implementation.

Parameters:

Name	Type	Description
parentView	Moobile.View	The view that is about to become the parent view of this view.