npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@simonbackx/vue-app-navigation

v2.8.2

Published

Navigation library for Vue for web apps that need to feel and work like native apps (inspired by iOS)

Downloads

709

Readme

vue-app-navigation

Navigation library for Vue for web apps that need to feel and work like native apps (inspired by iOS)

Installation

Yarn

yarn add @simonbackx/vue-app-navigation

NPM

npm install @simonbackx/vue-app-navigation

Example

Concepts

  • URL based navigation isn't fit for mobile applications. You should be able to keep pushing new views, and you should be able to navigate back to earlier states without having to keep in mind how to rebuild the state of earlier components. It just needs to 'work'.
  • By allowing views to navivate to other views as they please, you don't need one place where you specify all your possible routes. The possibilities are endless. You can keep on pushing views on your navigation controller.
  • Your app should always scroll on the document, never on a different element - expect in popups or during transitions. This makes sure the toolbars disappear and appear properly in mobile browsers.
  • When you display a view modally, it will take over the document scroll position. The outgoing view will disappear from the DOM with a temporary scroll position to allow a good animation.
  • You can move components around like the vue component, but better. Without having to keep it in one place. This allowed us to build a splitview controller that propertly handles screen rotation.
  • Display fixed elements with sticky. You can also use 'fixed', but that won't work if you use popups.

The class ComponentWithProperties is a temporary container that manages some things for you. You can use it to pass arround a component with properties (without having to render it). You can display it using the ComponentWithPropertiesInstance component. As soon as you display it somewhere, it will keep track of its component instance. If you want to move the component to a different place in the DOM, you can set keepAlive to true just before you remove the component instance from the DOM. This will use the same underlying system as the component to make sure the component instance is not destroyed. With the same reference to your ComponentWithProperties instance you can show it again in a different ComponentWithPropertiesInstance component while maintaining the state of the component instance you displayed earlier. keepAlive will automatically jump back to false again as it will detect that you've shown the component again.

ComponentWithProperties has a debug counter to show and log the amount of component instances that are still in memory.

Normally, you don't need to use ComponentWithPropertiesInstance directly, since this library also provides the components your need for building your app navigation: NavigationController & SplitViewController.

Todo

  • Allow some way to have URL's redirect to a specific hierarchy of components (± comparable with how universtal links work in native apps)
  • Add complete documentation