وظائف السلوك
تتيح لك وظائف السلوك إضافة السلوكيات إلى كائن ما، وإزالته منه، والبحث عن السلوكيات المرفقة بكائن ما، والحصول على معلومات حول كائن ما يتم إرفاق سلوك به، وغير ذلك. تتحكم طرق الكائن dreamweaver.behaviorInspector أو تعمل على التحديد فقط في لوحة Behaviors وليس التحديد في المستند الحالي.
dom.addBehavior()
التوفر
Dreamweaver 3.
الوصف
يضيف زوج حدث/إجراء جديد للعنصر المحدد. هذه الوظيفة صالحة فقط للمستند النشط.
الوسيطات
حدث، إجراء، {eventBasedIndex}
وسيطة الحدث هي حدث JavaScript الذي ينبغي أن يرفق السلوك بالعنصر (على سبيل المثال، onClick، أو onMouseOver، أو onLoad).
وسيطة الإجراء هي استدعاء الدالة التي يقوم applyBehavior() بإرجاعها في حالة إضافة الإجراء باستخدام لوحة Behaviors (على سبيل المثال، "MM_popupMsg('Hello World')").
وسيطة eventBasedIndex الاختيارية، هي الموضع التي ينبغي إضافة هذا الإجراء عنده. وسيطة eventBasedIndex هي فهرس صفري، إذا تم إقران إجراءين بالفعل بالحدث المحدد، وقمت بتحديد eventBasedIndex على أنه الإجراء 1، فسيتم تنفيذ هذا الإجراء بين الاثنين الآخرين. وفي حالة حذف تلك الوسيطة، تتم إضافة الإجراء بعد جميع الإجراءات الحالية للحدث المحدد.
عمليات الإرجاع
لا شيء.
dom.getBehavior()
التوفر
Dreamweaver 3.
الوصف
يحصل على الإجراء عند الموضع المحدد داخل الحدث المحدد. تعمل هذه الدالة على التحديد الحالي وهي صالحة فقط للمستند النشط.
الوسيطات
الحدث، {eventBasedIndex}
وسيطة الحدث هي معالج حدث JavaScript الذي يتم من خلاله إرفاق الإجراء بالعنصر (على سبيل المثال، onClick، أو onMouseOver، أو onLoad).
وسيطة eventBasedIndex الاختيارية هي موضع الإجراء الذي يتم الحصول عليه. على سبيل المثال، إذا تم إقران إجراءين مع حدث محدد، يكون 0 هو الأول و1 هو الثاني. وفي حالة حذف هذه الوسيطة، تقوم الدالة بإرجاع جميع الإجراءات للحدث المحدد.
عمليات الإرجاع
سلسلة تمثل استدعاء الدالة (على سبيل المثال، "MM_swapImage('document.Image1','document.Image1','foo.gif','#933292969950')") أو صفيف من السلاسل إذا تم حذف eventBasedIndex.
dom.reapplyBehaviors()
التوفر
Dreamweaver 3.
الوصف
للتحقق للتأكد أن الدوال المقترنة بأية استدعاءات للسلوكيات على العقدة المحددة موجودة في القسم HEAD من المستند ولإدراجها إذا كانت غير موجودة.
الوسيطات
elementNode
وسيطة elementNode هي عقدة عناصر داخل المستند الحالي. وفي حالة حذف الوسيطة، يتحقق Dreamweaver من جميع عقد العناصر في المستند بحثًا عن استدعاءات السلوكيات المعزولة.
عمليات الإرجاع
لا شيء.
dom.removeBehavior()
التوفر
Dreamweaver 3.
الوصف
يزيل الإجراء عند الموضع المحدد داخل الحدث المحدد. تعمل هذه الدالة على التحديد الحالي وهي صالحة فقط للمستند النشط.
الوسيطات
الحدث، {eventBasedIndex}
وسيطة الحدث هي معالج الحدث الذي يتم من خلاله إرفاق الإجراء بالعنصر (على سبيل المثال، onClick، أو onMouseOver، أو onLoad). إذا حذفت تلك الوسيطة، فستتم إزالة جميع الإجراءات من العنصر.
وسيطة eventBasedIndex الاختيارية هي موضع الإجراء المراد إزالته. على سبيل المثال، إذا تم إقران إجراءين مع حدث محدد، يكون 0 هو الأول و1 هو الثاني. وفي حالة حذف هذه الوسيطة، تتم إزالة جميع الإجراءات للحدث المحدد.
عمليات الإرجاع
لا شيء.
dreamweaver.getBehaviorElement()
التوفر
Dreamweaver 2 وتم تحديثه في CS4.
الوصف
يحصل على كائن DOM الذي يطابق العلامة التي يتم تطبيق السلوك عليها. تنطبق هذه الدالة فقط في ملفات إجراءات السلوك.
الوسيطات
None.
عمليات الإرجاع
كائن DOM أو قيمة فارغة. تقوم هذه الدالة بإرجاع قيمة فارغة ضمن الظروف التالية:
عند عدم تنفيذ البرنامج النصي الحالي داخل سياق لوحة Behaviors.
عندما يبدأ dreamweaver.popupAction()البرنامج النصي الذي يتم تنفيذه حاليًا
عند توصيل لوحة Behaviors لحدث أو أداة التفاف لرابط وعدم وجود أداة التفاف الرابط حتى الآن
عند ظهور هذه الدالة خارج ملف إجراء ما
مثال
يمكن استخدام دالة dreamweaver.getBehaviorElement() بنفس طريقة استخدام dreamweaver.getBehaviorTag() لتحديد ما إذا كان الإجراء المحدد ملائمًا لعلامة HTML المحددة أم لا. ويتمثل الاختلاف في أنها تتيح لك الوصول لمزيد من المعلومات حول العلامة وسماتها. وفي حالة كتابة إجراء يمكن تطبيقه فقط على رابط ارتباط تشعبي (A HREF) لا يستهدف نافذة أو إطار آخر، فيمكنك استخدام الدالة getBehaviorElement(). ويمكنك استخدام الدالة getBehaviorElement() كجزء من الدالة التي تبدأ تشغيل واجهة المستخدم لمربع حوار Parameters. ويتم عرضها في المثال التالي:
function initializeUI(){
var theTag = dreamweaver.getBehaviorElement();
var CANBEAPPLIED = (theTag.tagName == "A" && ¬
theTag.getAttribute("HREF") != null && ¬
theTag.getAttribute("TARGET") == null);
if (CANBEAPPLIED) {
// display the action user interface
} else{
// display a helpful message that tells the user
// that this action can only be applied to a
// link without an explicit target]
}
}
dreamweaver.getBehaviorTag()
التوفر
Dreamweaver 1.2.
الوصف
يحصل على العلامة التي يتم تطبيق السلوك عليها. تنطبق هذه الدالة فقط في ملفات الإجراء فقط.
الوسيطات
None.
عمليات الإرجاع
هي سلسلة تمثل مصدر العلامة. وهذه هي نفس السلسلة التي تمرر وسيطة (HTMLelement) إلى الدالة canAcceptBehavior(). تظهر هذه الدالة خارج ملف إجراء ما، وتكون قيمة الإرجاع عبارة عن سلسلة فارغة.
مثال
وفي حالة كتابة إجراء يمكن تطبيقه على رابط الارتباط التشعبي فقط (A HREF)، فيمكنك استخدام الدالة getBehaviorTag() كما يوضح المثال التالي، في الدالة التي تبدأ تشغيل واجهة المستخدم لمربع حوار Parameters:
function initializeUI(){
var theTag = dreamweaver.getBehaviorTag().toUpperCase();
var CANBEAPPLIED = (theTag.indexOf('HREF') != -1));
if (CANBEAPPLIED) {
// display the action UI
} else{
// display a helpful message that tells the user
// that this action can only be applied to a
// hyperlink
}
}
dreamweaver.popupAction()
التوفر
Dreamweaver 2 وتم تحديثه في CS4.
الوصف
يبدأ تشغيل مربع حوار Parameters لإجراء السلوك المحدد. وبالنسبة للمستخدم، يكون هذا الأثر نفس الخاص بتحديد الإجراء من القائمة المنسدلة Actions في لوحة Behaviors. تتيح هذه الدالة لملفات الملحقات خلاف سلوكيات إرفاق الإجراءات للكائنات في مستند المستخدم. وهي تحظر عمليات التحرير الأخرى حتى يتجاهل المستخدم مربع الحوار.
يمكن استدعاء هذه الدالة داخل الدالة objectTag() أو في أي برنامج نصي في ملف أوامر أو في ملف عارض الخصائص.
الوسيطات
actionName، {funcCall}
وسيطة actionName هي سلسلة تحتوي على اسم ملف موجود في مجلد Configuration/Behaviors/Actions. يحتوي الملف على إجراء سلوك JavaScript (على سبيل المثال، "Swap Image.htm").
وسيطة funcCall الاختيارية عبارة عن سلسلة تحتوي على استدعاء دالة للإجراء المحدد في actionName؛ على سبيل المثال، "MM_SwapImage(...)". دالة applyBehavior() في ملف الإجراء توفر هذه الوسيطة، إذا تم تحديدها.
عمليات الإرجاع
استدعاء الدالة لإجراء السلوك. عندما ينقر المستخدم فوق OK في مربع حوار Parameters، تتم إضافة السلوك إلى المستند الحالي. تتم إضافة الدوال المناسبة إلى قسم HEAD من المستند. تتم إضافة HTML لأعلى قسم BODY ويمكن تنفيذ عمليات التحرير الأخرى للمستند. لا تتم إضافة استدعاء الدالة (على سبيل المثال، "MM_SwapImage(...)") للمستند، لكنها تصبح قيمة إرجاع لهذه الدالة.
dreamweaver.behaviorInspector.getBehaviorAt()
التوفر
Dreamweaver 3.
الوصف
يحصل على زوج الحدث/الإجراء في الموضع المحدد في لوحة Behaviors.
الوسيطات
positionIndex
وسيطة positionIndex هي موضع الإجراء في لوحة Behaviors. الإجراء الأول في القائمة في الموضع 0.
عمليات الإرجاع
صفيف من عنصرين:
معالج حدث
استدعاء دالة أو عبارة JavaScript
مثال
لأن positionIndex عبارة عن فهرس صفري، تعرض لوحة Behaviors القائمة، ويقوم استدعاء الدالة dreamweaver.behaviorInspector.getBehaviorAt(2) بإرجاع صفيف يحتوي على سلسلتين: "onMouseOver" و"MM_changeProp('document.moon','document.moon','src','sun.gif','MG')".
dreamweaver.behaviorInspector.getBehaviorCount()
التوفر
Dreamweaver 3.
الوصف
يقوم بحساب عدد الإجراءات المرفقة بالعنصر المحدد حاليًا خلال معالجات الأحداث.
الوسيطات
None.
عمليات الإرجاع
هو عدد صحيح يمثل عدد الإجراءات المرفقة بالعنصر. هذا العدد معادل لعدد الإجراءات المرئية في لوحة Behaviors ويشمل إجراءات سلوك Dreamweaver وJavaScript المخصصة.
مثال
استدعاء إلى dreamweaver.behaviorInspector.getBehaviorCount() للرابط المحدد <A HREF="javascript:setCookie()" onClick="MM_popupMsg('A cookie has been set.');parent.rightframe.location.href='aftercookie.html'"> returns 2.
dreamweaver.behaviorInspector.getSelectedBehavior()
التوفر
Dreamweaver 3.
الوصف
يحصل على موضع الإجراء المحدد في لوحة Behaviors.
الوسيطات
None.
عمليات الإرجاع
هو عدد صحيح يمثل موضع الإجراء المحدد في لوحة Behaviors أو 1 في حالة عدم تحديد أي إجراء.
مثال
إذا تم تحديد الإجراء الأول في لوحة Behaviors فسيقوم استدعاء إلى الدالة dreamweaver.behaviorInspector.getSelectedBehavior() بإرجاع 0.
dreamweaver.behaviorInspector.moveBehaviorDown()
التوفر
Dreamweaver 3.
الوصف
ينقل إجراء سلوك أقل في التسلسل من خلال تغيير أمر تنفيذه داخل نطاق حدث ما.
الوسيطات
positionIndex
وسيطة positionIndex هي موضع الإجراء في لوحة Behaviors. الإجراء الأول في القائمة في الموضع 0.
عمليات الإرجاع
لا شيء.
مثال
يؤدي استدعاء الدالة dreamweaver.behaviorInspector.moveBehaviorDown(2) إلى تبديل مواضع إجراءي Preload Images وChange Property على حدث onMouseDown. لا يكون لاستدعاء الدالة dreamweaver.behaviorInspector.moveBehaviorDown() لأي موضع آخر أي أثر لأن الحدثين onClick وonFocus لكل منهما سلوك مقترن واحد، والسلوك موجود في الموضع 3 موجود بالفعل في أسفل مجموعة أحداث onMouseDown.
dreamweaver.behaviorInspector.moveBehaviorUp()
التوفر
Dreamweaver 3.
الوصف
ينقل سلوكًا أعلى في التسلسل من خلال تغيير أمر تنفيذه داخل نطاق حدث ما.
الوسيطات
positionIndex
وسيطة positionIndex هي موضع الإجراء في لوحة Behaviors. الإجراء الأول في القائمة في الموضع 0.
عمليات الإرجاع
لا شيء.
مثال
يؤدي استدعاء الدالة dreamweaver.behaviorInspector.moveBehaviorUp(3) إلى تبديل مواضع إجراءي Preload Images وChange Property على حدث onMouseOver. لا يكون لاستدعاء الدالة dreamweaver.behaviorInspector.moveBehaviorUp() لأي موضع آخر أي أثر لأن الحدثين onClick وonFocus لكل منهما سلوك مقترن واحد، والسلوك موجود في الموضع 2 موجود بالفعل في أسفل مجموعة أحداث onMouseDown.
dreamweaver.behaviorInspector.setSelectedBehavior()
التوفر
Dreamweaver 3.
الوصف
يحدد زوج الإجراء في الموضع المحدد في لوحة Behaviors.
الوسيطات
positionIndex
وسيطة positionIndex هي موضع الإجراء في لوحة Behaviors. الإجراء الأول في القائمة في الموضع 0. لإلغاء تحديد جميع الإجراءات، حدد positionIndex بقيمة –1. يعادل تحديد موضع لا يوجد إجراء له تحديد –1.
عمليات الإرجاع
لا شيء.
مثال
يؤدي تحديد الدالة dreamweaver.behaviorInspector.setSelection(2) إلى تحديد إجراء Change Property المقترن بالحدث onMouseDown:
