mirror of
https://github.com/metosin/reitit.git
synced 2026-01-10 09:09:50 +00:00
Merge pull request #259 from metosin/ignore-anchor-click-fn
Ignore anchor click fn
This commit is contained in:
commit
500d5d6540
2 changed files with 74 additions and 32 deletions
|
|
@ -18,6 +18,31 @@ request to the server. This means the URL will look normal, but the downside is
|
|||
that the server must respond to all routes with correct file (`index.html`).
|
||||
Check examples for simple Ring handler example.
|
||||
|
||||
### Anchor click handling
|
||||
|
||||
HTML5 History router will handle click events on anchors where the href
|
||||
matches the route tree (and other [rules](../../modules/reitit-frontend/src/reitit/frontend/history.cljs#L84-L98)).
|
||||
If you have need to control this logic, for example to handle some
|
||||
anchor clicks where the href matches route tree normally (i.e. browser load)
|
||||
you can provide `:ignore-anchor-click?` function to add your own logic to
|
||||
event handling:
|
||||
|
||||
```clj
|
||||
(rfe/start!
|
||||
router
|
||||
{:use-fragment false
|
||||
:ignore-anchor-click? (fn [router e el uri]
|
||||
;; Add additional check on top of the default checks
|
||||
(and (rfh/ignore-anchor-click? router e el uri)
|
||||
(not= "false" (gobj/get (.-dataset el) "reititHandleClick"))))})
|
||||
|
||||
;; Use data-reitit-handle-click to disable Reitit anchor handling
|
||||
[:a
|
||||
{:href (rfe/href ::about)
|
||||
:data-reitit-handle-click false}
|
||||
"About"]
|
||||
```
|
||||
|
||||
## Easy
|
||||
|
||||
Reitit frontend routers require storing the state somewhere and passing it to
|
||||
|
|
|
|||
|
|
@ -67,6 +67,29 @@
|
|||
(first (.composedPath original-event))
|
||||
(.-target event))))
|
||||
|
||||
(defn ignore-anchor-click?
|
||||
"Precicate to check if the anchor click event default action
|
||||
should be ignored. This logic will ignore the event
|
||||
if anchor href matches the route tree, and in this case
|
||||
the page location is updated using History API."
|
||||
[router e el uri]
|
||||
(let [current-domain (if (exists? js/location)
|
||||
(.getDomain (.parse Uri js/location)))]
|
||||
(and (or (and (not (.hasScheme uri)) (not (.hasDomain uri)))
|
||||
(= current-domain (.getDomain uri)))
|
||||
(not (.-altKey e))
|
||||
(not (.-ctrlKey e))
|
||||
(not (.-metaKey e))
|
||||
(not (.-shiftKey e))
|
||||
(or (not (.hasAttribute el "target"))
|
||||
(contains? #{"" "_self"} (.getAttribute el "target")))
|
||||
;; Left button
|
||||
(= 0 (.-button e))
|
||||
;; isContentEditable property is inherited from parents,
|
||||
;; so if the anchor is inside contenteditable div, the property will be true.
|
||||
(not (.-isContentEditable el))
|
||||
(reitit/match-by-path router (.getPath uri)))))
|
||||
|
||||
(defrecord Html5History [on-navigate router listen-key click-listen-key]
|
||||
History
|
||||
(-init [this]
|
||||
|
|
@ -74,37 +97,22 @@
|
|||
(fn [e]
|
||||
(-on-navigate this (-get-path this)))
|
||||
|
||||
current-domain
|
||||
(if (exists? js/location)
|
||||
(.getDomain (.parse Uri js/location)))
|
||||
ignore-anchor-click-predicate (or (:ignore-anchor-click? this)
|
||||
ignore-anchor-click?)
|
||||
|
||||
;; Prevent document load when clicking a elements, if the href points to URL that is part
|
||||
;; of the routing tree."
|
||||
ignore-anchor-click
|
||||
(fn ignore-anchor-click
|
||||
[e]
|
||||
;; Returns the next matching ancestor of event target
|
||||
(when-let [el (closest-by-tag (event-target e) "a")]
|
||||
(let [uri (.parse Uri (.-href el))]
|
||||
(when (and (or (and (not (.hasScheme uri)) (not (.hasDomain uri)))
|
||||
(= current-domain (.getDomain uri)))
|
||||
(not (.-altKey e))
|
||||
(not (.-ctrlKey e))
|
||||
(not (.-metaKey e))
|
||||
(not (.-shiftKey e))
|
||||
(not (contains? #{"_blank" "self"} (.getAttribute el "target")))
|
||||
;; Left button
|
||||
(= 0 (.-button e))
|
||||
;; isContentEditable property is inherited from parents,
|
||||
;; so if the anchor is inside contenteditable div, the property will be true.
|
||||
(not (.-isContentEditable el))
|
||||
(reitit/match-by-path router (.getPath uri)))
|
||||
(.preventDefault e)
|
||||
(let [path (str (.getPath uri)
|
||||
(if (seq (.getQuery uri))
|
||||
(str "?" (.getQuery uri))))]
|
||||
(.pushState js/window.history nil "" path)
|
||||
(-on-navigate this path))))))]
|
||||
ignore-anchor-click (fn [e]
|
||||
;; Returns the next matching ancestor of event target
|
||||
(when-let [el (closest-by-tag (event-target e) "a")]
|
||||
(let [uri (.parse Uri (.-href el))]
|
||||
(when (ignore-anchor-click-predicate router e el uri)
|
||||
(.preventDefault e)
|
||||
(let [path (str (.getPath uri)
|
||||
(if (seq (.getQuery uri))
|
||||
(str "?" (.getQuery uri))))]
|
||||
(.pushState js/window.history nil "" path)
|
||||
(-on-navigate this path))))))]
|
||||
(-on-navigate this (-get-path this))
|
||||
(assoc this
|
||||
:listen-key (gevents/listen js/window goog.events.EventType.POPSTATE handler false)
|
||||
|
|
@ -133,15 +141,24 @@
|
|||
- on-navigate Function to be called when route changes. Takes two parameters, ´match´ and ´history´ object.
|
||||
|
||||
Options:
|
||||
- :use-fragment (default true) If true, onhashchange and location hash are used to store current route."
|
||||
- :use-fragment (default true) If true, onhashchange and location hash are used to store current route.
|
||||
|
||||
Options (Html5History):
|
||||
- :ignore-anchor-click? Function (router, event, anchor element, uri) which will be called to
|
||||
check if the anchor click event should be ignored.
|
||||
To extend built-in check, you can call `reitit.frontend.history/ignore-anchor-click?`
|
||||
function, which will ignore clicks if the href matches route tree."
|
||||
([router on-navigate]
|
||||
(start! router on-navigate nil))
|
||||
([router
|
||||
on-navigate
|
||||
{:keys [use-fragment]
|
||||
:or {use-fragment true}}]
|
||||
(let [opts {:router router
|
||||
:on-navigate on-navigate}]
|
||||
:or {use-fragment true}
|
||||
:as opts}]
|
||||
(let [opts (-> opts
|
||||
(dissoc :use-fragment)
|
||||
(assoc :router router
|
||||
:on-navigate on-navigate))]
|
||||
(-init (if use-fragment
|
||||
(map->FragmentHistory opts)
|
||||
(map->Html5History opts))))))
|
||||
|
|
|
|||
Loading…
Reference in a new issue