این آموزش در تاریخ ۱۴۰۱/۰۴/۲۷ آپدیت شده است.
آموزش متد getElementsByName در DOM جاوااسکریپت
سلام خدمت تمامی دوستان و همراهان محترم سایت آموزشی فری لرن ، امیدوارم که حال همگیتون خوب باشه. لطفا در ادامه با آموزش متد getElementsByName در DOM جاوااسکریپت با من همراه باشید.
Free-Learn
آنچه در این جلسه میخوانید :
متد getElementsByName در DOM جاوااسکریپت
با استفاده از متد ()getElementsByName میتونیم تگ هارو از صفحه بر اساس نامشون ( نام یک تگ از طریق صفت name مشخص میشه ) انتخاب نماییم.
این متد ۱ پارامتر میگیره که اونم مقدار صفت name هست که میخوایم انتخابش کنیم از صفحه ، ولی خب ممکنه ما چندین تگ با نام مشابه داشته باشیم باید چکار کرد؟!
خب اینم مثه جلسه قبلی و جریان انتخاب کلاس ها ، باید شماره ایندکس اون تگی که میخوایم بدستش بیاریم رو وارد کنیم، شماره ایندکس هم دیگه باید بدونید همیشه از ۰ شروع میشه تا بی نهایت ( یعنی به تعداد نام هایی که در صفحه وجود دارد )
با استفاده از متد getElementById میتونیم تگ هارو براساس ID انتخاب نماییم.
| مقدار برگشتی | برگشت یک تگ با Name مشخص شده |
|---|---|
| نسخه DOM | DOM Level 1 |
Free-Learn
مثال از این متد
در ادامه میتوانید یک مثال از این متد را در زبان جاوا اسکریپت مشاهده نمایید.
مثال شماره ۱ : بدست آوردن مقدار داخل یک اینپوت از طریق صفت Name
|
1 2 3 4 5 6 7 8 9 10 |
<script> function get_info(){ var UserName , result; UserName = document.getElementsByName("user_name")[0].value; result = document.getElementById("Result"); result.innerHTML = "User Name : " + UserName; } </script> |
Free-Learn
پشتیبانی مرورگرها
در جدول زیر میتوانید مشاهده نمایید که آیا مرورگرهای اینترنتی از این متد در جاوااسکریپت پشتیبانی میکنند یا خیر.
| نام متد | Chrome | Firefox | Opera | Safari | Edge |
| ()getElementsByName | بله | بله | بله | بله | بله |
Free-Learn
شکل نوشتاری
نحوه نوشتن یا استفاده یا سینتَکس (Syntax) این متد در جاوااسکریپت بصورت زیر می باشد.
|
1 |
document.getElementsByName( Element_Name )[ Index_Number ] |
- Element_Name : نام تگ
- Index_Number : شماره ایندکس یا جایگاه تگ در صفحه
Free-Learn
جدول پارامترها
در جدول زیر میتوانید، پارامترهایی را که میتوان در این متد استفاده کرد مشاهده نمایید.
| مقدار | توضیح |
|---|---|
| Element_Name | ضروری – نام اون تگی که میخوایم انتخاب کنیم ( نام یک تگ از طریق صفت name مشخص میشود ) |
Free-Learn
نکات و توضیحات
- موقع انتخاب نام ( Name ) یک تگ باید حتما شماره ایندکس یا Index هم مشخص شود.
- شماره ایندکس همیشه از ۰ شروع میشه. ( اولین نام میشه ۰ و بعدی میشه ۱ و همینطور تابره )
- معمولا و بیشتر ،برای انتخاب تگ ها از صفحه در زبان جاوا اسکریپت از متد getElementById استفاده میشه، چون دیگه نیاز نیست شماره ایندکس وارد کرد.
