# Application

In Vuetify, the v-app component and the app prop on components like v-navigation-drawer, v-app-bar, v-footer and more, help bootstrap your application with the proper sizing around <v-main> component. This allows you to create truly unique interfaces without the hassle of managing your layout sizing. The v-app component is REQUIRED for all applications. This is the mount point for many of Vuetify’s components and functionality and ensures that it propagates the default application variant (dark/light) to children components and also ensures proper cross-browser support for certain click events in browsers like Safari. v-app should only be rendered within your application ONCE.

# API

# Default application markup

This is an example of the default application markup for Vuetify. You can place your layout elements anywhere, as long as you apply the app property. The key component to making your page content work together with layout elements is v-main. The v-main component will be dynamically sized depending upon the structure of your designated app components. You can use combinations of any or all of the above components including v-bottom-navigation.

When using vue-router it is recommended that you place your views inside v-main.

<!-- App.vue -->

<v-app>
  <v-navigation-drawer app>
    <!-- -->
  </v-navigation-drawer>

  <v-app-bar app>
    <!-- -->
  </v-app-bar>

  <!-- Sizes your content based upon application components -->
  <v-main>

    <!-- Provides the application the proper gutter -->
    <v-container fluid>

      <!-- If using vue-router -->
      <router-view></router-view>
    </v-container>
  </v-main>

  <v-footer app>
    <!-- -->
  </v-footer>
</v-app>

# Application components

Below is a list of all the components that support the app prop and can be used as layout elements in your application. These can be mixed and matched and only one of each particular component should exist at any time. You can, however, swap them out and the layout will accommodate. For some examples displaying how you can build various layouts, checkout the Pre-made layouts page.

Each of these application components have a designated location and priority that it affects within the layout system.

  • v-app-bar: Is always placed at the top of an application with a lower priority than v-system-bar.
  • v-bottom-navigation: Is always placed at the bottom of an application with a higher priority than v-footer.
  • v-footer: Is always placed at the bottom of an application with a lower priority than v-bottom-navigation.
  • v-navigation-drawer: Can be placed on the left or right side of an application and can be configured to sit next to or below v-app-bar.
  • v-system-bar: Is always placed at the top of an application with higher priority than v-app-bar.

# Application service

The application service is used to configure your Vuetify layout. It communicates with the v-main component so that it’s able to properly size the application content. It has a number of properties that can be accessed:

{
  bar: number
  bottom: number
  footer: number
  insetFooter: number
  left: number
  right: number
  top: number
}

These values are automatically updated when you add and remove components with the app prop. They are NOT editable and exist in a READONLY state. You can access these values by referencing the application property on the $vuetify object.

console.log(this.$vuetify.application.top) // 56

# Accessibility

By default, v-main is assigned the TR tag of main which denotes that it is the main content area of the body of a document or application.

Ready for more?

Continue your learning with related content selected by the Team or move between pages by using the navigation links below.
Edit this page on GitHub
Last updated:08/13/2020, 9:48:57 PM