Skip to content
Vuejs integration for Ionic v4
Branch: master
Clone or download
Latest commit ef9291f Apr 5, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Remove unused packages and files (#45) Oct 11, 2018
build Silence rollup warning Mar 22, 2019
src Update router direction type Mar 28, 2019
test Allow HTML elements to be attached to DOM (#28) Sep 5, 2018
types Update router direction type Mar 28, 2019
.babelrc Add babel config Jul 31, 2018
.editorconfig
.gitignore Improve typescript typings and config (#44) Oct 11, 2018
CODE_OF_CONDUCT.md Initial commit Jul 3, 2018
CONTRIBUTING.md Initial commit Jul 3, 2018
LICENSE Initial commit Jul 3, 2018
README.md Update README.md Apr 5, 2019
jest.config.js Sonarqube (#10) Aug 1, 2018
package-lock.json [release] 1.3.2 Mar 28, 2019
package.json [release] 1.3.2 Mar 28, 2019
sonar-project.properties Sonarqube updates (#17) Aug 14, 2018
tsconfig.json
tslint.json Features/typescript (#39) Oct 8, 2018

README.md

Ionic-Vue becomes @ionic/vue

Important: This project has been contributed to the Ionic core and can be used as @ionic/vue.

Modus Create engineers will continue to support the community at the Ionic's official Issue board

However, this repository is still being actively maintained and kept in-sync with the official @ionic/vue. The main difference being the availability of IonicVueRouter and flexibility of choosing dependency versions.

Our goal is to allow developers to be on the bleeding-edge and freely experiment, thus we are delivering features and bug fixes as fast as possible. Apart from the router you can switch between the libraries without any changes to your code-base.

Bug fixes, features, documentation and any other changes will be contributed back as well.



Ionic-Vue

CircleCI codecov SonarQube PRs Welcome MIT Licensed

Ionic integration adapters for Vue.

@modus/ionic-vue

Roadmap

Overview: all of the controllers and major features such as transitions and router have been implemented and tested for several months now. Apart from minor improvements and further testing of various mixes of Ionic components and implementations this library is considered feature complete.

Feature Status @ionic/vue Notes
Router ✔️ ✔️ Fully implemented
Router View ✔️ ✔️ Fully implemented
Tabs ✔️ ✔️ Fully implemented
Controllers ✔️ ✔️ Fully implemented
TypeScript ✔️ ✔️ Fully implemented
Unit tests Outdated as were originally written in plain JS, need to be updated for TS

Installing / Getting started

A quick introduction of the minimal setup you need to get a hello world up & running.

npm install @modus/ionic-vue

Now you can use it during the initialization step of your Vue app.

import Vue from 'vue'
import Ionic, { IonicVueRouter } from '@modus/ionic-vue'
import Home from './Home.vue'

Vue.use(Ionic)
Vue.use(IonicVueRouter)

new Vue({
  router: new IonicVueRouter({
    routes: [
      { path: '/', component: Home },
      { path: '/page', component: () => import('./Page.vue') }
    ],
  }),
}).$mount('ion-app')

Ionic requires a root element of ion-app in your HTML.

IonicVueRouter requires ion-vue-router element in order to render Ionic transitions. Otherwise you can use the official VueRouter

<!DOCTYPE html>
<html lang="en">
  <head>...</head>

  <body>
    <ion-app>
      <ion-vue-router />
    </ion-app>
  </body>
</html>

IonicVue

IonicVue abstracts DOM interaction of Ionic UI components inside a Vue application and can be used via this.$ionic.

Vue.component('Foo', {
  methods: {
    notify() {
      this.$ionic.alertController
        .create({
          header: 'Notification',
          subHeader: null,
          message: 'Hello World',
          buttons: ['Bye'],
        })
        .then(a => a.present())
        .catch(console.error)
    },
  },
})

IonicVue supports all of the Ionic controllers:

IonicVueRouter

IonicVueRouter binds Ionic transitions and routing functionalities with Vue Router.

It is an extension of the official Vue Router thus it can be used as a drop-in replacement with all of the methods, hooks, etc. working as expected.

Developing

Setting up Dev

Simply clone the repo and install dependencies to get started with development.

git clone https://github.com/moduscreateorg/ionic-vue.git
cd ionic-vue/
npm install

Testing will require peer dependencies to be installed. Peer dependencies are:

  • vue
  • vue-template-compiler
  • vue-router
  • @ionic/core

You can install peer dependencies without modifying package.json.

npm run install.peer

We recommend trying out your ionic-vue changes in an actual app. You can do that with npm link:

cd ionic-vue/
npm link
cd ../sample-app/
npm link @modus/ionic-vue

Beep is a fantastic sample application you can use to test ionic-vue.

Building

Rollup automatically creates distribution packages.

For development build run:

npm run dev

For automatic rebuild on changes run:

npm run watch

For production build run:

npm run prod

Tests

Make sure you have installed peer dependencies (explained above) before running tests.

npm test

Static Analysis

The ionic-vue project uses SonarQube's SonarCloud product for static analysis scans.

Our publicly available dashboard for the project can be found here

Modus Create

Modus Create is a digital product consultancy. We use a distributed team of the best talent in the world to offer a full suite of digital product design-build services; ranging from consumer facing apps, to digital migration, to agile development training, and business transformation.

Modus Create

This project is part of Modus Labs.

Modus Labs

Licensing

This project is MIT licensed.

You can’t perform that action at this time.