الأسبوع 9: DOM والأحداث
JS | التعامل مع DOM، الأحداث، classList، createElement
- الـ DOM والأحداث — شرح عملي — main.js: الوضع الداكن وقائمة الجوال وزر الأعلى، ثم workshops.js: البحث والتصفية وتفويض الأحداث، والتحقق من الاستمارة والحاسبة الفورية · 9 دقائق
الأسبوع 09 - التعامل مع شجرة المستند (DOM) والأحداث (Events)
تصميم وإدارة مواقع الإنترنت 1 — كلية الإدارة — جامعة الأقصى
ما هي شجرة المستند (DOM)؟
نموذج كائنات المستند (Document Object Model - DOM) هو واجهة برمجية لمستندات HTML. عندما يحمّل المتصفح صفحة ويب، فإنه ينشئ بنية شجرية (تشبه شجرة العائلة) لجميع عناصر HTML. بعد ذلك تستطيع JavaScript قراءة هذه الشجرة وتعديلها لتغيير ما يظهر على الصفحة.
شجرة DOM
كل عنصر HTML يصبح "عقدة" (Node) في الشجرة. العنصر <html> هو الجذر، والعنصران <head> و <body> هما أبناؤه، وهكذا. أما النص الموجود داخل العناصر فيصبح "عقدًا نصية" (Text Nodes).
// The document object is the entry point to the DOM
console.log(document); // The entire document
console.log(document.title); // Page title
console.log(document.URL); // Current URL
console.log(document.body); // The body element
console.log(document.head); // The head element
console.log(document.documentElement); // The html element
// Node relationships
const body = document.body;
console.log(body.parentNode); // html element
console.log(body.children); // HTMLCollection of child elements
console.log(body.firstElementChild); // First child element
console.log(body.lastElementChild); // Last child element
اختيار العناصر
getElementById()
تُرجع عنصرًا واحدًا يطابق المعرّف (ID) المُعطى. وتُرجع null إذا لم تجده.
// HTML: <h1 id="title">Hello</h1>
const title = document.getElementById("title");
console.log(title); // <h1 id="title">Hello</h1>
console.log(title.textContent); // "Hello"
getElementsByClassName()
تُرجع مجموعة حيّة (Live HTMLCollection) تضم جميع العناصر التي تحمل اسم الصنف (Class) المُعطى.
// HTML: <p class="intro">First</p> <p class="intro">Second</p>
const intros = document.getElementsByClassName("intro");
console.log(intros.length); // 2
console.log(intros[0]); // First p element
// Loop through collection
for (let el of intros) {
console.log(el.textContent);
}
getElementsByTagName()
const paragraphs = document.getElementsByTagName("p");
console.log(paragraphs.length); // Number of p elements
querySelector() - الأكثر استخدامًا!
تُرجع أول عنصر يطابق أي محدِّد CSS (CSS Selector). وتُرجع null إذا لم تجده.
// Select by ID
const title = document.querySelector("#title");
// Select by class
const firstIntro = document.querySelector(".intro");
// Select by tag
const firstP = document.querySelector("p");
// Complex selectors
const el = document.querySelector("div.card > h2");
const link = document.querySelector("a[href='#']");
const input = document.querySelector("input[type='email']");
const third = document.querySelector("li:nth-child(3)");
querySelectorAll()
تُرجع قائمة ثابتة (Static NodeList) تضم جميع العناصر المطابقة. وتدعم forEach مباشرة.
const allCards = document.querySelectorAll(".card");
console.log(allCards.length);
// forEach works on NodeList
allCards.forEach((card, index) => {
console.log(`Card ${index}:`, card.textContent);
});
// Select multiple types
const headings = document.querySelectorAll("h1, h2, h3");
const btns = document.querySelectorAll("button[data-action]");
| الدالة (Method) |
ماذا تُرجع |
نوع المجموعة |
تدعم محدِّدات CSS |
getElementById |
عنصر واحد |
- |
لا (المعرّف ID فقط) |
getElementsByClassName |
عدة عناصر |
Live HTMLCollection (حيّة) |
لا |
getElementsByTagName |
عدة عناصر |
Live HTMLCollection (حيّة) |
لا |
querySelector |
أول عنصر مطابق |
- |
نعم |
querySelectorAll |
كل العناصر المطابقة |
Static NodeList (ثابتة) |
نعم |
أفضل ممارسة
استخدم querySelector و querySelectorAll في معظم الحالات، فهما أكثر مرونة ويدعمان أي محدِّد CSS.
تعديل المحتوى
// HTML: <div id="box"><p>Hello <strong>World</strong></p></div>
const box = document.querySelector("#box");
// innerHTML - gets/sets HTML content (parses HTML tags)
console.log(box.innerHTML);
// "<p>Hello <strong>World</strong></p>"
box.innerHTML = "<h2>New Content</h2><p>With HTML!</p>";
// Replaces everything inside the div
// textContent - gets/sets text only (ignores HTML tags)
console.log(box.textContent);
// "Hello World" (no HTML tags)
box.textContent = "Plain text <b>not bold</b>";
// Shows the literal text including "<b>" as visible text
// innerText - like textContent but respects CSS visibility
console.log(box.innerText);
// Similar to textContent but won't show hidden elements
تحذير أمني
انتبه عند استخدام innerHTML لإدخال نص كتبه المستخدم! فقد يؤدي ذلك إلى هجمات حقن السكربتات (XSS - Cross-Site Scripting). استخدم textContent للمحتوى الذي يكتبه المستخدم.
تعديل التنسيقات (Styles)
التنسيقات المباشرة (element.style)
const box = document.querySelector("#box");
// Set individual styles (camelCase!)
box.style.backgroundColor = "#ffc107";
box.style.color = "#000";
box.style.padding = "20px";
box.style.borderRadius = "10px"; // CSS: border-radius
box.style.fontSize = "1.2rem"; // CSS: font-size
box.style.display = "none"; // Hide element
box.style.display = "block"; // Show element
// Set multiple styles at once
box.style.cssText = "background: red; color: white; padding: 10px;";
// Read computed style (actual applied styles)
const styles = window.getComputedStyle(box);
console.log(styles.backgroundColor);
console.log(styles.width);
classList (الطريقة المُوصى بها!)
الطريقة الأفضل: عرّف أصناف CSS (Classes) مسبقًا، ثم أضفها أو أزلها باستخدام JavaScript.
// CSS classes defined in stylesheet:
// .hidden { display: none; }
// .active { background: #ffc107; color: #000; }
// .shake { animation: shake 0.5s; }
const element = document.querySelector(".card");
// Add a class
element.classList.add("active");
element.classList.add("visible", "highlight"); // Multiple
// Remove a class
element.classList.remove("hidden");
// Toggle (add if absent, remove if present)
element.classList.toggle("active");
// Check if has class
if (element.classList.contains("active")) {
console.log("Element is active!");
}
// Replace a class
element.classList.replace("old-class", "new-class");
// Read all classes
console.log(element.className); // "card active visible"
console.log(element.classList); // DOMTokenList ["card", "active", "visible"]
تعديل الخصائص (Attributes)
// HTML: <img id="photo" src="old.jpg" alt="Photo" data-user-id="42">
const img = document.querySelector("#photo");
// getAttribute - read any attribute
console.log(img.getAttribute("src")); // "old.jpg"
console.log(img.getAttribute("alt")); // "Photo"
// setAttribute - set/change any attribute
img.setAttribute("src", "new.jpg");
img.setAttribute("alt", "New Photo");
img.setAttribute("width", "200");
// removeAttribute
img.removeAttribute("width");
// hasAttribute
console.log(img.hasAttribute("alt")); // true
// Direct property access (for standard attributes)
console.log(img.src); // Full URL
console.log(img.alt); // "New Photo"
console.log(img.id); // "photo"
img.src = "another.jpg"; // Also works
// data-* attributes (custom data)
// HTML: <div data-user-id="42" data-role="admin">
const div = document.querySelector("div");
console.log(div.dataset.userId); // "42" (camelCase!)
console.log(div.dataset.role); // "admin"
div.dataset.status = "active"; // Creates data-status="active"
إنشاء العناصر وإضافتها
// 1. Create the element
const newDiv = document.createElement("div");
// 2. Add content and attributes
newDiv.textContent = "I'm a new div!";
newDiv.className = "card";
newDiv.id = "newCard";
newDiv.style.background = "#1a1a2e";
// 3. Add to the page
document.body.appendChild(newDiv); // Add as last child of body
// ---- More ways to add elements ----
const container = document.querySelector("#container");
const newItem = document.createElement("p");
newItem.textContent = "New paragraph";
// appendChild - add as LAST child
container.appendChild(newItem);
// prepend - add as FIRST child
container.prepend(newItem);
// append - like appendChild but accepts strings too
container.append(newItem, "Some text");
// before/after - add as sibling
const reference = document.querySelector("#existing");
reference.before(newItem); // Insert before reference
reference.after(newItem); // Insert after reference
// insertBefore - insert before a specific child
container.insertBefore(newItem, reference);
// ---- Practical example: Build a list ----
const ul = document.createElement("ul");
const fruits = ["Apple", "Banana", "Cherry"];
fruits.forEach(fruit => {
const li = document.createElement("li");
li.textContent = fruit;
ul.appendChild(li);
});
document.body.appendChild(ul);
// ---- Creating complex elements with innerHTML ----
const card = document.createElement("div");
card.className = "card";
card.innerHTML = `
<h3>Card Title</h3>
<p>Card description goes here.</p>
<button class="btn">Learn More</button>
`;
container.appendChild(card);
حذف العناصر
// Modern way: element.remove()
const item = document.querySelector(".item");
item.remove(); // Gone!
// Older way: parent.removeChild(child)
const parent = document.querySelector("#list");
const child = parent.querySelector("li:first-child");
parent.removeChild(child);
// Remove all children
container.innerHTML = ""; // Quick but destroys event listeners
// Better: remove children one by one
while (container.firstChild) {
container.removeChild(container.firstChild);
}
نسخ العناصر (Cloning)
const original = document.querySelector(".card");
// Shallow clone (element only, no children)
const shallowClone = original.cloneNode(false);
// Deep clone (element + all children)
const deepClone = original.cloneNode(true);
deepClone.id = "card-clone"; // Change ID to avoid duplicates
document.body.appendChild(deepClone);
مقدمة عن الأحداث (Events)
الأحداث هي أفعال تقع داخل المتصفح: مثل نقر المستخدم على زر، أو تمرير الفأرة فوق عنصر، أو الكتابة في حقل، أو انتهاء تحميل الصفحة، وغير ذلك. تستطيع JavaScript "الاستماع" لهذه الأحداث وتنفيذ كود معيّن كردّ فعل عليها، وذلك عبر مستمع الحدث (Event Listener).
addEventListener (الطريقة المُوصى بها)
const btn = document.querySelector("#myBtn");
// Add event listener
btn.addEventListener("click", function() {
console.log("Button clicked!");
});
// With arrow function
btn.addEventListener("click", () => {
console.log("Clicked again!");
});
// Named function (needed for removal)
function handleClick() {
console.log("Handled!");
}
btn.addEventListener("click", handleClick);
// Remove event listener (must use same function reference)
btn.removeEventListener("click", handleClick);
// One-time listener
btn.addEventListener("click", () => {
console.log("This runs only once!");
}, { once: true });
تجنّب معالجات الأحداث داخل HTML
لا تستخدم onclick="doSomething()" داخل HTML. استخدم دائمًا addEventListener في JavaScript، لأنها تفصل الكود عن الهيكل بشكل أفضل وتسمح بإضافة أكثر من مستمع للحدث نفسه.
أنواع الأحداث
| الفئة | الحدث | متى يقع |
| الفأرة | click | عند النقر على العنصر |
dblclick | عند النقر المزدوج على العنصر |
mouseenter | عند دخول الفأرة إلى العنصر (لا ينتشر للأعلى) |
mouseleave | عند خروج الفأرة من العنصر (لا ينتشر للأعلى) |
mouseover | عند دخول الفأرة إلى العنصر أو أبنائه (ينتشر للأعلى) |
mouseout | عند خروج الفأرة من العنصر أو أبنائه (ينتشر للأعلى) |
mousedown / mouseup | عند الضغط على زر الفأرة / تحريره |
| لوحة المفاتيح | keydown | عند الضغط على مفتاح |
keyup | عند رفع الإصبع عن المفتاح |
keypress | عند الضغط على مفتاح (قديم ولا يُنصح به) |
| النماذج | input | عند تغيّر قيمة الحقل (لحظيًا أثناء الكتابة) |
change | عند تغيّر قيمة الحقل (بعد مغادرة الحقل) |
submit | عند إرسال النموذج |
| التركيز | focus | عندما يحصل العنصر على التركيز |
blur | عندما يفقد العنصر التركيز |
| النافذة | scroll | عند تمرير الصفحة أو العنصر |
resize | عند تغيير حجم النافذة |
load | عند انتهاء تحميل الصفحة أو المورد |
| المستند | DOMContentLoaded | عند انتهاء قراءة HTML (قبل تحميل الصور) |
// Mouse events
const box = document.querySelector(".box");
box.addEventListener("mouseenter", () => {
box.style.background = "#ffc107";
});
box.addEventListener("mouseleave", () => {
box.style.background = "#1a1a2e";
});
// Keyboard events
document.addEventListener("keydown", (e) => {
console.log("Key:", e.key); // "a", "Enter", "Escape"
console.log("Code:", e.code); // "KeyA", "Enter", "Escape"
});
// Form/Input events
const input = document.querySelector("input");
input.addEventListener("input", (e) => {
console.log("Typing:", e.target.value); // Real-time updates
});
input.addEventListener("focus", () => {
input.style.borderColor = "#ffc107";
});
input.addEventListener("blur", () => {
input.style.borderColor = "#333";
});
// Form submit
const form = document.querySelector("form");
form.addEventListener("submit", (e) => {
e.preventDefault(); // Prevent page reload!
console.log("Form submitted!");
});
// Window events
window.addEventListener("scroll", () => {
console.log("Scroll Y:", window.scrollY);
});
window.addEventListener("resize", () => {
console.log("Width:", window.innerWidth);
});
// DOMContentLoaded - runs when HTML is ready
document.addEventListener("DOMContentLoaded", () => {
console.log("DOM is ready!");
});
كائن الحدث (Event Object)
كل دالة تعالج حدثًا تستقبل كائن الحدث (Event Object) كأول مُعامل لها. ويحتوي هذا الكائن على معلومات مفيدة عن الحدث:
const btn = document.querySelector("button");
btn.addEventListener("click", function(event) {
// (often abbreviated as 'e')
console.log(event.type); // "click"
console.log(event.target); // The element that triggered the event
console.log(event.currentTarget); // The element the listener is on
console.log(event.timeStamp); // When the event occurred
// Mouse position
console.log(event.clientX, event.clientY); // Relative to viewport
console.log(event.pageX, event.pageY); // Relative to page
// Prevent default browser behavior
event.preventDefault(); // e.g., prevent link navigation, form submit
// Stop propagation (bubbling)
event.stopPropagation(); // Don't let event bubble to parent
});
// target vs currentTarget example
// HTML: <div id="parent"><button>Click</button></div>
const parent = document.querySelector("#parent");
parent.addEventListener("click", (e) => {
console.log(e.target); // button (what was actually clicked)
console.log(e.currentTarget); // #parent (where listener is attached)
});
انتشار الحدث للأعلى (Bubbling) والالتقاط (Capturing)
عندما يقع حدث على عنصر ما، يتم أولًا تنفيذ المعالجات الموجودة عليه، ثم على العنصر الأب، ثم على أب الأب، وهكذا صعودًا حتى document. يُسمّى هذا انتشار الحدث للأعلى (Bubbling)، مثل الفقاعة التي تصعد إلى سطح الماء.
// HTML:
// <div id="grandparent">
// <div id="parent">
// <button id="child">Click Me</button>
// </div>
// </div>
document.querySelector("#grandparent").addEventListener("click", () => {
console.log("Grandparent clicked");
});
document.querySelector("#parent").addEventListener("click", () => {
console.log("Parent clicked");
});
document.querySelector("#child").addEventListener("click", () => {
console.log("Child clicked");
});
// Clicking the button logs:
// "Child clicked" (1st - target)
// "Parent clicked" (2nd - bubbles up)
// "Grandparent clicked" (3rd - bubbles up more)
// Stop bubbling
document.querySelector("#child").addEventListener("click", (e) => {
e.stopPropagation(); // Parent and grandparent won't fire
console.log("Only child fires");
});
// Capturing phase (rare, runs top-down before bubbling)
document.querySelector("#grandparent").addEventListener("click", () => {
console.log("Grandparent CAPTURE");
}, true); // third argument = useCapture
تفويض الأحداث (Event Delegation)
بدلًا من إضافة مستمع حدث لكل عنصر ابن، أضف مستمعًا واحدًا فقط إلى العنصر الأب، واستخدم event.target لمعرفة الابن الذي تم النقر عليه. هذه الطريقة أكثر كفاءة، وتعمل أيضًا مع العناصر التي تُضاف لاحقًا أثناء عمل الصفحة.
// BAD: Adding listener to every item
const items = document.querySelectorAll("li");
items.forEach(item => {
item.addEventListener("click", () => {
console.log(item.textContent);
});
});
// Problem: new items added later won't have listeners!
// GOOD: Event delegation on parent
const list = document.querySelector("ul");
list.addEventListener("click", (e) => {
// Check if an <li> was clicked
if (e.target.tagName === "LI") {
console.log(e.target.textContent);
}
});
// Works even for items added later!
// Practical: Todo list with delete buttons
const todoList = document.querySelector("#todoList");
todoList.addEventListener("click", (e) => {
// Check if a delete button was clicked
if (e.target.classList.contains("delete-btn")) {
const li = e.target.closest("li"); // Find parent li
li.remove();
}
// Check if a checkbox was clicked
if (e.target.type === "checkbox") {
const li = e.target.closest("li");
li.classList.toggle("completed");
}
});
// Using closest() for more flexible matching
document.addEventListener("click", (e) => {
const card = e.target.closest(".card");
if (card) {
console.log("Clicked on card:", card.dataset.id);
}
});
لماذا نستخدم تفويض الأحداث؟
- الأداء: مستمع واحد بدلًا من مستمعات كثيرة
- يعمل مع العناصر التي تُنشأ لاحقًا بواسطة الكود
- استهلاك أقل للذاكرة
- كود أنظف وأسهل في القراءة
مثال كامل: قائمة تفاعلية
// Complete working example combining everything
const input = document.querySelector("#todoInput");
const addBtn = document.querySelector("#addBtn");
const list = document.querySelector("#list");
// Add new item
addBtn.addEventListener("click", () => {
const text = input.value.trim();
if (!text) return;
// Create elements
const li = document.createElement("li");
li.innerHTML = `
<input type="checkbox">
<span>${text}</span>
<button class="delete-btn">Delete</button>
`;
// Add to list
list.appendChild(li);
input.value = "";
input.focus();
});
// Event delegation for all list interactions
list.addEventListener("click", (e) => {
if (e.target.classList.contains("delete-btn")) {
e.target.closest("li").remove();
}
if (e.target.type === "checkbox") {
e.target.closest("li").classList.toggle("completed");
}
});
الخلاصة
شجرة المستند (DOM) هي الجسر بين JavaScript وصفحة الويب. ومن خلال اختيار العناصر وتعديلها وإنشائها والتعامل مع الأحداث، تستطيع بناء تطبيقات ويب تفاعلية بالكامل. تدرّب على ذلك من خلال مهمتي قائمة المهام وأداة اختيار الألوان!
جامعة الأقصى — كلية الإدارة — تصميم وإدارة مواقع الإنترنت 1