HTML DOM Element textContent وقار

تعریف و استعمال

textContent وقار کا استعمال یا بازگشت فراہم کیا، تو اس کا استعمال کیا جاسکتا ہے جو معین کردہ نود کا متن محتوا اور اس کا تمام ذیلی بچہ نود کا متن محتوا واپس فراہم کرتا ہے。

آپ نے اگر textContent وقار، تمام ذیلی عناصر کو حذف کرکے ایک واحد متن نود کی شکل میں دیے گئے ناگیدی کو بدل دیتا ہے。

تذکرہ:بعضی مواقع، اس کا وقار nodeValue کی جگه استعمال کیا جاسکتا ہے، لیکن یاد رکھیجئے کہ اس وقار نے تمام ذیلی عناصر کا متن بھی واپس فراہم کرتا ہے。

مشارکت دیگر:

innerText کا وقار

innerHTML کا وقار

مثال

مثال 1

عناصر کی متن محتوای بازگردانی:

let text = element.textContent;

آزمایش کنید

مثال 2

id="demo" کا <p> عناصر کی متن محتوای تبدیل کرنا:

element.textContent = "I have changed!";

آزمایش کنید

مثال 3

مقصد id="myList" کا <ul> عناصر کی تمام متن محتوای حاصل کرنا:

let text = document.getElementById("myList").textContent;

آزمایش کنید

نحوه نوشتن

بازگشتن محتوای متنی نقطه:

element.textContent

یا

node.textContent

تنظیم محتوای متنی نقطه:

element.textContent = text
node.textContent = text

مقدار ویژگی

مقدار توضیح
text محتوای متنی عنصر یا نقطه.

مقدار بازگشتی

نوع توضیح
زنجیره

محتوای متنی عنصر و نسل‌های بعدی.

اگر عنصر document، document type یا notation باشد، null بازمی‌گرداند.

تفاوت innerHTML، innerText و textContent

ویژگی innerText بازمی‌گرداند:

فقط محتوای متنی عناصر و نسل‌های بعدی را بازمی‌گرداند، بدون فضاهای پنهان CSS و برچسب‌ها، به استثنای عناصر <script> و <style>.

ویژگی innerHTML بازمی‌گرداند:

محتوای متنی عنصر، شامل تمام فضاهای خالی و برچسب‌های HTML داخلی.

ویژگی textContent بازمی‌گرداند:

محتوای متنی تمام عناصر و نسل‌های بعدی، با فضاهای خالی و متون پنهان CSS، اما بدون برچسب‌ها.

مثال HTML

<p id="myP">   این عنصر فضای اضافی دارد و شامل <span>عنصر span</span> است.</p>

JavaScript مثال

let text = document.getElementById("myP").innerText;
let text = document.getElementById("myP").innerHTML;
let text = document.getElementById("demo").textContent;

آزمایش کنید

در مثال بالا:

ویژگی innerText بازمی‌گرداند:

این عنصر فضای اضافی دارد و شامل عنصر span است.

ویژگی innerHTML بازمی‌گرداند:

   این عنصر فضای اضافی دارد و شامل <span>عنصر span</span> است.

ویژگی textContent بازمی‌گرداند:

   این عنصر فضای اضافی دارد و شامل عنصر span است.

پشتیبانی براوزر

element.textContent ویژگی DOM Level 3 (2004) است.

تمام براوزرها این را کاملاً پشتیبانی می‌کنند:

Chrome IE ایج فائرفاکس سافری آپریا
Chrome IE ایج فائرفاکس سافری آپریا
پشتیبند 9-11 پشتیبند پشتیبند پشتیبند پشتیبند