در مثال زیر، با کلیک روی یک دکمه، عناصر فهرست به آرایه تبدیل می شوند و متن هر مورد نمایش داده می شود. برای روشن ماندن تفاوت میان DOM و jQuery، در حلقه از ویژگی textContent استفاده شده است؛ این ویژگی متعلق به عنصر DOM است.
$(function() {
$("button").on("click", function() {
const items = $("li").toArray();
items.forEach(function(item) {
alert(item.textContent);
});
});
});
تابع آماده سازی سند کمک می کند کد پس از آماده شدن ساختار صفحه اجرا شود. سپس رویداد کلیک به دکمه ها متصل می شود. هنگام کلیک، انتخابگر $("li") عناصر فهرست را پیدا می کند و toArray() آن مجموعه را به آرایه تبدیل می کند. در پایان، حلقه روی آرایه حرکت می کند و متن هر عنصر را در پنجره هشدار نشان می دهد.
در نسخه زیر می توان به جای نمایش پنجره های هشدار، متن ها را در کنسول ثبت کرد. این روش برای آزمایش و عیب یابی معمولا مزاحمت کمتری دارد. همچنین اگر فهرست خالی باشد، حلقه هیچ بار اجرا نمی شود؛ می توانید برای نمایش پیام مناسب، پیش از پیمایش طول آرایه را بررسی کنید.
$(function() {
$("button").on("click", function() {
const items = $("li").toArray();
if (items.length === 0) {
console.log("موردی برای نمایش وجود ندارد.");
return;
}
items.forEach(function(item) {
console.log(item.textContent.trim());
});
});
});
اگر در یک پروژه از متدهای jQuery استفاده می کنید، تبدیل به آرایه همیشه ضروری نیست. این متد را زمانی به کار ببرید که آرایه واقعی برای شما مزیت مشخصی دارد؛ برای مثال، زمانی که می خواهید از روش های استاندارد جاوااسکریپت استفاده کنید، عناصر را به یک تابع دیگر بدهید یا داده های مرتبط را با روش های آرایه پردازش کنید.