jQuery UI API - .position()

カテゴリ

メソッドのオーバーライド(Method Overrides) | メソッド(Methods) | ユーティリティ(Utilities)

使用方法

説明:別の要素を基準にして要素を配置(position)します。

戻り値:jQuery

追加されたバージョン:1.8

.position( options )

パラメータ 型 説明
options Object
  • my(デフォルト値:"center")
    型:String
    説明:定義配置される要素上配置される要素上でターゲット要素に合わせる位置を定義します:"horizontal vertical" の配置方法。単一の値(例:"right")は "right center" に、"top" は "center top" に正規化されます(下記のCSS規約に基づきます)。使用可能な水平方向の値:"left"、"center"、"right"。使用可能な垂直方向の値:"top"、"center"、"bottom"。例:"left top" または "center center"。各ディメンションにはオフセットを含めることもできます。ピクセルまたはパーセンテージで指定します(例:"right+10 top-25%")。パーセンテージのオフセットは配置される要素が基準です。
  • at(デフォルト値:"center")
    型:String
    説明:定義ターゲット要素上ターゲット要素上で配置される要素に合わせる位置を定義します:"horizontal vertical" の配置方法。詳細は my オプションの可能値を参照してください。パーセンテージのオフセットはターゲット要素が基準です。
  • of(デフォルト値:null)
    型:Selector、Element、jQuery、または Event
    配置する要素。セレクター(Selector)またはjQueryオブジェクトを指定した場合は、最初に一致した要素が使用されます。イベント(Event)オブジェクトを指定した場合は、pageX プロパティと pageY プロパティが使用されます。例:"#top-menu"。
  • collision(デフォルト値:"flip")
    型:String
    配置される要素が特定の方向でウィンドウからはみ出す場合、別の位置に移動します。my オプションや at オプションと同様に、このオプションは単一の値、または horizontal/vertical のペアを受け付けます。例:"flip"、"fit"、"fit flip"、"fit none"。
    • "flip":要素をターゲットの反対側に反転し、コリジョン(collision)検出を再度実行して要素が収まるかを確認します。より多くの要素が見える方の辺を使用します。
    • "fit":要素をウィンドウの端から移動します。
    • "flipfit":最初に flip ロジックを適用して、要素をより多く見える側に配置します。次に fit ロジックを適用して、できるだけ多くの要素が見えるようにします。
    • "none":collision(コリジョン)検出を一切適用しません。
  • using(デフォルト値:null)
    型:Function()
    このオプションを指定すると、実際のプロパティ設定はこのコールバックに委譲されます。このコールバックは2つの引数を受け取ります。1つ目は、.css() や .animate() に転送できる top と left の値を持つハッシュです。2つ目は、2つの要素の位置とサイズに関するフィードバックを提供し、それらの相対位置も計算します。target と element は両方とも次のプロパティを持ちます:element、left、top、width、height。さらに、horizontal、vertical、important は、12の可能な方向について同様の情報を提供します。例:{ horizontal: "center", vertical: "left", important: "horizontal" }。
  • within(デフォルト値:window)
    型:Selector、Element、または jQuery
    配置の基準となる要素(within)を指定します。collision(コリジョン)検出に影響します。セレクター(Selector)またはjQueryオブジェクトを指定した場合は、最初に一致した要素が使用されます。

jQuery UI .position()このメソッドを使うと、ウィンドウ(window)、ドキュメント(document)、別の要素、またはカーソル(cursor)/マウス(mouse)を基準にして要素を配置できます。親要素のオフセット(offset)を考慮する必要はありません。

注:jQuery UIは非表示要素の配置(position)をサポートしていません。

これはスタンドアロンのjQueryプラグインであり、他のjQuery UIコンポーネントへの依存関係はありません。

このプラグインは、jQuery組み込みの.position()メソッドを拡張したものです。jQuery UIが読み込まれていない場合、.position()メソッドを呼び出しても直接失敗しません。そのメソッドはjQuery内に存在するためです。ただし、期待される動作は行われません。

例

jQuery UI の配置(Position)の簡単な例。

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>.position() 实例</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <style>
  .positionDiv {
    position: absolute;
    width: 75px;
    height: 75px;
    background: green;
  }
  </style>
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<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>
 
<script>
$( "#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( event ) {
  $( "#position4" ).position({
    my: "left+3 bottom-3",
    of: event,
    collision: "fit"
  });
});
</script>
 
</body>
</html>

その他の拡張