navigateTo

Like tryRoutingTo but handle the external navigation as well.

In other words, it can handle paths like /example/route, which would be considered an internal route, and also https://example.com/some/route, referencing some outside domain, which would be considered external.

Internal routes open instantly without needing to fetch any additional information from the server, while external paths make a server request.

You will generally call this method like so:

onClick { evt ->
  evt.preventDefault()
  ctx.router.navigateTo(...)

Note that if pathQueryAndFragment is a domain-less, absolute route (that is, it starts with a slash), then this method will automatically prepend this site's BasePath if it is configured.

Finally, if you pass in a path that starts with the current site's domain, then this method will treat it as an external navigation except it will use openInternalLinksStrategy instead of openExternalLinksStrategy when opening the link. This will also skip adding the BasePath prefix, because it is assumed you are grounding your link to your own domain on purpose at that point.

It may seem like an odd choice to allow an external navigation to your own site, but this enables a use-case where you might split your Kobweb site across multiple servers, e.g. one for the main site and another for subfolders, and then you can use external navigations against your own domain to jump between them.

Parameters