• Stars
    star
    260
  • Rank 151,408 (Top 4 %)
  • Language Vue
  • License
    MIT License
  • Created about 5 years ago
  • Updated 6 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A Vue wrapper for the site tour library Shepherd

vue-shepherd

Ship Shape

vue-shepherd is built and maintained by Ship Shape. Contact us for web app consulting, development, and training for your project.

npm version Download count all time npm CI Build

This is a Vue wrapper for the Shepherd, site tour, library.

npm install vue-shepherd --save

Usage

Composition API (suggested)

<template>
  <div ref="el">
    Testing
  </div>
</template>

<script setup>
  import { ref, onMounted } from 'vue'
  import { useShepherd } from 'vue-shepherd'

  const el = ref(null);

  const tour = useShepherd({
    useModalOverlay: true
  });
  
  onMounted(() =>  {
    tour.addStep({
      attachTo: { element: el.value, on: 'top' },
      text: 'Test'
    });

    tour.start();
  });
</script>

Option API

To use vue-shepherd with Option API you have to install the plugin which will add the '$shepherd' function to your vue app.

import { createApp } from 'vue';
import VueShepherdPlugin from 'vue-shepherd';
import '~shepherd.js/dist/css/shepherd.css';

createApp().use(VueShepherdPlugin).mount('#app');
<template>
  <div ref="el">
    Testing
  </div>
</template>

<script>
  import { defineComponent } from 'vue'

  export default defineComponent({
    data(){
      return {
        tour: null
      }
    },

    methods: {
      createTour(){
        this.tour = this.$shepherd({
          useModalOverlay: true
        });

        this.tour.addStep({
          attachTo: { element: this.$refs.el, on: 'top' },
          text: 'Test'
        });
      }
    },

    mounted(){
      this.createTour();
      this.tour.start();
    }
  });
</script>

SSR

For server side rendering project, you should import the vue-shepherd.ssr.js file.

import VueShepherd from 'vue-shepherd/dist/vue-shepherd.ssr.js';

Directives

WIP

More Repositories

1

shepherd

Guide your users through a tour of your app
JavaScript
11,579
star
2

tether

A positioning engine to make overlays, tooltips and dropdowns better
JavaScript
8,493
star
3

react-shepherd

A React wrapper for the site tour library Shepherd
CSS
549
star
4

angular-shepherd

An Angular wrapper for the site tour library Shepherd
TypeScript
196
star
5

ember-cli-release

Ember CLI addon for versioned release management
JavaScript
90
star
6

swach

A robust color management tool for the modern age
TypeScript
46
star
7

ember-prism

Easy ember components for syntax highlighting a-la PrismJS
JavaScript
34
star
8

ember-cli-capacitor

Add Capacitor to your Ember app.
JavaScript
28
star
9

ember-x-editable

X-editable like library for Ember
JavaScript
22
star
10

ember-3d-nav

A 3d rotating top navigation bar for Ember apps
JavaScript
22
star
11

website-ember

The code for shipshape.io
JavaScript
20
star
12

website-nuxt

Nuxt port of shipshape.io
Vue
16
star
13

ember-cli-netlify

Ember addon to configure Netlify headers and redirects
JavaScript
14
star
14

ember-drop

An Ember addon that wraps Drop.js
JavaScript
11
star
15

prember-sitemap-generator

A sitemap generator for prember apps
JavaScript
6
star
16

ember-service-worker-prember

An Ember Service Worker plugin that caches the index.html files for each prember route
JavaScript
6
star
17

website-astro

The code for the current Ship Shape website
Astro
5
star
18

ember-3d-folding-panel

An Ember addon for 3d folding panels
JavaScript
5
star
19

ember-performance-workshop

The code for the EmberConf 2018 Performance Workshop
HTML
4
star
20

ember-newton-cradle-loader

Ember addon for showing a newton cradle loading animation
JavaScript
4
star
21

ember-headroom

Ember addon to include headroom.js as an ES2015 module in your app
JavaScript
4
star
22

ember-async-await-for-each

async/await aware forEach for Ember
JavaScript
4
star
23

prember-rss-feed

Ship RSS feeds for your Prember site
JavaScript
3
star
24

ember-assign-polyfill

A polyfill for Ember.assign in <= 2.4
JavaScript
2
star
25

ember-journal

A blogging engine for Ember apps
JavaScript
2
star
26

ember-isometric-grids

JavaScript
2
star
27

bootcamp-loader

TypeScript
1
star
28

1787-astro

Astro
1
star
29

ember-debonair

Get your Ember code in ship shape
JavaScript
1
star
30

ember-showdown-highlight

JavaScript
1
star
31

glimmer-context-menu

TypeScript
1
star
32

www-website

whiskeywebandwhatnot.fm
JavaScript
1
star