Oversigt

Vue.js er et progressivt JavaScript-framework til at bygge brugergrænseflader. Det er designet til at kunne adopteres trinvist og fokuserer på view-laget, hvilket gør det nemt at integrere med andre biblioteker eller eksisterende projekter.

Før du begynder
Sørg for at have dit dashboard åbent - du skal bruge de Git-loginoplysninger, der vises der. Denne skabelon inkluderer Vue 3, Tailwind CSS 4, Pinia til state management og Vue Router.

Kom godt i gang

1

Opret repository fra skabelon

Gå til fanen Tools & Deployment på dit dashboard. Klik på "New Repository", vælg Vue.js-skabelonen i dropdown-menuen, indtast et repository-navn og et subdomæne, og klik på "Create Repository".

2

Klon dit repository

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>
3

Installer afhængigheder

npm install
4

Start udviklingsserver

npm run dev

Åbn http://localhost:4200 i din browser.

5

Build & push

npm run build
git add .
git commit -m "Initial setup"
git push origin main
Hver push til Git udruller automatisk din applikation. Tjek din Module Work URL på dashboardet for at se din live-side.

Lokal udvikling med Docker

Hvis du ikke har Node.js installeret lokalt, kan du bruge Docker til at køre Vue-kommandoer. Projektet indeholder en Dockerfile til produktions-builds med nginx.

Hvad er Docker?
Docker opretter isolerede "containere" med al den software, du har brug for (Node.js, npm), uden at installere dem på din computer. Tænk på det som en letvægts virtuel maskine.

Forudsætninger

Installer Docker Desktop til dit operativsystem (Windows, Mac eller Linux).

Kør kommandoer med Docker

# Run npm install
docker run --rm -v $(pwd):/app -w /app node:lts-alpine npm install

# Run development server (accessible at localhost:4200)
docker run --rm -v $(pwd):/app -w /app -p 4200:4200 node:lts-alpine npm run dev

# Build for production
docker run --rm -v $(pwd):/app -w /app node:lts-alpine npm run build
Bemærk
Docker er valgfrit til lokal udvikling. NStrim-platformen håndterer udrulning automatisk - du behøver kun Docker, hvis du vil køre kommandoer lokalt uden Node.js installeret.

Projektstruktur

Forstå hvor filerne er placeret:

├── src/
│   ├── assets/               # Statiske assets (billeder, fonts)
│   ├── components/           # Vue-komponenter
│   ├── views/                # Side-komponenter
│   ├── router/               # Vue Router-konfiguration
│   ├── stores/               # Pinia-stores
│   ├── App.vue               # Rod-komponent
│   └── main.js               # Applikationens entry point
├── public/                   # Offentlige statiske filer
├── index.html                # HTML entry point
├── vite.config.js            # Vite-konfiguration
├── package.json              # Afhængigheder og scripts
└── Dockerfile                # Docker build-konfiguration
        

Almindelige opgaver

Opret en komponent

Opret .vue-filer i src/components/:

<!-- src/components/Button.vue -->
<script setup>
defineProps({
  label: String
});

const emit = defineEmits(['click']);
</script>

<template>
  <button
    class="bg-blue-500 text-white px-4 py-2 rounded"
    @click="emit('click')"
  >
    {{ label }}
  </button>
</template>

Tilføj en rute

Rediger src/router/index.js:

import { createRouter, createWebHistory } from 'vue-router';
import Home from '../views/Home.vue';
import About from '../views/About.vue';

const router = createRouter({
  history: createWebHistory(),
  routes: [
    { path: '/', component: Home },
    { path: '/about', component: About }
  ]
});

export default router;

Brug af Pinia store

Opret en store i src/stores/:

// src/stores/counter.js
import { defineStore } from 'pinia';

export const useCounterStore = defineStore('counter', {
  state: () => ({ count: 0 }),
  actions: {
    increment() { this.count++ },
    decrement() { this.count-- }
  }
});

Brug af Tailwind CSS

Tailwind CSS 4 er forudkonfigureret. Brug klasserne direkte i dine skabeloner:

<div class="bg-blue-500 text-white p-4 rounded-lg">
  Hello Tailwind!
</div>

Nyttige kommandoer

npm run dev Start udviklingsserver (port 4200)
npm run build Build til produktion
npm run preview Forhåndsvis produktions-build lokalt
npm run test:unit Kør unit-tests med Vitest
npm run lint Tjek og ret kodestil
npm run format Formatér kode med Prettier

Fejlfinding

npm install fejler med tilladelsesfejl

Årsag: Tilladelsesproblemer med npm-cache eller node_modules.

Løsning: Slet node_modules-mappen og package-lock.json, og kør derefter npm install igen.

Port 4200 er allerede i brug

Årsag: En anden proces bruger port 4200.

Løsning: Brug en anden port: npm run dev -- --port 3000 eller stop den anden proces.

Komponent opdateres ikke

Årsag: Reaktivitet er ikke opsat korrekt.

Løsning: Brug ref() til primitive værdier og reactive() til objekter. Tilgå ref-værdier med .value i script, men ikke i template.

Router virker ikke

Årsag: RouterView mangler i App.vue, eller routeren er ikke registreret.

Løsning: Sørg for, at <RouterView /> er i App.vue, og at routeren er tilføjet med app.use(router) i main.js.

Build fejler efter udrulning

Årsag: Build-fejl eller manglende afhængigheder.

Løsning: Kør npm run build lokalt først for at tjekke for fejl, før du pusher.

Udrulnings-workflow

Hver gang du pusher kode til Git, bygges og udrulles din applikation automatisk:

Kodeændring git push npm run build Udrul til nginx Live!

Din udrullede applikations-URL har dette format:

https://<your-subdomain>-<repo-name>.<session-domain>

Eksempel: https://student01-module-a.demo.nstrim.app

For mere information, besøg den officielle Vue.js-dokumentation.