ویژگی textContent HTML DOM Element

تعریف و استفاده

textContent ویژگی textContent تعریف یا بازگردانی می‌کند، متن محدوده‌ای از یک گره و همه ی فرزندان آن است.

اگر شما textContent ویژگی، همه ی فرزندان را حذف کرده و یک نقطه‌ی متن شامل رشته‌ی داده شده را جایگزین می‌کند.

توضیح:گاهی اوقات، این ویژگی می‌تواند به جای ویژگی nodeValue استفاده شود، اما به خاطر داشته باشید که این ویژگی همگی متن همه ی فرزندان را بازمی‌گرداند.

لطفاً به: مراجعه کنید

ویژگی innerText

ویژگی innerHTML

مثال

مثال 1

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

let text = element.textContent;

آزمایش کنید

مثال 2

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

element.textContent = "I have changed!";

آزمایش کنید

مثال 3

دریافت محتوای متن همه ی عناصر <ul> با id="myList":

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 داخلی.

속عتextContent به بازمی‌گردد:

تمام محتوای متنی فرزندان و عناصر، با فضاهای خالی و متن پنهان 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> است.

속عتextContent به بازمی‌گردد:

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

پشتیبانی مرورگر

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

همه مرورگرها آن را به طور کامل پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی 9-11 پشتیبانی پشتیبانی پشتیبانی پشتیبانی