Mercurial > hg > MPIWGThesaurus
diff jquery-ui/development-bundle/docs/position.html @ 0:b2e4605f20b2
beta version
| author | dwinter |
|---|---|
| date | Thu, 30 Jun 2011 09:07:49 +0200 |
| parents | |
| children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/jquery-ui/development-bundle/docs/position.html Thu Jun 30 09:07:49 2011 +0200 @@ -0,0 +1,227 @@ + +<ul class="UIAPIPlugin-toc"> +<li><a href="#overview">Overview</a></li> +<li><a href="#options">Arguments</a></li> +</ul> +<div class="UIAPIPlugin"> + <h1>jQuery UI Position Utility</h1> + <div id="overview"> + <h2 class="top-header">Overview</h2> + <div id="overview-main"> + <p>Utility script for positioning any widget relative to the window, document, a particular element, or the cursor/mouse.</p> +<p><em>Note: jQuery UI does not support positioning hidden elements.</em></p> +<p>Does not need ui.core.js or effects.core.js.</p> + </div> + <div id="overview-dependencies"> + <h3>Dependencies</h3> + <ul> +<li><i>none (only jQuery core)</i></li> +</ul> + </div> + <div id="overview-example"> + <h3>Example</h3> + <div id="overview-example" class="example"> +<ul><li><a href="#demo"><span>Demo</span></a></li><li><a href="#source"><span>View Source</span></a></li></ul> +<p><div id="demo" class="tabs-container" rel="300"> +Clicking on the green element transfers to the other.<br /> +</p> +<pre> +$("#position1").position({ + my: "center", + at: "center", + of: "#targetElement" +}); +$("#position2").position({ + my: "left top", + at: "left top", + of: "#targetElement" +}); +$("#position3").position({ + my: "right center", + at: "right bottom", + of: "#targetElement" +}); +$(document).mousemove(function(ev){ + $("#position4").position({ + my: "left bottom", + of: ev, + offset: "3 -3", + collision: "fit" + }); +}); + +</pre> +<p></div><div id="source" class="tabs-container"> +</p> +<pre><!DOCTYPE html> +<html> +<head> + <link href="http://ajax.googleapis.com/ajax/libs/jqueryui/1.8/themes/base/jquery-ui.css" rel="stylesheet" type="text/css"/> + <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script> + <script src="http://ajax.googleapis.com/ajax/libs/jqueryui/1.8/jquery-ui.min.js"></script> + <style type="text/css"> +#targetElement { width:240px;height:200px;background-color:#999;margin:30px auto; } +.positionDiv { width:50px;height:50px;opacity:0.6; } +#position1 {background-color:#F00;} +#position2 {background-color:#0F0;} +#position3 {background-color:#00F;} +#position4 {background-color:#FF0;} +</style> + + <script> + $(document).ready(function() { + +$("#position1").position({ + my: "center", + at: "center", + of: "#targetElement" +}); +$("#position2").position({ + my: "left top", + at: "left top", + of: "#targetElement" +}); +$("#position3").position({ + my: "right center", + at: "right bottom", + of: "#targetElement" +}); +$(document).mousemove(function(ev){ + $("#position4").position({ + my: "left bottom", + of: ev, + offset: "3 -3", + collision: "fit" + }); +}); + + }); + </script> +</head> +<body style="font-size:62.5%;"> + +<div id="targetElement"> + <div class="positionDiv" id="position1"></div> + <div class="positionDiv" id="position2"></div> + <div class="positionDiv" id="position3"></div> + <div class="positionDiv" id="position4"></div> +</div> + +</body> +</html> +</pre> +<p></div> +</p><p></div> + </div> + </div> + <div id="options"> + <h2 class="top-header">Arguments</h2> + <ul class="options-list"> + +<li class="option" id="option-my"> + <div class="option-header"> + <h3 class="option-name"><a href="#option-my">my</a></h3> + <dl> + <dt class="option-type-label">Type:</dt> + <dd class="option-type">String</dd> + + </dl> + </div> + <div class="option-description"> + <p>Defines which position on <b>the element being positioned</b> to align with the target element: "horizontal vertical" alignment. A single value such as "right" will default to "right center", "top" will default to "center top" (following CSS convention). Acceptable values: "top", "center", "bottom", "left", "right". Example: "left top" or "center center"</p> + </div> +</li> + + +<li class="option" id="option-at"> + <div class="option-header"> + <h3 class="option-name"><a href="#option-at">at</a></h3> + <dl> + <dt class="option-type-label">Type:</dt> + <dd class="option-type">String</dd> + + </dl> + </div> + <div class="option-description"> + <p>Defines which position on <b>the target element</b> to align the positioned element against: "horizontal vertical" alignment. A single value such as "right" will default to "right center", "top" will default to "center top" (following CSS convention). Acceptable values: "top", "center", "bottom", "left", "right". Example: "left top" or "center center"</p> + </div> +</li> + + +<li class="option" id="option-of"> + <div class="option-header"> + <h3 class="option-name"><a href="#option-of">of</a></h3> + <dl> + <dt class="option-type-label">Type:</dt> + <dd class="option-type">Selector, Element, jQuery, Event</dd> + + </dl> + </div> + <div class="option-description"> + <p>Element to position against. If you provide a selector, the first matching element will be used. If you provide a jQuery object, the first element will be used. If you provide an event object, the pageX and pageY properties will be used. Example: "#top-menu"</p> + </div> +</li> + + +<li class="option" id="option-offset"> + <div class="option-header"> + <h3 class="option-name"><a href="#option-offset">offset</a></h3> + <dl> + <dt class="option-type-label">Type:</dt> + <dd class="option-type">String</dd> + + </dl> + </div> + <div class="option-description"> + <p>Add these left-top values to the calculated position, eg. "50 50" (left top) A single value such as "50" will apply to both.</p> + </div> +</li> + + +<li class="option" id="option-collision"> + <div class="option-header"> + <h3 class="option-name"><a href="#option-collision">collision</a></h3> + <dl> + <dt class="option-type-label">Type:</dt> + <dd class="option-type">String</dd> + + </dl> + </div> + <div class="option-description"> + <p>When the positioned element overflows the window in some direction, move it to an alternative position. Similar to my and at, this accepts a single value or a pair for horizontal/vertical, eg. "flip", "fit", "fit flip", "fit none". +</p> +<ul><li> <b>flip</b>: to the opposite side and the collision detection is run again to see if it will fit. If it won't fit in either position, the center option should be used as a fall back. +</li><li> <b>fit</b>: so the element keeps in the desired direction, but is re-positioned so it fits. +</li><li> <b>none</b>: not do collision detection. +</li></ul> +<p></p> + </div> +</li> + + +<li class="option" id="option-using"> + <div class="option-header"> + <h3 class="option-name"><a href="#option-using">using</a></h3> + <dl> + <dt class="option-type-label">Type:</dt> + <dd class="option-type">Function</dd> + + </dl> + </div> + <div class="option-description"> + <p>When specified the actual property setting is delegated to this callback. Receives a single parameter which is a hash of top and left values for the position that should be set.</p> + </div> +</li> + + </ul> + </div> +</div> + +</p><!-- +Pre-expand include size: 7124 bytes +Post-expand include size: 11012 bytes +Template argument size: 7642 bytes +Maximum: 2097152 bytes +--> + +<!-- Saved in parser cache with key jqdocs_docs:pcache:idhash:3784-1!1!0!!en!2 and timestamp 20110315194632 -->