عرض مصدر jQuery/position

<noinclude>{{DISPLAYTITLE:التابع <code>‎‎.position()‎</code>‎ في jQuery}}</noinclude>
= <code>‎.position()‎</code> =

=== القيم المعادة ===
يعيد كائنًا من النوع [[jQuery/jQuery|jQuery]].

=== الوصف ===
يجلب هذا التابع الإحداثيات الحالية للعنصر الأول في المجموعة المطابقة نسبةً إلى أقرب عنصر أب متموضع (offset parent) لذلك العنصر.

=== <code>‎.position()‎</code> ===
أضيف مع الإصدار 1.2. لا يقبل هذا التابع أية وسائط.

يجلب التابع ‎<code>.position()‎</code> الإحداثيات الحالية لعنصرٍ (لإطار حوافه الخارجية [margin box] تحديدًا) نسبةً إلى أقرب عنصر أب له (إطار حواشيه [padding box] تحديدًا، أي باستثناء الهوامش والإطار). يختلف هذا التابع عن التابع ‎<code>[[jQuery/offset|.offset()]]</code>‎ الذي يعيد الإحداثيات الحالية للعنصر نسبةً إلى الصفحة. عند وضع عنصر جديد بالقرب من عنصر آخر وكان كلاهما موجودين ضمن العنصر DOM نفسه، فيكون استعمال التابع <code>‎.position()</code>‎ أكثر فائدة.

يعيد هذا التابع كائنًا يحتوي على الخاصية <code>[[CSS/top|top]]</code> والخاصية <code>[[CSS/left|left]]</code>.

'''ملاحظة''': لا تدعم jQuery الحصول على إحداثيات العناصر المخفية ولا تأخذ بالحسبان قيمة الهوامش المضبوطة للعنصر <code>[[HTML/html|<html>]]</code> في الصفحة.

=== ملاحظات إضافية ===
قد يكون العدد المُعاد باستعمال الواجهات البرمجية (APIs) المتعلقة بالأبعاد، من ضمنها <code>‎.position()‎</code>، كسريًّا في بعض الحالات. فيجب ألا تفترض الشيفرة أنَّ هذا العدد صحيحٌ (integer). بالإضافة إلى ذلك، قد تكون الأبعاد خطأ عندما يكبِّر المستخدم الصفحة، إذ لا توفِّر المتصفحات واجهةً برمجيةً لمعرفة أنَّ هذه الحالة قد وقعت.

== أمثلة ==
إيجاد موضع الفقرة <code>[[HTML/p|<nowiki><p></nowiki>]]</code> الثانية:<syntaxhighlight lang="html">
<!doctype html>
<html lang="ar">
<head>
  <meta charset="utf-8">
  <title>position مثالٌ عن استعمال التابع</title>
  <style>
  div {
    padding: 15px;
  }
  p {
    margin-left: 10px;
  }
  </style>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<div>
  <p>مرحبًا</p>
</div>
<p></p>
 
<script>
var p = $( "p:first" );
var position = p.position();
$( "p:last" ).text( "left: " + position.left + ", top: " + position.top );
</script>
 
</body>
</html>

</syntaxhighlight>

== مصادر ==
* [http://api.jquery.com/position/ صفحة التابع ‎‎.position()‎‎ في توثيق jQuery الرسمي.]
[[تصنيف:jQuery]]
[[تصنيف:jQuery Method]]
[[تصنيف:jQuery CSS]]
[[تصنيف:jQuery Offset]]
[[تصنيف:jQuery Manipulation]]