XML DOM surroundContents() পদ্ধতি
পরিভাষা ও ব্যবহার
surroundContents() পদ্ধতিটি নির্দিষ্ট নোডটি ব্যবহার করে বিস্তারের কন্টেন্টকে ঘিরে রাখে。
ভাষা:
surroundContents(newParent)
পারামিটার
পারামিটার | বর্ণনা |
---|---|
newParent | যার কোনও নোড বর্তমান বিস্তারের কন্টেন্টের নতুন পিতৃ হবে。 |
ব্যর্থ হবে
এই পদ্ধতিটি নিম্নলিখিত কোডটির সঙ্গে ব্যর্থ হবে: DOMException অপসারণবা RangeException অপসারণ:
DOMException.HIERARCHY_REQUEST_ERR
বর্তমান বিস্তারের ভাবনীয় শুরুতের সমাবেশী নোডের কোনও সাবনোড থাকবে না, এবং কোনও newParent এই ধরনের সাবনোড বা newParent সমাবেশী নোডের পূর্বপুরুষ নোড。
DOMException.NO_MODIFICATION_ALLOWED_ERR
বর্তমান রেঞ্জের শেষ বিন্দুর পূর্বপুরুষ নোডটি অপসার্য হয়েছে, এটিতে যোগ করার কাজ করা হতে পারে না。
DOMException.WRONG_DOCUMENT_ERR
newParent এবং তার রেঞ্জটি ভিন্ন Document ওবজেক্ট দ্বারা তৈরি হয়েছে。
RangeException.BAD_BOUNDARYPOINTS_ERR
বর্তমান রেঞ্জটি একটি নোডকে (Text নোড ছাড়া) অংশবিশিষ্টভাবে বাছাই করেছে, তাই ডকুমেন্টের এই অংশটি বেষ্টিত হতে পারে না。
RangeException.INVALID_NODE_TYPE_ERR
newParent এটি Document, DocumentFragment, DocumentType, Attr, Entity বা Notation নোড হতে পারে。
বর্ণনা
এই পদ্ধতি বর্তমান রেঞ্জের পিতৃ নোডকে পুনর্নির্দিষ্ট করবে newParentএবং তারপর newParent ডকুমেন্টের একটি অংশকে <div> বা <span> ইলিমেন্টে প্রবেশ করানো হয়, এই পদ্ধতি ব্যবহার করা যেতে পারে。
যদি newParent যদি এটি ডকুমেন্টের একটি অংশ হয়ে গেছে, তবে এটি প্রথমে ডকুমেন্ট থেকে মুক্ত করা হবে, এটির সাথে যুক্ত সব সাব-নোড হবে অপসারিত হবে।যখন এই পদ্ধতি ফলাফল দেয়, এই রেঞ্জটি উপস্থাপনা করা হবে newParent পূর্বের স্থানটি ভাবে ভাবা হবে,newParent পরের স্থানটি শেষ বিন্দু হবে。