15. Projekt [vuejs-13]: Aktualisieren einer Komponente mithilfe einer Sitzung

Das Projekt [vuejs-13] baut auf dem Projekt [vuejs-12] auf und führt folgende Änderung ein: Das von der HTML-Tabelle angezeigte Array wird in einem [session]-Objekt definiert, das allen Komponenten bekannt ist. Dies ist somit eine Möglichkeit, Informationen zwischen Komponenten auszutauschen. Dieses Konzept ist direkt von der Web-Session inspiriert. Wir nutzen die Plugin-Methode, um dieses gemeinsam genutzte Objekt über das Attribut [Vue.$session] verfügbar zu machen.

Die Verzeichnisstruktur des Projekts sieht wie folgt aus:

15.1. Das [session]-Objekt

Das von allen Komponenten gemeinsam genutzte [session]-Objekt ist im Skript [./session.js] definiert:


const session = {
  // liste des simulations
  get lignes() {
    return this._lignes;
  },
  // génération de la liste des simulations
  generateLignes() {
    this._lignes =
      [
        { id: 3, marié: "oui", enfants: 2, salaire: 35000, impôt: 1200 },
        { id: 5, marié: "non", enfants: 2, salaire: 35000, impôt: 1900 },
        { id: 7, marié: "non", enfants: 0, salaire: 30000, impôt: 2000 }
      ]
  },
  // suppression ligne n° index
  deleteLigne(index) {
    this._lignes.splice(index, 1);
  }
}
// export de l'objet [session]
export default session;

15.2. Das Plugin [./plugins/pluginSession]

Das Skript [pluginSession] lautet wie folgt:


export default {
  install(Vue, session) {
    // ajoute une propriété [$session] à la classe vue
    Object.defineProperty(Vue.prototype, '$session', {
      // lorsque Vue.$session est référencé, on rend le 2ième paramètre [session] de la méthode [install]
      get: () => session,
    })
  }
}

Zeile 4: Das gemeinsam genutzte Objekt [session] ist in der Eigenschaft [$session] aller Komponenten verfügbar;

15.3. Das Hauptskript [main.js]

Das Hauptskript [main.js] lautet wie folgt:


// imports
import Vue from 'vue'
import App from './App.vue'

// plugins
import BootstrapVue from 'bootstrap-vue'
Vue.use(BootstrapVue);
 
// bootstrap
import 'bootstrap/dist/css/bootstrap.css'
import 'bootstrap-vue/dist/bootstrap-vue.css'
 
// session
import session from './session';
import pluginSession from './plugins/pluginSession'
Vue.use(pluginSession, session)
 
// configuration
Vue.config.productionTip = false
 
// instanciation projet [App]
new Vue({
  name: "app",
  render: h => h(App),
}).$mount('#app')

Zeilen 14–16: Das [pluginSession]-Plugin wird in das [Vue.js]-Framework integriert;
Nach Zeile 16 steht das Attribut [$session] allen Komponenten zur Verfügung;

15.4. Die Hauptansicht [App]

Die Ansicht [App] sieht nun wie folgt aus:


<template>
  <div class="container">
    <b-card>
      <!-- message -->
      <b-alert show variant="success" align="center">
        <h4>[vuejs-13] : mise à jour d'un composant, partage des données avec une session</h4>
      </b-alert>
      <!-- table HTML -->
      <Table @updateTable="updateTable" :key="versionTable"/>
    </b-card>
  </div>
</template>
 
<script>
import Table from "./components/Table";
export default {
  // nom
  name: "app",
  // composants
  components: {
    Table
  },
  // état interne
  data() {
    return {
      // version table
      versionTable: 1
    };
  },
 
  // méthodes
  methods: {
    updateTable() {
      // eslint-disable-next-line
      console.log("App updateTable");
      // incrément version table
      this.versionTable++;
    }
  }
};
</script>

Kommentare

Die Ansicht [App] verwaltet die von der Komponente [Table] in Zeile 9 angezeigte Tabelle nicht mehr;
Zeile 9: Die [Table]-Komponente löst das [updateTable]-Ereignis aus, das eine Neu-Rendering der [Table]-Komponente anfordert. Eine Möglichkeit, dies zu erreichen, ist die Verwendung des [:key]-Attributs. Wir weisen diesem Attribut einen veränderbaren Wert zu. Jedes Mal, wenn dieser Wert geändert wird, wird die [Table]-Komponente neu gerendert;
Zeile 9: Der Wert des Attributs [:key] ist das Attribut [versionTable] in Zeile 27. Die Methode [updateTable] (Zeilen 33–38) ist dafür zuständig, die [Table]-Komponente aus Zeile 9 neu zu generieren. Dazu erhöht die Methode in Zeile 37 den Wert des Attributs [:key] der [Table]-Komponente. Die [Table]-Komponente wird daraufhin automatisch neu generiert;

15.5. Die [Table]-Komponente

Die [Table]-Komponente entwickelt sich wie folgt:


<template>
  <div>
    <!-- empty list -->
    <template v-if="lignes.length==0">
      <b-alert show variant="warning">
        <h4>Votre liste de simulations est vide</h4>
      </b-alert>
      <!-- reload button-->
      <b-button variant="primary" @click="rechargerListe">Recharger la liste</b-button>
    </template>
    <!-- non-empty list-->
    <template v-if="lignes.length!=0">
      <b-alert show variant="primary" v-if="lignes.length==0">
        <h4>Liste de vos simulations</h4>
      </b-alert>
      <!-- simulation table -->
      <b-table striped hover responsive :items="lignes" :fields="fields">
        <template v-slot:cell(action)="row">
          <b-button variant="link" @click="supprimerLigne(row.index)">Supprimer</b-button>
        </template>
      </b-table>
    </template>
  </div>
</template>
 
<script>
export default {
  // état calculé
  computed: {
    lignes() {
      return this.$session.lignes;
    }
  },
  // état interne
  data() {
    return {
      fields: [
        { label: "#", key: "id" },
        { label: "Marié", key: "marié" },
        { label: "Nombre d'enfants", key: "enfants" },
        { label: "Salaire", key: "salaire" },
        { label: "Impôt", key: "impôt" },
        { label: "", key: "action" }
      ]
    };
  },
  // méthodes
  methods: {
    supprimerLigne(index) {
      // eslint-disable-next-line
      console.log("Table supprimerLigne", index);
      // on supprime la ligne
      this.$session.deleteLigne(index);
      // on demande au composant parent de mettre à jour la vue
      this.$emit("updateTable");
    },
    // rechargement de la liste affichée
    rechargerListe() {
      // eslint-disable-next-line
      console.log("Table rechargerListe");
      // on régènère la liste des simulations
      this.$session.generateLignes();
      // on demande au composant parent de mettre à jour la vue
      this.$emit("updateTable");
    }
  }
};
</script>

Kommentare:

Das Attribut [rows] (Zeilen 4, 12, 17) ist nicht mehr ein von der übergeordneten Komponente festgelegter Parameter, sondern ein berechnetes Attribut der [Table]-Komponente (Zeilen 30–32). [rows] ist daher das Array [$session.rows] (Zeile 31);
Zeilen 49–56: Die Methode [deleteRow] entfernt eine Zeile aus dem Array [$session.rows]. Standardmäßig ändert diese Löschung nichts an der Darstellung der HTML-Tabelle. Das liegt daran, dass die Elemente von [$session] nicht reaktiv sind: Änderungen an ihnen werden in den Komponenten, die sie verwenden, nicht berücksichtigt. Aus diesem Grund fordert die [Table]-Komponente ihre übergeordnete Komponente auf, sie mithilfe des [updateTable]-Ereignisses neu zu generieren (Zeile 55). Wir haben gesehen, dass die übergeordnete Komponente daraufhin das [:key]-Attribut der [Table]-Komponente erhöht, um deren Neugenerierung zu erzwingen;
Zeilen 58–65: Die Methode [reloadList] fordert das Objekt [$session] auf, das Array [$session.rows] neu zu generieren. Aus dem gleichen Grund wie zuvor ändert diese Änderung von [$session.list] standardmäßig nichts an der Darstellung der HTML-Tabelle. Aus diesem Grund fordert die [Table]-Komponente ihre übergeordnete Komponente auf, sie mithilfe des [updateTable]-Ereignisses neu zu generieren (Zeile 64).

15.6. Ausführen des Projekts

Wir erhalten die gleichen Ergebnisse wie im Projekt [vuejs-12].