在**傳統 DOM 事件處理器**(onclick、onkeydown 等)中,return false 相當於同時執行:
event.preventDefault(); // 取消預設行為
event.stopPropagation(); // 停止事件冒泡
<a href="/page" onclick="return handleClick(this)">Link</a>
function handleClick(el) {
if (!el.dataset.confirmed) {
alert('確定離開?');
return false; // 取消跳轉
}
return true; // 允許跳轉
}
<form onsubmit="return validateForm(this)">...</form>
function validateForm(form) {
if (!form.email.value.includes('@')) {
alert('Email 格式錯誤');
return false; // 取消提交
}
return true;
}
<div onclick="alert('div clicked')">
<button onclick="event.stopPropagation(); return false;">按鈕</button>
</div>
不推薦 內聯 onclick="return false",推薦使用 addEventListener 並顯式呼叫:
const link = document.querySelector('a');
link.addEventListener('click', (e) => {
if (!confirm('確定離開?')) {
e.preventDefault(); // 僅取消預設行為
// e.stopPropagation(); // 僅在需要時阻止冒泡
}
});
| 綁定方式 | return false 效果 | 推薦做法 |
|---|---|---|
內聯 onclick="..." | preventDefault + stopPropagation | 避免使用 |
屬性 el.onclick = fn | 同上 | 改用 addEventListener |
addEventListener | **無效**(僅返回值被忽略) | 顯式呼叫 preventDefault/stopPropagation |
jQuery .on() | preventDefault + stopPropagation(jQuery 內部處理) | 可用,但建議顯式調用 |
| React 合成事件 | **無效** | e.preventDefault() |
onsubmit 返回 false 可阻止提交,但 addEventListener('submit') 必須用 e.preventDefault()。return false 才能同時取消預設行為與冒泡。e.preventDefault() 和 e.stopPropagation(),語義清晰、不受綁定方式影響。return false 仍被支援,但官方文檔建議改用 e.preventDefault()。