Clear Up
SharpKit Reference

MobileOptions Class

The following defaults are configurable via the $.mobile object:

Namespace: SharpKit.jQueryMobile

Base Types

System.Object

Constructors

Name Description
MobileOptions()

Properties

Name Description
activeBtnClass default: "ui-page-active" The class used for "active" button state, from CSS framework.
activePageClass default: "ui-page-active" The class assigned to page currently in view, and during transitions activeBtnClass string, default: "ui-page-active" The class used for "active" button state, from CSS framework.
ajaxEnabled default: true jQuery Mobile will automatically handle link clicks and form submissions through Ajax, when possible. If false, url hash listening will be disabled as well, and urls will load as regular http requests.
allowCrossDomainPages default: false When jQuery Mobile attempts to load an external page, the request runs through $.mobile.loadPage(). This will only allow cross-domain requests if $.mobile.allowCrossDomainPages is set to true. Because the jQuery Mobile framework tracks what page is being viewed within the browser's location hash, it is possible for a cross-site scripting (XSS) attack to occur if the XSS code in question can manipulate the hash and set it to a cross-domain URL of its choice. This is the main reason that the default setting for $.mobile.allowCrossDomainPages is set to false. In PhoneGap apps that must "phone home" by loading assets off a remote server, both the $.support.cors AND $.mobile.allowCrossDomainPages must be set to true.
autoInitializePage default: true When the DOM is ready, the framework should automatically call $.mobile.initializePage. If false, page will not initialize, and will be visually hidden until until $.mobile.initializePage is manually called.
buttonMarkup
defaultDialogTransition default: 'pop' Set the default transition for dialog changes that use Ajax. Set to 'none' for no transitions by default.
defaultPageTransition default: 'slide' Set the default transition for page changes that use Ajax. Set to 'none' for no transitions by default.
gradeA default: a function returning the value of $.support.mediaquery Any support conditions that must be met in order to proceed.
hashListeningEnabled default: true jQuery Mobile will automatically listen and handle changes to the location.hash. Disabling this will prevent jQuery Mobile from handling hash changes, which allows you to handle them yourself, or simply to use simple deep-links within a document that scroll to a particular ID.
ignoreContentEnabled default: false Warning: Setting this property to true will cause performance degradation on enhancement. Once set, all automatic enhancements made by the framework to each enhanceable element of the user's markup will first check for a data-enhance=false parent node. If one is found the markup will be ignored. This setting and the accompanying data attribute provide a mechanism through which users can prevent enhancement over large sections of markup.
linkBindingEnabled default: true jQuery Mobile will automatically bind the clicks on anchor tags in your document. Setting this options to false will prevent all anchor click handling including the addition of active button state and alternate link bluring. This should only be used when attempting to delegate the click management to another library or custom code.
loadingMessage default: "loading" Set the text that appears when a page is loading. If set to false, the message will not appear at all.
loadingMessageTextVisible default: false Whether the text should be visible when a loading message is shown. The text is always visible for loading errors.
loadingMessageTheme default: "a" The theme that the loading message box uses when text is visible.
minScrollBack string, default: 150 Minimum scroll distance that will be remembered when returning to a page.
ns default: "" The namespace used in data- attributes, for example, data-role. Can be set to anything, including a blank string which is the default. When using, it's clearest if you include a trailing dash, such as "mynamespace-" which maps to data-mynamespace-foo="...". NOTE: if you're using data- namespacing, you'll need to manually update/override one selector in the theme CSS. The following data selectors should incorporate the namespace you're using:
pageLoadErrorMessage default: "Error Loading Page" Set the text that appears when a page fails to load through Ajax.
pageLoadErrorMessageTheme default: "e" Set the theme that the error message box uses.
pushStateEnabled default: true Enhancement to use history.replaceState in supported browsers, to convert the hash-based Ajax URL into the full document path. Note that we recommend disabling this feature if Ajax is disabled or if extensive use of external links are used.
subPageUrlKey default: "ui-page" The url parameter used for referencing widget-generated sub-pages (such as those generated by nested listviews). Translates to to example.html&ui-page&subpageIdentifier. The hash segment before &ui-page& is used by the framework for making an Ajax request to the URL where the sub-page exists.
touchOverflowEnabled Deprecated in 1.1.0 Enable smoother page transitions and true fixed toolbars in devices that support both the overflow: and overflow-scrolling: touch; CSS properties.
© Copyright 2005-2011 SharpKit. All rights reserved.