svelte-guard-history-router
Advanced tools
svelte guarded history router
article/:id<a href="/home">Home</a> elements<DefailRoute>
<Route path="/detail/:detail"/>
</DefailRoute>
<Router>
<Route path="/subjectA">
<DefailRoute/>
</Route>
<Route path="/subjectB">
<DefailRoute/>
</Route>
</Router>
<script>
import { Router, Route, Outlet, redirectGuard } from "svelte-guard-history-router";
import About from "./About.svelte";
import Categories from "./Categories.svelte";
import Category from "./Category.svelte";
import Articles from "./Articles.svelte";
import Article from "./Article.svelte";
import { enshureSession } from "./main.mjs";
export const enshureSession = redirectGuard("/login", () => !session);
let session = undefined;
</script>
<Router base="/base">
<nav>
<!-- catch all but link to '/' -->
<Route href="/" path="*" component={Home}>Router Example</Route>
<ul class="left">
<li>
<Route path="/about" component={About}>About</Route>
</li>
<li>
<Route path="/article" guards={enshureSession} component={Articles}>
Articles
<Route path="/:artice" component={Article}/>
</Route>
</li>
<li>
<Route path="/category" guards={enshureSession} component={Categories}>
Categories
<Route path="/:category" component={Category}/>
</Route>
</li>
</ul>
</nav>
<main>
<Outlet/>
</main>
</Router>
Check out the code in the example folder, or the live example.
To run the sample, clone the repository, install the dependencies, and start:
git clone https://github.com/arlac77/svelte-guard-history-router
cd svelte-guard-history-router
npm install
npm start
then navigate to localhost:5000
export BROWSER=safari|chrome|...
yarn test
or
npm test
Keeps the the node active state in sync.
node any router Router Keys also act as svelte stores and can be subscribed.
export const article = derived(
[articles, router.keys.article],
([$articles, $id], set) => {
set($articles.find(a => a.id === $id));
return () => {};
}
);
Type: Object
Extends BaseTransition
key subscriptions:
const aKey = router.keys.aKey;
$aKey // fired if value of aKey changes
linkNodes Set<Node> nodes having their active state updatedroutes Array<Route> keys Object collected keys of all routesparams Object value mapping from keys (from current route)route Route currentnested Transition ongoing nested transitionbase string urlCurrent component. Either from a nested transition or from the current route
Returns SvelteComponent
Value if the current route
Returns any
Returns string url path with fragment & query
Replace current route.
path string Replace current route without updating the state.
path string Returns Object former state
Leave current route and enter route for given path. The work is done by a Transition.
path string where to goReturns Transition running transition
Called from a Transition to manifest the new destination. If path is undefined the Transition has been aborderd.
path string Continue a transition to its original destination. Shortcut for this.transition.continue(). If there is no transition ongoing and a fallbackPath is present, it will be entered. Otherwise does nothing.
fallbackPath string Abort a transition. Shortcut for this.transition.abort() If there is no transition ongoing and a fallbackPath is present it will be entered. Otherwise does nothing.
fallbackPath string Router subscription. Changes in the current route will trigger a update
subscription Function Update the active state of a node. A node is considered active if it shared the path prefix with the current route.
node Node Add a new Route.
route Route Find Route for a given value.
value any Returns Route able to support given value
Find path for a given value.
value any suffix String to be appendedReturns String path + suffix
Deliver url search params form the current location.
Returns URLSearchParams as extracted from the path
Replaces the search part of the path with the given searchParams.
searchParams (URLSearchParams | Object) Add another transition nesting level. Starts a transition from the given factory.
path string factory Transition Continue a nested route to its original destination. Does nothing if the transition has not been nested.
Abort the transition.
error Returns boolean truen in case there was a nesten transition
Extends ValueStoreRoute
Route to represent a slice of the masters list of values.
master Route route holding the master recordsRoute holding the list ov values
Returns Route our master
Returns any 1st. entry
Returns any last entry
Returns any previous value
Returns any next value
Enforces conditions of routes Like the presents of values in the context
Called while entering a route (current outlet is not yet set)
transition Transition Called before leaving a route
transition Transition Redirects to a given path if condition is met.
Execute guards in a sequence.
children Iterable<Guard> Execute guards in a parallel.
children Iterable<Guard> Extends SkeletonRoute
Route holding a ordered collection of values.
path options value Array<any> Default empty guard does nothing.
Route at the root of the tree. This route has no parent. All other routes are below of this one.
Are there parameters in the path.
Returns boolean true if route has parameters (:key)
Returns string empty as we are the root
Returns object empty object
Returns Guard empty guard which does nothing
Extends RootRoute
Route Subscriptions on Routes fire when the route value changes.
path options (optional, default {})path string full path of the Route including all parentscomponent SvelteComponent target to showlinkComponent SvelteComponent content for ObjectLinkpropertyMapping Object Map properties to object attributes
Keys are the property names and values are the keys in the resulting object.priority number keys Array<string> as found in the pathregex RegEx value any Enter the route from a former one. All parent routes up to the common ancestor are entered first.
transition Transition untilRoute Route the common ancestor with the former routeLeave the route to a new one. All parent routes up to the common ancestor are left.
transition Transition untilRoute Route the common ancestor with the future routeCheck if value and properties are acceptable for the route.
value any to be placed into routeproperties Object as presented in the routeReturns boolean true if value can be accepted
Extract properties from a value. All property values must be strings.
value any source of the propertiesReturns (Object | undefined) properties extracted from given value
Find common ancestor with an other Route.
other Route Returns (Route | undefined) common ancestor Route between receiver and other
Deliver value for a given set of properties of the transition. Default implemantation asks the parent route.
transition Transition Returns any for matching properties
Deliver route value. Default implemantation asks the parent route.
Returns any
Deliver property mapping. Default implemantation asks the parent route.
Returns Object for matching properties
Default implemantation asks the parent route.
Extends SkeletonRoute
Route holding a single value
Extends BaseTransition
Transition between routes.
router Router path string new destinationrouter Router path string new destinationStart the transition
Cleanup transition. Update Nodes active state
Halt current transition and go to another route. To proceed with the original route call continue() The original transition will keept in place and can be continued afterwards.
path string new route to enter temporaryBring back the router into the state before the transition has started. All nested transitions also will be termniated.
e (Exception | undefined) Walks up the dom tree parents unti a node with a given attribute is found or the root node is reached.
element Element attributeName stringg Returns Element
Dispatches a NAVIGATION_EVENT with pathname and hash
event Event Create a named object wich can act as a store.
name string value any initial valuevalue any Returns Store
Extends Guard
Shows a component during transition.
component SvelteComponent to show up during th transitionrampUpTime number initial delay for the componnt to show up (optional, default 300)With npm do:
npm install svelte-guard-history-router
With yarn do:
yarn add svelte-guard-history-router
All unresolvable requests are redirected to /sericeBase/index.html
location /serviceBase {
alias /deploymentLocation;
try_files $uri$args $uri$args/ /serviceBase/index.html;
}
publish a _redirects file into the app root folder
/* /index.html 200
BSD-2-Clause
FAQs
svelte router for SPA (history mode only)
The npm package svelte-guard-history-router receives a total of 388 weekly downloads. As such, svelte-guard-history-router popularity was classified as not popular.
We found that svelte-guard-history-router demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
An advanced npm supply chain attack is leveraging Ethereum smart contracts for decentralized, persistent malware control, evading traditional defenses.
Security News
Research
Attackers are impersonating Sindre Sorhus on npm with a fake 'chalk-node' package containing a malicious backdoor to compromise developers' projects.
Security News
The npm package for the LottieFiles Player web component was hit with a supply chain attack after a software engineer's npmjs credentials were compromised.