HTML5-Tutorium: JavaScript: Hello World Vue 06

aus GlossarWiki, der Glossar-Datenbank der Fachhochschule Augsburg

Dieser Artikel erfüllt die GlossarWiki-Qualitätsanforderungen nur teilweise:

Korrektheit: 3
(zu größeren Teilen überprüft)
Umfang: 4
(unwichtige Fakten fehlen)
Quellenangaben: 3
(wichtige Quellen vorhanden)
Quellenarten: 5
(ausgezeichnet)
Konformität: 3
(gut)

Vorlesung WebProg

Inhalt | Teil 1 | Teil 2 | Teil 3 | Teil 4 | Teil 5 | Teil 6 | Vue 1 | Vue 2 | Vue 3 | Vue 4 | Vue 5 | Vue 6

Musterlösung
Git-Repository, git checkout v06, ... v06a, ... v06b

Anwendungsfälle (Use Cases)

Die Version des fünften Teils des Vue-Tutoriums wird so angepasst, dass die Sprache zur Laufzeit geändert werden kann.

Zunächst wird jedoch eine Navigationskomponente eingeführt. Dies hat den Zweck, das Routing an einem Beispiel zu erklären.

Aufgabe

Aufgabe: Konfigurieren und internationalisieren Sie die Anwendung mit Hilfe von dynamischen JSON-Dateien.

Erstellen eines neuen Projektzweigs

Erstellen Sie einen neuen Projektzweig (branch) innerhalb von hello_world_vue und fügen Sie das Package uuid hinzu:

git checkout v05d    # Wechsle in den Branch v05d mit Express-Server
git checkout -b v06  # Klone v05d in einen neuen Branch v06
rm -rf express_Hello_world
cd frontend
npm i
npm i vue-router

In der Datei public/json/config.jso aktivieren wir wieder den Zugriff auf die lokalen JSON-Dateien. Den Zugriff auf den Backend-Server, um die Bilder von dort zu holen, behandeln wir später.

{ "startSection":    "form",
  "apiRoot":         "/json/i18n_$1.json",
  "XapiRoot":        "/api/$1",
  "defaultLanguage": "de"
}

Fügen Sie außerdem in die Datei vite.config.common.js zwei geeignete Aliase für view und router ein.

Views

Anstelle von Sections werden im Frontend Views verwendet. Dazu werden die Section-Komponenten in den Ordner View verschoben und umbenannt:

src/view/ViewHello.vue
src/view/ViewHome.vue     // an Stelle von ViewForm.vue

src/view/ViewError404.vue // neu

Die CSS-Dateien müssen natürlich auch entsprechend verschoben und abgepasst werden.

ViewForm.vue wird in ViewHome.vue unbenannt, da diese Seite als Startseite verwendet wird.

Zusätzlich wird eine Seite ViewError404.vue angelegt, die immer dann ausgeliefert wird, wenn der Benutzer auf eine URL zugreift, der keine View-Datei zugeordnet ist.

Die CSS-Dateien sollten analog umbenannt und unter den neuen Namen importiert werden. Für ViewError404.vue muss natürlich auch eine CSS-Datei angelegt werden. Diese verweist allerdings nur auf View.css.

<!-- src/view/ViewError404.vue -->

<script setup>
  import router    from '/router'
  import storeI18n from '/store/StoreI18n'

  const phrases = storeI18n().phrases
</script>

<template>
  <h1>404</h1>
  <p>{{phrases.pageNotFound.replace('$1', router.currentRoute.value.path)}}</p>
</template>

<style scoped>
  @import '/css/view/ViewError404.css';
</style>

Router-Plugin

Um mit Vue Multipage-Anwendungen realisieren zu können, benötigt man einRouter-Plugin. Dieses muss zunächst händisch auf Basis von vue-router implementiert werden.

// src/router/index.js

import { createRouter, createWebHistory } from 'vue-router'
import ViewHome                           from '/view/ViewHome.vue'

const
  routes =
    [ { path: '/',
        name: 'home',
        component: ViewHome,
      },
      { path: '/hello',
        name: 'hello',
        component: () => import('/view/ViewHello.vue'),
      },
      { path:      '/:pathMatch(.*)',
        component: () => import('/view/ViewError404.vue'),
      }
    ],

  router =
    createRouter({ history: createWebHistory(), routes })

export default router

Nun muss man das neu erstellte Plugin in die App integrieren.

// src/main.js

import { createPinia } from 'pinia'
import { createApp }   from 'vue'
import getJson         from '/service/getJson'
import router          from './router'  // './router/index.js'
import App             from './App.vue'
const
  pinia   = createPinia(),
  app     = createApp(App),
  init    = async () =>
            { app
                .provide('config', await getJson('/json/config.json'))
                .use(pinia)
                .use(router)
                .mount('#app') // app is shown to the user
            }

window.addEventListener('load', init)

index.html

Da das main-Tag nun innerhalb von App.vue verwendet werden soll, wird es aus der Datei index.html entfernt.

...
  <body id="app">
  </body>
...

App.vue

Nun kann in die App eine Navigation eingebaut werden.

<!-- /src/App.vue -->

<script setup>
  import AppNav       from '/component/AppNav.vue'
  import storeSession from '/store/StoreSession'
  import storeI18n    from '/store/StoreI18n'

  const session = storeSession()

  storeI18n();

  session.initialize();
</script>

<template>
  <p      v-if="!session.isInitialized">Loading ...</p>
  <AppNav v-if="session.isInitialized"/>
  <main   v-if="session.isInitialized">
    <router-view/>
  </main>
</template>

<style>
  @import '/css/body.css';
</style>

Die zugehörige Navigationskomponente muss auch noch implementiert werden.

<!-- /src/component/AppNav.vue -->

<script setup>
</script>

<template>
  <nav>
    <ul>
      <li><router-link to="/">Home</router-link></li>
      <li><router-link to="/hello">Hello</router-link></li>
    </ul>
  </nav>
</template>

<style scoped>
  @import '/css/component/AppNav.css';
</style>
/* src/css/_config.css */
...
--background-color:  #C5EFFC;
--link-color:        #0027d4;
...
--nav-dist:          0.5em;


/* src/css/AppNav.css */

@import 'config.css';

nav
{ top:      0;
  width:    100%;
  position: fixed;

  ul
  { list-style-type: none;
    margin: 0 var(--nav-dist);
    padding: 0;

    li
    { display: inline;
      a { padding: 0 var(--nav-dist); }
    }

    a
    { text-decoration: none;
      color:           var(--link-color);
      font-weight:     bold;
    }

    a:hover, .router-link-exact-active
    { text-decoration: underline;
      color:           var(--link-color);
      font-weight:     bold;
    }
  }

  label, input
  { margin: 0;
  }
}

Navigation

Die Navigation muss in allen Komponenten, in den Seiten gewechselt werden, angepasst werden.

Das ist in der App.vue der Fall (siehe zuvor) sowie in der ViewHome.vue.

<!-- /src/vie/ViewHome.vue  -->

<script setup>
  import FormButton    from '/component/form/FormButton.vue'
  import FormTextfield from '/component/form/FormTextfield.vue'

  import storeSession  from '/store/StoreSession'
  import storeGreeting from '/store/StoreGreeting'
  import router        from '/router'

  const
    session    = storeSession(),
    greeting   = storeGreeting(),
    dictionary = greeting.dictionary,
    sayHello   = () => router.push('/hello')
</script>

Die Section-Verwaltung der ehemaligen Single-Page-Anwendung kann und sollte gelöscht werden:

  • config.js
  • storeSession.js
  • ViewHome.vue
  • ViewHello.vue

Die Datei HelloWorld.vue kann (samt CSS-Datei) ganz gelöscht werden.

Hello World Vue 06a

Aufgabe: Die Ausgabesprache soll vom Benutzer zur Laufzeit geändert werden können. Die Sprachen sollen durch Bilder (Flaggen) symbolisiert werden.

git checkout v06      # Wechsle in den Branch v06
git checkout -b v06a  # Klone v06 in einen neuen Branch v06a

config.json

Um die vorhandenen Sprachen durchblättern zu können, wird ein einfacher Automat verwendet.

// src/public/json/config.json

{ "apiRoot":         "/json/i18n_$1.json",
  "XapiRoot":        "/api/$1",
  "defaultLanguage": "en",
  "nextLanguage":    {"de": "en", "en": "de"}
}

StoreI18n.js: Integration von nextLanguage

Der Automat nextLanguage wird in den StoreI18n integriert. Wenn die Methode changeLang ohne Argument aufgerufen wird, soll der Automat die aktuelle Sprache lang durch die Nachfolgersprache ersetzen. Dazu sollte zunächst die zunächst Konstante nextLanguage definiert werden.

...
lang =
  ref(null),

nextLanguage =
  reactive(config.nextLanguage),

...

Diese neue Konstante nextLanguage wird verwendet, um die Sprache mittels changeLang zu definieren, sofern kein Argument übergeben wurde.

Die Funktion changeLang soll bei einer Änderung der Sprache sowohl die notwendige JSON-Sprach-Datei laden als auch die in der HTML-Datei index.html ausgewiesene Sprache anpassen:

// /src/store/storeI18N.js

changeLang =
  async (p_lang = null) =>
        { lang.value = p_lang ?? nextLanguage[lang.value];
          await getI18n(lang.value);
          document.getElementsByTagName('html')[0].lang = lang.value;
        }

initialize = 
  async resolve => 
        { await changeLang(config.defaultLanguage); 
          resolve(); 
        }

Bilder von Flaggen

Zur Visualisierung der gewählten Sprache werden Bilder von Flaggen eingesetzt. Wir kopieren die Bilder im SVG-Format aus dem NPM-Paket "https://github.com/lipis/flag-icons".

npm i -D flag-icons

Im Ordner "node_modules/flag-icons/flags/4x3" finden Sie Flaggen zahlreicher Länder im 4-zu-3-Format. Kopieren Sie die Flaggen der Länder Deutschland und Großbritanien in den Ordner public/img.

In die Datei config.js wird der Pfad, unter dem die Bilder zu finden sind, eingefügt.

//   public/config.js
...
  "apiRoot":  "/json/i18n_$1.json",
  "imgPath":  "/img/$1.svg",
  "XapiRoot": "/api/$1"
...

FormButtonIcon

Eine neue Komponente wird benötigt: FormButtonIcon Dabei handelt es sich um einen Button, der ein Icon anzeigt. Das Bild kann zur Laufzeit geändert werden.

<script setup>
  import { computed, inject } from 'vue'

  const
    props       = defineProps
                  ({ image: { type: String },
                     width: { type: String, default: '3em'},
                  }),
    config      = inject('config'),
    emit        = defineEmits(['click']),
    click       = () => emit('click'),
    require     = v_url => import.meta.url == null
                           ? v_url
                           : new URL(v_url, import.meta.url).href,
    imgPath     = config.imgPath,
    buttonImage = computed(() => require(imgPath.replace('$1', props.image)))
</script>

<template>
  <input type="image" :src="buttonImage" :style="{width}" @click="click" />
</template>

<style scoped>
  @import '/css/component/form/FormButtonIcon.css';
</style>
/* src/css/component/FormButtonIcon.css */

@import 'FormButton.css';

input
{ width:       $button_icon_width !important;
  margin-left: $nav-dist          !important;
}

Fügen Sie in src/css/_config.css noch

--button-icon-width: 1em;

ein.

Erweiterung von AppNav.vue

Der Sprachwahl-Button muss noch in die Navigation eingebaut werden. In diesem Rahmen wird auch gleich die Navigation etwas internationalisiert.

Ergänzen Sie in den Dictionaries der Dateien public/json/i18n_de.json und public/json/i18n_en.json folgende Attribute:

    ...         ...,
    "navHome":  "Start",
    "navHello": "Hallo"

bzw.

    ...         ...,
    "navHome":  "Home",
    "navHello": "Hello"

Damit können Sie das Navigationsmenü internationalisieren (einschließlich Auswahl der Sprache per Button).

<!-- src/component/AppNav.vue -->

<script setup>
  import FormButtonIcon from '/component/form/FormButtonIcon.vue'
  import storeI18n      from '/store/StoreI18n'

  const i18n = storeI18n()
</script>

<template>
  <nav>
    <ul>
      <li><router-link to="/">{{i18n.dictionary.navHome}}</router-link></li>
      <li><router-link to="/hello">{{i18n.dictionary.navHello}}</router-link></li>
      <li><FormButtonIcon :image="i18n.lang" @click="i18n.changeLang()"/></li>
    </ul>
  </nav>
</template>

<style scoped>
  @import '/css/component/AppNav.css';
</style>

Hello World Vue 06b

Aufgabe: Sorgen Sie dafür, dass autofocus korrekt funktioniert, insbesondere beim Seitenwechsel via Navigation.

Es ist sinnvoll, die Funktionalität in ein eigenes Store-Modul auszulagern, damit das Session-Modul in Anwendungen, die keine Autofocus-Funktionalität benötigen, keinen überflüssigen Code enthalten (Bertrand Meyer: Jedes Modul erfüllt genau eine Aufgabe). Das Session-Modul wird entsprechend abgespeckt.

Der Autofocus-Store soll zwei Funktionen bieten:

  • setAutofocusId: Speichert die ID des Autofokus-Elements der aktuellen Seite (Default: null).
  • setFocus: Setzt den Focus auf die aktuelle Autofokus-Komponente (sofern die ID ungleich null ist). Insbesondere für das Window-Ereignis 'visibilitychange' soll diese Funktion

aufgerufen werden.

// /src/store/StoreAutofocus.js

import { defineStore } from 'pinia'
import { ref }         from 'vue'

const storeAutofocus =
defineStore
( 'autofocus', // must be unique

  () =>
  { const
      c_autofocus_id = ref(),
      setFocus       = () => document.getElementById(c_autofocus_id.value)?.focus(),
      setAutofocusId = p_autofocus_id => { c_autofocus_id.value = p_autofocus_id; 
                                           setFocus();
                                         }

    window.addEventListener('visibilitychange', setFocus);

    return { setAutofocusId, setFocus }
  }
)

export default storeAutofocus
// /src/store/StoreSession.js

import { defineStore } from 'pinia'
import { ref }         from 'vue'

const storeSession =
defineStore
( 'session', // must be unique

  () =>
  { const
      initializers   = [],
      isInitialized  = ref(false),
      addInitializer = p_initializer =>
                       initializers.push(new Promise(resolve => p_initializer(resolve))),
      initialize     = () => Promise.all(initializers)
                                    .then(() => isInitialized.value = true)

    return { addInitializer, initialize, isInitialized }
  }
)

export default storeSession

Um die aktuelle ID speichern zu können, muss das zugehörige Textfeld die Information, welche ID es hat, per emit an die Elternkomponente ausgeben.

// /src/component/form/FormTextfield.vue

...
const
  props = defineProps
          ({ id: { type: String,  default: '' },
             ...
          })
  ... 
  emit  = defineEmits(['id', 'update:text', 'enter']),
...
emit('id', inputId);
...

Nun müssen die Views, die ein Autofokus-Feld beinhalten, dieses an den Session-Store melden, sobald sie per Routing aktiviert werden. Das ist in unserem Fall nur die ViewHome. Ein Watcher sorgt dafür, dass die ID des Textfeldes im Session-Objekt gespeichert wird, sobald das zugehörige Textfeld die ID per emit meldet.

// /src/view/ViewHome.vue

<script setup>
  import { ref, watch } from 'vue'
  ...
  import storeAutofocus from '/store/StoreAutofocus'
  ...

  const
    id         = ref(null),
    autofocus  = storeAutofocus(),
    ...
    setId      = p_id => id.value = p_id,
    ...

  watch( id, () => autofocus.setAutofocusId(id.value) )
</script>

<template>
  ...
        <FormTextfield @id="setId"
          ...
        >
  ...
</template>
...

Zum Schluss muss im Router noch die Autofocus-ID bei jedem Seitenwechsel gelöscht werden.

// /src/router/index.js

...
import storeAutofocus from '/store/StoreAutofocus'

const
  ...

router.beforeEach(() => storeAutofocus().setAutofocusId())

export default router

Wichtig ist hier, dass man keine Konstante session definieren kann, da die Stores erst nach dem Router-Objekt erzeugt werden:

// /src/router/index.js
...
import storeAutofocus from '/store/StoreAutofocus'

const
  autofocus = storeAutofocus(), // FUNKTIONIERT NICHT
  ...
router.beforeEach(() => autofocus.setAutofocusId())
...

Der Funktionsaufruf storeSession() darf daher erst in der Callback-Funktion von router.beforeEach aufgerufen werden. Zu diesem Zeitpunkt sind die Stores und der Router auf jeden Fall schon initialisiert worden.

Zum Abschluss sollten Sie noch versuchen, /src/component/AppNav.vue so abzuändern, dass ein Klick auf die Fahne nicht nur die Sprache ändert, sondern auch noch den Focus auf das Startfeld setzt.

Hello World Vue 06c

Aufgabe: Sorgen Sie dafür, dass die unterstützten Sprachen und der Sprach-Automat vom Backend geladen wird.

git checkout v06b     # Wechsle in den Branch v06b
git checkout -b v06c  # Klone v06b in einen neuen Branch v06c

Splitten Sie die Config-Datei zunächst in zwei Teile: "config.json" wird aus dem Public-Ordner geladen. "config_backend.json" wird normalerweise vom Backend geladen, kann aber zum Entwicklungszeitpunkt auch vom Public-Ordner geladen werden, wenn das Backend noch nicht stabil läuft.

// src/public/json/config.json

{ "configBackend":  "/json/config_backend.json",
  "apiRoot":        "/json/i18n_$1.json",
  "imgPath":        "/img/$1.svg",

  "XapiRoot":       "/api/$1"
}
// src/public/json/config_backend.json

{ "languages":    ["de", "en"],
  "nextLanguage": {"de": "en", "en": "de"}
}

Das Backend teilt dem Frontend mit, welche Sprachen unterstützt werden.

main.js

Laden Sie, nachdem Sie "config" asynchron geladen haben, "configBackend" asynchron und kopieren Sie den Inhalt dieses Objekts in das Config-Objekt. Den Pfad von "configBackend" finden Sie unter "config.configBackend".

...
const
  ...
  init = async () =>
         { const
             config        = await getJson('/json/config.json'),
             configBackend = await getJson(config.configBackend)

           Object.assign(config, configBackend)

           app
             .provide('config', config)
             .use(pinia)
             .use(router)
             .mount('#app') // app is shown to the user
         }

Nun gibt es im Konfigurationsobjekt keine Defaultsprache mehr. Im I18N-Store wird daher ab sofort die erste Sprache in der Liste der unterstützten Sprachen als Defaultsprache genutzt.

// /src/store/storeI18N.js

initialize = 
  async resolve => 
        { await changeLang(config.languages[0]); 
          resolve(); 
        }

Hello World Vue 06d

Aufgabe: Defaultmäßig soll dem Benutzer die App in der Sprache angezeigt werden, die der Benutzer im Browser voreingestellt hat. Sollte die voreingestellte Sprache nicht unterstützt werden, wird die App in der Defaultsprache angezeigt.

Legen Sie zunächst wieder einen neuen Branch an.

git checkout v06c     # Wechsle in den Branch v06c
git checkout -b v06d  # Klone v06c in einen neuen Branch v06d

Das Vorgehen ist im Prinzip ganz einfach.

Mittels des NPM-Packets "navigator-languages" ermittelt man die vom Browser unterstützten Sprachen. In der Konfigurationsdatei listet man die Sprachen auf, die von der App unterstützt werden. Besser wäre es natürlich, diese Liste vom Backend zu laden, damit die App mit bekommt, wenn neue Sprachen zur Verfügung stehen. Am aufwändigsten ist es, diese beiden Array zu matchen.

Mögliche Erweiterung: Auch die HTML-Pfade sollten internationalisiert werden.

npm i navigator-languages // unterstützt mehrere Browservarianten

Language Matching

Das Language Matching erfolgt zweimal mit zwei verschachtelten Schleifen. Zunächst wird überprüft, ob es exakte Übereinstimmungen gibt. Sollte das nicht der Fall sein, wird überprüft, ob es Matches zwischen den ersten beiden Buchstaben gibt ('de', 'de-AT', 'de-DE' matchen in diesem Schritt alle miteinander).

// src/util/chooseLanguage.js

import navigatorLanguages from 'navigator-languages'

const
  /**
   * @function
   * @param  { Array<string> } p_langs_available 
   *         An array of language strings containing the languages
   *         supported by the app 
   * @param  { Array<string> } [p_langs_required  = navigatorLanguages()]
   *         An array of language strings containing the languages
   *         requested by the client 
   * @return { string } 
   *         The language to be displayed
   */
  chooseLanguage =
  (p_langs_available, p_langs_required = navigatorLanguages()) =>
  { let
      lang = p_langs_available[0],
      i=0, j=0, n=p_langs_required.length, m=p_langs_available.length
  
    outer:
    { while (i<n)
      { const c_lang_required = p_langs_required[i]
        while (j<m)
        { const c_lang_availabe = p_langs_available[j]
          if (c_lang_availabe === c_lang_required)
          // both languages match perfectly
          { lang = c_lang_availabe;
            break outer;
          }
          j++
        }
        i++
      }
      i=0, j=0
      while (i<n)
      { const c_lang_required = p_langs_required[i]
        while (j<m)
        { const c_lang_availabe = p_langs_available[j]
          if (c_lang_availabe.substring(0,2) === c_lang_required.substring(0,2))
          // main part of the languages match
          { lang = c_lang_availabe;
            break outer;
          }
          j++
        }
        i++
      }
    }
  
     return lang
   }

export default chooseLanguage

src/store/StoreI18n

Im I18N-Store wird nun beim Initialisieren nicht nicht mehr eine Defaultspache geladen, sondern die Sprache, die möglichst nah an den Wünschen des im Browser des Benutzers gespeicherten Sprachwünschen liegt.

Beachten Sie, dass Sie in die Datei vite.config.common.js einen geeigneten Alias für den util-Pfad definieren müssen, um '/util/chooseLanguage' an Stelle von '@/util/chooseLanguage' schreiben zu können.

...
import chooseLanguage from '/util/chooseLanguage'
...
      () =>
      { const
          ...
          initialize = 
             async resolve => 
                   { await changeLang(chooseLanguage(config.languages)); 
                     resolve(); 
                   }
        ...
...


Quellen

  1. Kowarschick (WebProg): Wolfgang Kowarschick; Vorlesung „Web-Programmierung“; Hochschule: Hochschule Augsburg; Adresse: Augsburg; Web-Link; 2024; Quellengüte: 3 (Vorlesung)