|
<!--
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>Getting CSS Style Sheets</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/button/assets/skins/sam/button.css" />
<script type="text/javascript" src="yui_2.7.0b-lib/yuiloader-dom-event/yuiloader-dom-event.js"></script>
<script type="text/javascript" src="yui_2.7.0b-lib/element/element-min.js"></script>
<script type="text/javascript" src="yui_2.7.0b-lib/button/button-min.js"></script>
<!--begin custom header content for this example-->
<style type="text/css" id="styleoverrides">
#container .hd {
background-image:url(http://us.i1.yimg.com/us.yimg.com/i/us/nt/ma/ma_nws_1.gif);
background-position:top right;
background-repeat:no-repeat;
background-color:none;
}
#container h2 {
border:none;
margin-top:0;
}
#container h3 {
color:#999999;
}
#buttonContainer {
padding-bottom:.5em;
}
#container .module {
padding:.5em 1em 1em 1em;
overflow:hidden;
}
/*
When we load the new CSS files, these files will be loaded above this style block.
If we need to override any styles supplied by the new CSS files, we can do this
here. For instance, this is useful if you are loading YUI skin files dynamically,
but want to override some of the styles.
*/
</style>
<!--end custom header content for this example-->
</head>
<body class=" yui-skin-sam">
<h1>Getting CSS Style Sheets</h1>
<div class="exampleIntro">
<p><a href="http://developer.yahoo.com/yui/get">The YUI Get Utility</a> can be
used to fetch CSS stylesheets after the page has loaded. This allows you to
reduce the size of your "main" stylesheet by segregating the style rules for
specific modules that may not be displayed when the page is first rendered.
Once the module is needed, you can bring in the CSS (and JavaScript)
dynamically using the Get Utility.</p>
<p>The example below demonstrates the dynamic addition and removal of three
stylesheets that change the appearance of the News module. By clicking on the
buttons (which make use of the <a
href="http://developer.yahoo.com/yui/button/">YUI Button Control</a>), you can
add/remove border, background, and font treatments for the module.
(<strong>Note:</strong> The News module itself is built using the Get Utility
to fetch JSON data from the <a
href="http://developer.yahoo.com/search/news/V1/newsSearch.html">Yahoo! News
Search web service</a>; it follows the same code pattern described in the <a
href="get-script-basic.html">"Getting a Script Node with JSON Data"</a>
example.) </p>
</div>
<!--BEGIN SOURCE CODE FOR EXAMPLE -->
<div id="container">
<div id="buttonContainer">
<!--YUI Button instances, created from script, will go here.-->
</div>
<div class="module">
<div class="hd"><h2>In the News:</h2></div>
<div class="bd" id="results">
<!--News stories will be displayed here.-->
</div>
<div class="ft">
<div id="searchControls">
<!--Use a real form that works without JavaScript:-->
<form method="GET" action="http://search.yahooapis.com/NewsSearchService/V1/newsSearch" id="newsSearch">
<label for="searchString">Search Yahoo! News:</label> <input type="text" name="p" id="searchString" value="San Francisco" size="40">
<input type="submit" id="getNewsData" value="Search Yahoo! News">
</form>
</div>
</div>
</div>
</div>
<script language="javascript">
// Encapsulating our code in a self-executing anonymous function
// is one way to create a namespace:
(function() {
// shortcuts and other variables:
var Button = YAHOO.widget.Button,
Event = YAHOO.util.Event,
Dom = YAHOO.util.Dom,
Get = YAHOO.util.Get,
elContainer = Dom.get("container"),
tIds = {};
// YUI Buttons are attractive and effective for "call to action"
// tasks like the one here. We'll create buttons purely from
// JavaScript; there's no need for this style-change functionality
// to be "accessible"; in fact, it's purely cosmetic, so keeping
// these buttons out of the page's initial DOM is preferable. We'll
// use the "name" property of the button to determine what CSS to
// load when each button is clicked:
var borderButton = new Button({
id: "borderButton",
type: "checkbox",
name: "border",
label: "Border CSS",
container: "buttonContainer"
});
var backgroundButton = new Button({
id: "backgroundButton",
type: "checkbox",
name: "background",
label: "Background CSS",
container: "buttonContainer"
});
var textButton = new Button({
id: "textButton",
type: "checkbox",
name: "text",
label: "Text CSS",
container: "buttonContainer"
});
// Making available outside the anonymous function so these can be
// introspected in FireBug if desired:
YAHOO.example.buttons = [borderButton, backgroundButton, textButton];
// Checkbox buttons are either checked or unchecked; when their state
// changes, their "onCheckedChange" event fires. We'll use that
// event to trigger the loading and unloading of CSS using the Get
// Utility.
var onCheckedChange = function() {
//Which button was actuated?
var name = this.get("name");
//The button's checked state has already been updated, so if
//true we load the necessary CSS:
if(this.get("checked")) {
// We'll use the 'data' parameter to pass through the name
// of the CSS file to our onSuccess handler. This allows
// us to have access to the purge method when we want
// to remove the CSS.
//
// In addition, we use the 'insertBefore' property to specify
// the id of a style block we want to insert the new nodes
// before. By doing this, we can ensure that any style overrides
// for the dynamically loaded CSS will be applied in the correct
// order.
Get.css("yui_2.7.0b-assets/get-assets/" + name + ".css", {
data: name,
insertBefore: "styleoverrides",
onSuccess: onSuccess
});
} else {
// In onSuccess, we save a reference to the callback object
// in an associative array (tIds) indexed by the CSS name. That
// allows us here, when the CSS needs to be removed, to simply
// call the purge method corresponding to the item we want to
// remove. Purge clears all the link nodes that were created
// as part of the transaction (in this case, just a single
// link node).
tIds[this.get("name")].purge();
YAHOO.log("CSS was successfully purged; our object containing transaction ids now looks like this: " + YAHOO.lang.dump(tIds, 1), "info", "example");
// Some A-Grade browsers won't repaint automatically when CSS link nodes
// are removed. You can nudge these browsers to repaint by adding
// a blank CSS stylesheet to the page:
Get.css("yui_2.7.0b-assets/get-assets/neutral.css");
}
};
// Now we can subscribe our onCheckedChange function to each
// of our three YUI Buttons' "checkedChange" event:
borderButton.on("checkedChange", onCheckedChange);
backgroundButton.on("checkedChange", onCheckedChange);
textButton.on("checkedChange", onCheckedChange);
// As noted above, in onSuccess we want to save the callback
// object in an associative array indexed by CSS file name so that
// we can purge the link nodes later if the CSS file needs to be
// removed.
var onSuccess = function(o) {
tIds[o.data] = o;
YAHOO.log("CSS was successfully returned; our object containing transaction ids now looks like this: " + YAHOO.lang.dump(tIds, 1), "info", "example");
}
})();
</script>
<script src="yui_2.7.0b-assets/get-assets/getNews.js" type="text/javascript"></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)