$.mobile.changePage ignores pageContainer option in JQM 1.4.0RC1

[nonplus]

The refactored (deprecated) $.mobile.changePage method in JQM 1.4, no longer pays attention to the pageContainer specified via options. Thus, the following call will ignore the specified pageContainer:

$.mobile.changePage(to, { pageContainer: $myContainer });

The bug is in jquery.mobile.navigation.js:

Current (wrong) implementation:

    $.mobile.changePage = function( to, options ) {
        $.mobile.pageContainer.pagecontainer( "change", to, options );
    };

This could be fixed like so:

    $.mobile.changePage = function( to, options ) {
        var settings = options || {};
        (settings.pageContainer || $.mobile.pageContainer).pagecontainer( "change", to, options );
    };

Sorry, I don't have a test page for this (not easy to simplify our code...)

[jonas-db]

As this method is deprecated i don't think you should use it anymore.. but i'm also still using it as i don't know the alternative. Can somebody elaborate this?

[nonplus]

Deprecation simply means that the feature will likely be removed in the future - you should be able to expect for it to still work correctly in the current version.

It's unfortunately that API documentation has not been updated for 1.4 - makes it kind of hard to decide what's a bug v.s. unsupported feature that has not been removed yet.

BTW, the workaround for $.mobile.changePage() is to call pagecontainer( "change", to, options ) on the PageContainer widget. If you use the default container, you would call $.mobile.pageContainer.pagecontainer( "change", to, options ).

[gabrielschulhof]

@nonplus is correct - the pageContainer option of the $.mobile.changePage function's options hash should be honoured during the deprecation period. Nevertheless, you can, of course, use the non-deprecated code, wherein you would call .pagecontainer( "change", ... ) on your pagecontainer widget of choice.