طريقة substringData() في XML DOM
التعريف والاستخدام
طريقة substringData() من نص أو تعليق استخراج النص من العنصر.
النص:
CharacterData.substringData(start,length)
المعامل | الوصف |
---|---|
start | مطلوب. موقع الحرف الأول من الفقاعة التي سيتم عودتها. |
length | مطلوب. عدد الحروف في الفقاعة التي سيتم عودتها. |
الناتج
يُرجع سلسلة تحتوي على نص من start البداية length حرف.
يُلقي
يمكن أن يلقي هذا الطريقة استثناءً يحتوي على رمز التالية استثناء DOMException:
INDEX_SIZE_ERR - المعامل start أو length هو عدد سالب أو length أكبر من طول موضوع Text أو Comment.
DOMSTRING_SIZE_ERR - حجم النص المحدد كبير جدًا ولا يمكن إدراجه في سلسلة حروف يمكن تنفيذها في تنفيذ JavaScript للمتصفح.
الوصف
ستقوم هذه الطريقة باستخراج من موضوع Text أو Comment من start البداية length حرف. هذه الطريقة تعمل فقط عندما يكون عدد الحروف في النص الذي يحتويه العنصر أكبر من أكبر عدد حروف يمكن أن يحتويه تنفيذ JavaScript للمتصفح. في هذه الحالة، لا يمكن للبرنامج JavaScript استخدام خاصية data النصية أو النصية للعنصر مباشرة، بل يجب استخدامه باستخدام جزء أقصر من نص العنصر. في التطبيقات العملية، لا يحدث هذا الوضع غالبًا.