وظائف التحرير العامة

تقوم بمعالجة وظائف التحرير العامة في نافذة "Document". تقوم هذه الوظائف بإدراج النص، وHTML، والكائنات؛ وتطبيق وتغيير وإزالة الخط وعلامة الحرف؛ وتعديل العلامات والسمات؛ والمزيد

dom.applyCharacterMarkup()

التوفر

Dreamweaver 3.

الوصف

ينطبق على النوع المحدد لعلامة الحرف إلى التحديد. إذا كان التحديد نقطة إدراج، فإنه ينطبق على علامة الحرف المخصصة إلى أي نص مكتوب بعد ذلك.

الوسيطات

tagName

  • وسيطة tagName هي اسم الملف المقترن بعلامة الحرف. يجب أن تكون أحد السلاسل التالية: "b"، أو "cite"، أو "code"، أو "dfn"، أو "em", "i"، أو "kbd"، أو "samp"، أو "s"، أو "strong"، أو "tt"، أو "u"، أو "var".

عمليات الإرجاع

لا شيء.

dom.applyFontMarkup()

التوفر

Dreamweaver 3.

الوصف

ينطبق على علامة FONT والقيمة والسمة المخصصة للتحديد التالي.

الوسيطات

attribute, value

  • وسيطة attribute يجب أن تكون"واجهة"، أو "حجمًا"، أو "لونًا".

  • وسيطة القيمة هي القيمة المخصصة إلى السمة، على سبيل المثال، "Arial، أو Helvetica، أو sans-serif"، أو "5"، أو "#FF0000".

عمليات الإرجاع

لا شيء.

dom.deleteSelection()

التوفر

Dreamweaver 3.

الوصف

لحذف التحديد في المستند.

الوسيطات

None.

عمليات الإرجاع

لا شيء.

dom.editAttribute()

التوفر

Dreamweaver 3.

الوصف

لعرض الواجهة المناسبة لتحرير سمة المستند الخاصة. في أغلب الحالات، تكون هذه الواجهة مربع حوار. هذه الوظيفة صالحة فقط للمستند النشط.

الوسيطات

سمة

  • سلسلة attribute هي سلسلة تحدد سمة العلامة التي ترغب في تحريرها.

عمليات الإرجاع

لا شيء.

dom.exitBlock()

التوفر

Dreamweaver 3.

الوصف

لإيجاد كتلة العنوان الحالية أو الفقرة الحالية، وترك نقطة الإدراج خارج جميع عناصر الكتلة.

الوسيطات

None.

عمليات الإرجاع

لا شيء.

dom.getCharSet()

التوفر

Dreamweaver 4.

الوصف

لإرجاع سمة charset في علامة التعريف للمستند.

الوسيطات

None.

عمليات الإرجاع

هوية الترميز للمستند. على سبيل المثال، بالنسبة إلى مستند Latin1، تقوم الوظيفة بإرجاع iso-8859-1.

dom.getFontMarkup()

التوفر

Dreamweaver 3.

الوصف

جلب قيمة السمة الخاصة لعلامة FONT للتحديد الحالي.

الوسيطات

سمة

  • وسيطة attribute يجب أن تكون"واجهة"، أو "حجمًا"، أو "لونًا".

عمليات الإرجاع

سلسلة تحتوي على قيمة السمة الخاصة أو سلسلة فارغة إذا لم يتم تعيين السمة.

dom.getLineFromOffset()

التوفر

Dreamweaver MX.

الوصف

للعثور على رقم السطر لإزاحة الحرف الخاص في نص (رمز HTML أو JavaScript) الملف.

الوسيطات

offset

  • وسيطة offset هي عدد صحيح يمثل موقع الحرف من بداية الملف.

عمليات الإرجاع

عدد صحيح يمثل رقم السطر في المستند.

dom.getLinkHref()

التوفر

Dreamweaver 3.

الوصف

لجلب الارتباط الذي يحيط بالتحديد الحالي. هذه الوظيفة تعادل تنفيذ الحلقات من خلال العقد الأصلية والعقد الأصلية للعقدة الحالية حتى يتم العثور على ارتباط، وحينئذٍ يتم استدعاء getAttribute('HREF') بالارتباط.

الوسيطات

None.

عمليات الإرجاع

سلسلة تحتوي على اسم الملف المرتبط، والتي يعبّر عنها كملف:// URL.

dom.getLinkTarget()

التوفر

Dreamweaver 3.

الوصف

لجلب هدف الارتباط الذي يحيط بالموقع الحالي. هذه الوظيفة تعادل تنفيذ الحلقات من خلال العقد الأصلية والعقد الأصلية للعقدة الحالية حتى يتم العثور على ارتباط، وحينئذٍ يتم استدعاء وظيفة getAttribute('TARGET') بالارتباط.

الوسيطات

None.

عمليات الإرجاع

سلسلة تحتوي على قيمة سمة TARGET للارتباط أو سلسلة فارغة في حالة عدم تحديد هدف.

dom.getListTag()

التوفر

Dreamweaver 3.

الوصف

لجلب نمط القائمة المحددة.

الوسيطات

None.

عمليات الإرجاع

سلسلة تحتوي على العلامة المقترنة بالقائمة ("ul"، أو "ol"، أو "dl")، أو سلسلة فارغة في حالة عدم وجود علامة مقترنة بالقائمة. يتم إرجاع هذه القيمة دائمًا بأحرف صغيرة.

dom.getTextAlignment()

التوفر

Dreamweaver 3.

الوصف

لجلب محاذاة الكتلة التي تحتوي على التحديد.

الوسيطات

None.

عمليات الإرجاع

سلسلة تحتوي على قيمة السمة ALIGN للعلامة المقترنة بالكتلة أو سلسلة فارغة في حالة عدم تعيين علامة ALIGN للعلامة. يتم إرجاع هذه القيمة دائمًا بأحرف صغيرة.

dom.getTextFormat()

التوفر

Dreamweaver 3.

الوصف

لجلب تنسيق الكتلة للنص المحدد.

الوسيطات

None.

عمليات الإرجاع

سلسلة تحتوي على علامة الكتلة المقترنة بالنص (على سبيل المثال، "p"، و"h1"، و"pre"، وما إلى ذلك) أو سلسلة فارغة في حالة عدم اقتران علامة كتلة بالتحديد. يتم إرجاع هذه القيمة دائمًا بأحرف صغيرة.

dom.hasCharacterMarkup()

التوفر

Dreamweaver 3.

الوصف

للتحقق مما إذا كان التحديد يحتوي بالفعل على علامة حرف خاصة.

الوسيطات

markupTagName

  • وسيطة markupTagName هي اسم العلامة التي تقوم بالتحقق منها. يجب أن تكون أحد السلاسل التالية: "b"، أو "cite"، أو "code"، أو "dfn"، أو "em", "i"، أو "kbd"، أو "samp"، أو "s"، أو "strong"، أو "tt"، أو "u"، أو "var".

عمليات الإرجاع

قيمة منطقية تشير إلى ما إذا كان التحديد بالكامل يحتوي على علامة الحرف الخاصة. تقوم هذه الوظيفة بإرجاع القيمة false في حالة تمتع جزء فقط من التحديد بالعلامة المخصصة.

dom.indent()

التوفر

Dreamweaver 3.

الوصف

لبدء التحديد باستخدام علامات BLOCKQUOTE. إذا كان التحديد عنصر قائمة، فإن هذه الوظيفة تبدأ التحديد من خلال تحويل العنصر المحدد إلى قائمة متداخلة. هذه القائمة المتداخلة هي نفس نوع القائمة الخارجية، وتحتوي على عنصر واحد؛ التحديد الأصلي.

الوسيطات

None.

عمليات الإرجاع

لا شيء.

dom.insertHTML()

التوفر

Dreamweaver 3.

الوصف

لإدراج محتوى HTML إلى المستند في نقطة الإدراج الحالية.

الوسيطات

contentToInsert, {bReplaceCurrentSelection}

  • وسيطة contentToInsert هي المحتوى الذي ترغب في إدراجه.

  • وسيطة bReplaceCurrentSelection، الاختيارية، هي قيمة منطقية تشير إلى ما إذا كان يجب على المحتوى استبدال التحديد الحالي أم لا. إذا كانت قيمة وسيطة bReplaceCurrentSelection هي true، سيستبدل المحتوى التحديد الحالي. إذا كانت القيمة false، يتم إدراج المحتوى بعد التحديد الحالي.

عمليات الإرجاع

لا شيء.

مثال

يقوم الرمز التالي بإدراج سلسلة HTML <b>130</b> في المستند الحالي:

 var theDOM = dw.getDocumentDOM(); 
 theDOM.insertHTML('<b>130</b>');

تظهر النتيجة في نافذة Document.

dom.insertObject()

التوفر

Dreamweaver 3.

الوصف

لإدراج الكائن المحدد، ومطالبة المستخدم بالمعلمات عند الضرورة.

الوسيطات

objectName

  • وسيطة objectName هي الاسم لكائن ما في مجلد "Configuration/Objects".

عمليات الإرجاع

لا شيء.

مثال

يؤدي استدعاء الوظيفة dom.insertObject('Button') إلى إدراج زر نموذج إلى المستند النشط بعد التحديد الحالي. في حالة عدم تحديد أي شيء، تقوم هذه الوظيفة بإدراج الزر في نقطة الإدراج الحالية.

ملاحظة:

على الرغم من أن ملفات الكائن يمكن تخزينها في مجلدات مستقلة، فمن المهم أن تكون لهذه الملفات أسماء فريدة. في حالة استدعاء ملف يسمى Button.htm موجود في مجلد Forms وفي مجلد MyObjects، فلن يتمكن Dreamweaver من التمييز بينهما.

dom.insertText()

التوفر

Dreamweaver 3.

الوصف

لإدراج محتوى نصي إلى المستند في نقطة الإدراج الحالية.

الوسيطات

contentToInsert, {bReplaceCurrentSelection}

  • الوسيطة contentToInsert هي المحتوى الذي ترغب في إدراجه.

  • وسيطة bReplaceCurrentSelection، الاختيارية، هي قيمة منطقية تشير إلى ما إذا كان يجب على المحتوى استبدال التحديد الحالي أم لا. إذا كانت قيمة وسيطة bReplaceCurrentSelection هي true، سيستبدل المحتوى التحديد الحالي. إذا كانت القيمة false، يتم إدراج المحتوى بعد التحديد الحالي.

عمليات الإرجاع

لا شيء.

مثال

يقوم الرمز التالي بإدراج النص: &lt;b&gt;130&lt;/b&gt; إلى المستند الحالي:

 var theDOM = dreamweaver.getDocumentDOM(); 
 theDOM.insertText('<b>130</b>');

تظهر النتائج في نافذة Document.

dom.newBlock()

التوفر

Dreamweaver 3.

الوصف

لإنشاء كتلة جديدة بنفس العلامة والسمات ككتلة تحتوي على التحديد الحالي أو لإنشاء فقرة جديدة إذا كان المؤشر خارج الكتل.

الوسيطات

None.

عمليات الإرجاع

لا شيء.

مثال

إذا كان التحديد الحالي داخل فقرة تمت محاذاتها إلى المنتصف، يؤدي استدعاء وظيفة dom.newBlock() إلى إدراج <p align="center"> بعد الفقرة الحالية.

dom.notifyFlashObjectChanged()

التوفر

Dreamweaver 4.

الوصف

لإخبار Dreamweaver بأن ملف كائن Flash object تم تغييره. يقوم Dreamweaver بتحديث عرض Preview، وتغيير الحجم حسب الضرورة، والحفاظ على نسبة العرض إلى الارتفاع من الحجم الأصلي.

الوسيطات

None.

عمليات الإرجاع

لا شيء.

dom.outdent()

التوفر

Dreamweaver 3.

الوصف

لتحريك التحديد إلى مستوى أعلى.

الوسيطات

None.

عمليات الإرجاع

لا شيء.

dom.removeCharacterMarkup()

التوفر

Dreamweaver 3.

الوصف

لإزالة النوع المحدد لعلامة الحرف إلى التحديد.

الوسيطات

tagName

  • وسيطة tagName هي اسم الملف المقترن بعلامة الحرف. يجب أن تكون أحد السلاسل التالية: "b"، أو "cite"، أو "code"، أو "dfn"، أو "em", "i"، أو "kbd"، أو "samp"، أو "s"، أو "strong"، أو "tt"، أو "u"، أو "var".

عمليات الإرجاع

لا شيء.

dom.removeFontMarkup()

التوفر

Dreamweaver 3.

الوصف

لإزالة السمة المحددة وقيمتها من علامة FONT. في حالة ترك إزالة السمة لعلامة FONT فقط، ستتم إزالة علامة FONT أيضًا.

الوسيطات

سمة

  • وسيطة attribute يجب أن تكون"واجهة"، أو "حجمًا"، أو "لونًا".

عمليات الإرجاع

لا شيء.

dom.resizeSelection()

التوفر

Dreamweaver 3.

الوصف

لتغيير حجم الكائن المحدد إلى الأبعاد الخاصة.

الوسيطات

newWidth، newHeight

  • وسيطة newWidth تحدد العرض الجديدة الذي ستقوم الوظيفة بتعيين الكائن المحددة إليه.

  • وسيطة newHeight تحدد الارتفاع الجديد الذي ستقوم الوظيفة بتعيين الكائن المحددة إليه.

عمليات الإرجاع

لا شيء.

dom.setAttributeWithErrorChecking()

التوفر

Dreamweaver 3.

الوصف

لتعيين السمة المحددة إلى القيمة المحددة للتحديد الحالي، ومطالبة المستخدم إذا كانت القيمة هي النوع الخاطئ أو إذا كانت خارج النطاق. هذه الوظيفة صالحة فقط للمستند النشط.

الوسيطات

attribute, value

  • وسيطة attribute تحدد السمة التي سيتم تعيينها إلى التحديد الحالي.

  • وسيطة value تحدد القيمة التي سيتم تعيينها إلى السمة.

عمليات الإرجاع

لا شيء.

dom.setLinkHref()

التوفر

Dreamweaver 3.

الوصف

لجعل التحديد ارتباط نص تشعبي أو تغيير قيمة عنوان URL لعلامة HREF التي تحيط بالتحديد الحالي.

الوسيطات

linkHREF

  • وسيطة linkHREF هي عنوان URL (مسار متعلق بالمستند، أو مسار متعلق بالجذر، أو عنوان URL قديم) يقوم بإنشاء الارتباط. في حالة حذف هذه الوسيطة، يظهر مربع حوار Select HTML File.

عمليات الإرجاع

لا شيء.

وحدة التمكين

dom.setLinkTarget()

التوفر

Dreamweaver 3.

الوصف

لتعيين هدف الارتباط الذي يحيط بالموقع الحالي. هذه الوظيفة تعادل تنفيذ الحلقات من خلال العقد الأصلية والعقد الأصلية للعقدة الحالية حتى يتم العثور على ارتباط، وحينئذٍ يتم استدعاء وظيفة setAttribute('TARGET') بالارتباط.

الوسيطات

{linkTarget}

  • الوسيطة linkTarget، الاختيارية، هي سلسلة تمثل اسم إطار، أو اسم نافذة، أو أحد الأهداف المحجوزة ("_self"، أو "_parent"، أو "_top"، أو "_blank"). إذا تم حذف الوسيطة، سيظهر مربع حوار Set Target.

عمليات الإرجاع

لا شيء.

dom.setListBoxKind()

التوفر

Dreamweaver 3.

الوصف

لتغيير نوع قائمة SELECT المحددة.

الوسيطات

kind

  • وسيطة kind يجب أن تكون إما"menu" أو "list box".

عمليات الإرجاع

لا شيء.

dom.showListPropertiesDialog()

التوفر

Dreamweaver 3.

الوصف

لفتح مربع حوار List Properties.

الوسيطات

None.

عمليات الإرجاع

لا شيء.

وحدة التمكين

dom.setListTag()

التوفر

Dreamweaver 3.

الوصف

لتعيين نمط القائمة المحددة.

الوسيطات

listTag

  • وسيطة listTag هي العلامة المقترنة بالقائمة. يجب أن تكون "ol"، أو "ul"، أو "dl"، أو أي سلسلة فارغة.

عمليات الإرجاع

لا شيء.

dom.setTextAlignment()

التوفر

Dreamweaver 3.

الوصف

لتعيين سمة ALIGN للكتلة التي تحتوي على التحديد للقيمة الخاصة.

الوسيطات

alignValue

  • وسيطة alignValue يجب أن تكون"left"، أو "center"، أو "right".

عمليات الإرجاع

لا شيء.

dom.setTextFieldKind()

التوفر

Dreamweaver 3 (مهمل منذ Dreamweaver CS5.5)

الوصف

لتعيين تنسيق الحقل النصي المحدد.

الوسيطات

fieldType

  • وسيطة fieldType يجب أن تكون"input"، أو "textarea"، أو "password".

عمليات الإرجاع

لا شيء.

dom.setTextFormat()

التوفر

Dreamweaver 4.

الوصف

لتعيين تنسيق الكتلة للنص المحدد.

الوسيطات

blockFormat

  • وسيطة blockFormat هي سلسلة تحدد أحد التنسيقات التالية "" (بالنسبة إلى عدم وجود تنسيق)، أو "p"، أو "h1"، أو "h2"، أو "h3"، أو "h4"، أو "h5"، أو "h6"، أو "pre".

عمليات الإرجاع

لا شيء.

dom.showFontColorDialog()

التوفر

Dreamweaver 3.

الوصف

لفتح مربع حوار Color Picker.

الوسيطات

None.

عمليات الإرجاع

لا شيء.

dreamweaver.deleteSelection()

التوفر

Dreamweaver 3.

الوصف

لحذف التحديد في المستند النشط أو لوحة Site؛ في Macintosh، يتم حذف المربع النصي الذي يتم التركيز عليه في مربع حوار أو لوحة عائمة.

الوسيطات

None.

عمليات الإرجاع

لا شيء.

وحدة التمكين

dreamweaver.editFontList()

التوفر

Dreamweaver 3.

الوصف

لتفح مربع حوار Edit Font List.

الوسيطات

None.

عمليات الإرجاع

لا شيء.

dreamweaver.getFontList()

التوفر

Dreamweaver 3.

الوصف

لجلب قائمة بجميع مجموعات الخطوط التي تظهر في مراقب Property النصي وفي مربع حوار Style Definition.

الوسيطات

None.

عمليات الإرجاع

صفيف من السلاسل الذي يمثل كل عنصر في قائمة الخطوط.

مثال

بالنسبة إلى التثبيت الافتراضي لبرنامج Dreamweaver، يؤدي استدعاء وظيفة dreamweaver.getFontList() إلى إرجاع صفيف يحتوي على العناصر التالية:

  • "Arial, Helvetica، sans-serif"

  • "Times New Roman، Times، serif"

  • "Courier New، Courier، mono"

  • "Georgia، Times New Roman، Times، serif"

  • "Verdana، Arial، Helvetica، sans-serif"

dreamweaver.getFontStyles()

التوفر

Dreamweaver 4.

الوصف

لإرجاع الأنماط التي يدعمها خط TrueType المحدد.

الوسيطات

fontName

  • وسيطة fontName هي سلسلة تحتوي على اسم الخط.

عمليات الإرجاع

صفيف من ثلاث قيم منطقية تشير إلى ما يدعمه الخط. تشير القيمة الأولى إلى ما إذا كان الخط يدعم الخط الغامق، والقيمة الثانية تشير إلى ما إذا كان الخط يدعم الخط المائل، والقيمة الثالثة تشير إلى ما إذا كان الخط يدعم كلا الخطين الغامق والمائل.

dreamweaver.getKeyState()

التوفر

Dreamweaver 3.

الوصف

لتحديد ما إذا تم خفض مفتاح التعديل المحدد.

الوسيطات

key

  • وسيطة key argument يجب أن تكون واحدة من القيم التالية: "Cmd"، أو "Ctrl"، أو"Alt"، أو "Shift". في Windows، يشير "Cmd" و"Ctrl" إلى مفتاح Control؛ في Macintosh، يشير "Alt" إلى مفتاح Option.

عمليات الإرجاع

قيمة منطقية تشير إلى ما إذا تم الضغط على المفتاح أم لا.

مثال

يتحقق الرمز التالي من الضغط على كلا المفتاحين Shift وControl (Windows) أو Shift وCommand (Macintosh) قبل إجراء أي عملية:

 if (dw.getKeyState("Shift") && dw.getKeyState("Cmd")){ 
    // execute code 
}

dreamweaver.getNaturalSize()

التوفر

Dreamweaver 4.

الوصف

لإرجاع العرض والارتفاع لكائن رسومي.

الوسيطات

url

  • وسيطة url argument تشير إلى كائن رسومي الذي يجب تعيين الأبعاد له. يجب أن يدعم Dreamweaver هذا الكائن (GIF، وJPEG، وPNG، وFlash، وShockwave). عنوان URL المتوفر كوسيطة إلى وظيفة getNaturalSize() يجب أن يكون عنوان URL قديم إلى ملف محلي؛ ولا يمكن أن يكون عنوان URL نسبيًا.

عمليات الإرجاع

صفيف من عددين صحيحين، حيث يحدد العدد الصحيح الأول عرض الكائن، بينما يحدد العدد الصحيح الآخر الارتفاع.

dreamweaver.getSystemFontList()

التوفر

Dreamweaver 4.

الوصف

لإرجاع قائمة الخطوط للنظام. يمكن لهذه الوظيفة جلب إما جميع الخطوط أو خطوط TrueType فقط.

الوسيطات

fontTypes

  • وسيطة fontTypes هي سلسلة تحتوي على إما قيمة all، أو قيمة TrueType.

عمليات الإرجاع

صفيف من السلاسل التي تحتوي على أسماء خطوط كاملة؛ يتم إرجاع قيمة null في حالة عدم العثور على خطوط.

dreamweaver.getSystemFontName()

التوفر

Dreamweaver CS5.

الوصف

لإرجاع اسم خط النظام.

الوسيطات

لا شيء.

عمليات الإرجاع

سلسلة تحتوي على اسم خط النظام.

احصل على مساعدة بشكل أسرع وأسهل

مستخدم جديد؟