Use Browser History Manager to remember which months have been viewed and update it when the user presses the browser's back/forward buttons. : Browser History « YUI Library « JavaScript DHTML






Use Browser History Manager to remember which months have been viewed and update it when the user presses the browser's back/forward buttons.

 

<!--
Software License Agreement (BSD License)
Copyright (c) 2009, Yahoo! Inc.
All rights reserved.

Redistribution and use of this software in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

    * Redistributions of source code must retain the above copyright notice, this list of conditions and the
      following disclaimer.
    * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
    * Neither the name of Yahoo! Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission of Yahoo! Inc.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Sources of Intellectual Property Included in the YUI Library

YUI is issued by Yahoo! under the BSD license above. Below is a list of certain publicly available software that is the source of intellectual property in YUI, along with the licensing terms that pertain to thosesources of IP. This list is for informational purposes only and is not intended to represent an exhaustive list of third party contributions to the YUI.

    * Douglas Crockford's JSON parsing and stringifying methods: In the JSON Utility, Douglas Crockford's JSON parsing and stringifying methods are adapted from work published at JSON.org. The adapted work is in the public domain.
    * Robert Penner's animation-easing algorithms: In the Animation Utility, YUI makes use of Robert Penner's algorithms for easing.
    * Geoff Stearns's SWFObject: In the Charts Control and the Uploader versions through 2.7.0, YUI makes use of Geoff Stearns's SWFObject v1.5 for Flash Player detection and embedding. More information on SWFObject can be found here (http://blog.deconcept.com/swfobject/). SWFObject is (c) 2007 Geoff Stearns and is released under the MIT License (http://www.opensource.org/licenses/mit-license.php).
    * Diego Perini's IEContentLoaded technique: The Event Utility employs a technique developed by Diego Perini and licensed under GPL. YUI's use of this technique is included under our BSD license with the author's permission.

-->

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>


    <meta http-equiv="content-type" content="text/html; charset=utf-8">
<title>Calendar Control</title>

<style type="text/css">
/*margin and padding on body element
  can introduce errors in determining
  element position and are not recommended;
  we turn them off as a foundation for YUI
  CSS treatments. */
body {
  margin:0;
  padding:0;
}
</style>

<link rel="stylesheet" type="text/css" href="yui_2.7.0b-lib/fonts/fonts-min.css" />
<link rel="stylesheet" type="text/css" href="yui_2.7.0b-lib/calendar/assets/skins/sam/calendar.css" />
<script type="text/javascript" src="yui_2.7.0b-lib/yahoo-dom-event/yahoo-dom-event.js"></script>
<script type="text/javascript" src="yui_2.7.0b-lib/calendar/calendar-min.js"></script>
<script type="text/javascript" src="yui_2.7.0b-lib/history/history-min.js"></script>

<!--there is no custom header content for this example-->

</head>

<body class=" yui-skin-sam">


<h1>Calendar Control</h1>

<div class="exampleIntro">
  <p>
  This example demonstrates how to use the Browser History Manager
  to remember which months have been viewed with the calendar widget
  and dynamically update it when the user presses the browser's
  back/forward buttons.
</p>
      
</div>

<!--BEGIN SOURCE CODE FOR EXAMPLE  -->

<style>

#yui-history-iframe {
  position:absolute;
  top:0; left:0;
  width:1px; height:1px; /* avoid scrollbars */
  visibility:hidden;
}

</style>

<!-- Static markup required by the browser history utility. Note that the
     iframe is only used on Internet Explorer. If this page is server
     generated (by a PHP script for example), it is a good idea to create
     the IFrame ONLY for Internet Explorer (use server side user agent sniffing) -->

<iframe id="yui-history-iframe" src="yui_2.7.0b-assets/history-assets/blank.html"></iframe>
<input id="yui-history-field" type="hidden">

<!-- Static markup required for the calendar widget. -->
<div id="container">
  <div id="calendarContainer"></div>
</div>

<script>

(function () {

    // The initial month will be chosen in the following order:
    //
    // URL fragment identifier (it will be there if the user previously
    // bookmarked the application in a specific state)
    //
    //         or
    //
    // today's corresponding month (default)

    var today = new Date();
    var defaultCalendarState = (today.getMonth() + 1) + "_" + today.getFullYear();
    var bookmarkedCalendarState = YAHOO.util.History.getBookmarkedState("calendar");
    var initialCalendarState = bookmarkedCalendarState || defaultCalendarState;

    var calendar;

    // Register our calendar module. Module registration MUST
    // take place before calling YAHOO.util.History.initialize.
    YAHOO.util.History.register("calendar", initialCalendarState, function (state) {
        // This is called after calling YAHOO.util.History.navigate, or after the user
        // has trigerred the back/forward button. We cannot discrminate between
        // these two situations.

        // Show the right month according to the "state" parameter:
        calendar.cfg.setProperty("pagedate", state.replace("_", "/"));
        calendar.render();
    });

    function handleCalendarBeforeRender () {
        var calDate, newState, currentState;

        calDate = calendar.cfg.getProperty("pageDate");
        newState = (calDate.getMonth() + 1) + "_" + calDate.getFullYear();

        try {
            currentState = YAHOO.util.History.getCurrentState("calendar");
            // The following test is crucial. Otherwise, we end up circling forever.
            // Indeed, YAHOO.util.History.navigate will call the module onStateChange
            // callback, which will call createCalendar, which will call calendar.render(),
            // which will end up calling handleCalendarBeforeRender, and it keeps going
            // from here...
            if (newState !== currentState) {
                YAHOO.util.History.navigate("calendar", newState);
            }
        } catch (e) {
            calendar.cfg.setProperty("pagedate", newState.replace("_", "/"));
            calendar.render();
        }
    }

    function initCalendar (startDate) {
        // Instantiate the calendar control...
        calendar = new YAHOO.widget.Calendar("calendar", "calendarContainer", startDate);
        calendar.beforeRenderEvent.subscribe(handleCalendarBeforeRender, calendar, true);
        calendar.render();
    }

    // Use the Browser History Manager onReady method to instantiate the calendar widget.
    YAHOO.util.History.onReady(function () {
        var currentState;
        // This is the tricky part... The onLoad event is fired when the user
        // comes back to the page using the back button. In this case, the
        // actual month that needs to be loaded corresponds to the last month
        // visited before leaving the page, and not the initial month. This can
        // be retrieved using getCurrentState:
        currentState = YAHOO.util.History.getCurrentState("calendar");
        initCalendar({ pagedate: currentState.replace("_", "/") });
    });

    // Initialize the browser history management library.
    try {
        YAHOO.util.History.initialize("yui-history-field", "yui-history-iframe");
    } catch (e) {
        // The only exception that gets thrown here is when the browser is
        // not supported (Opera, or not A-grade) Degrade gracefully.
        initCalendar({ pagedate: initialCalendarState.replace("_", "/") });
    }

})();

</script>

<!--END SOURCE CODE FOR EXAMPLE  -->

</body>
</html>
<!-- presentbright.corp.yahoo.com uncompressed/chunked Thu Feb 19 10:53:15 PST 2009 -->

   
  








yui_2.7.0b.zip( 4,431 k)

Related examples in the same category

1.Integrating Browser History Manager with Server-side Pagination and Sorting
2.Use Browser History Manager to remember which tabs have been visited
3.Use the Browser History Manager with several different modules.