App Vue Component

App Components
App Props
Examples

App Vue component is the main app component that allows to define global theme (iOS or Material) and other useful globals.

If you use Konsta UI with other framework (like Framework7 or Ionic), you should use KonstaProvider instead.

App Components

There are following components included:

App

App Props

Name	Type	Default	Description
component	string	'div'	Component's HTML Element
dark	boolean	false	Include `dark:` variants (if dark theme is in use)
safeAreas	boolean	true	Adds `safe-areas` class to the container. Should be enabled if app container is the full screen element to properly handle screen safe areas
theme	'ios' \| 'material' \| 'parent'	'material'	App theme. If set to `'parent'` it will look for `ios` or `md` class on root `<html>` element, useful to use with parent framework like Framework7 or Ionic
touchRipple	boolean	true	Enables touch ripple effect in Material theme. Allows to globally disable touch ripple for all components

Examples

App component should be used as main wrapper for all Konsta UI components, and there should be only one App component at a time in the app:

<template>
  <!-- App component ideally should be the main root component -->
  <k-app theme="ios" safe-areas>
    <!-- rest of Konsta UI components -->
  </k-app>
</template>
<script>
  import { kApp } from 'konsta/vue';

  export default {
    components: {
      kApp,
    },
  };
</script>