aboutsummaryrefslogtreecommitdiff
path: root/docs/components/dropdowns.md
diff options
context:
space:
mode:
authorMark Otto <[email protected]>2017-04-16 14:03:25 -0700
committerMark Otto <[email protected]>2017-04-16 14:03:25 -0700
commit570efe1df6620c9bd6e70cf0bd8d87e42ac6e892 (patch)
treee4a0600341e579a45d4e2fe550362656d503490d /docs/components/dropdowns.md
parent0cb2576bf25220d35a5f4e1d33c16c2e6f3abaee (diff)
parentea1d69c64be168bb644ae9fc4450a5c85b51609b (diff)
downloadbootstrap-570efe1df6620c9bd6e70cf0bd8d87e42ac6e892.tar.xz
bootstrap-570efe1df6620c9bd6e70cf0bd8d87e42ac6e892.zip
Merge branch 'v4-dev' into form-tweaks
Diffstat (limited to 'docs/components/dropdowns.md')
-rw-r--r--docs/components/dropdowns.md4
1 files changed, 3 insertions, 1 deletions
diff --git a/docs/components/dropdowns.md b/docs/components/dropdowns.md
index 3c68f9453..0be8d4d74 100644
--- a/docs/components/dropdowns.md
+++ b/docs/components/dropdowns.md
@@ -480,7 +480,9 @@ Add `.disabled` to items in the dropdown to **style them as disabled**.
Via data attributes or JavaScript, the dropdown plugin toggles hidden content (dropdown menus) by toggling the `.show` class on the parent list item.
-On mobile devices, opening a dropdown adds a `.dropdown-backdrop` as a tap area for closing dropdown menus when tapping outside the menu, a requirement for proper iOS support. **This means that switching from an open dropdown menu to a different dropdown menu requires an extra tap on mobile.**
+{% callout info %}
+On touch-enabled devices, opening a dropdown adds empty (`$.noop`) `mouseover` handlers to the immediate children of the `<body>` element. This admittedly ugly hack is necessary to work around a [quirk in iOS' event delegation](https://www.quirksmode.org/blog/archives/2014/02/mouse_event_bub.html), which would otherwise prevent a tap anywhere outside of the dropdown from triggering the code that closes the dropdown. Once the dropdown is closed, these additional empty `mouseover` handlers are removed.
+{% endcallout %}
Note: The `data-toggle="dropdown"` attribute is relied on for closing dropdown menus at an application level, so it's a good idea to always use it.