svelte

Täydellinen käyttöönottoopas svelte -kehykselle NStrimissä

Yleiskatsaus

Svelte on moderni JavaScript-kehys, joka siirtää työn selaimesta käännösaikaan ja tuottaa erittäin optimoitua vanilla JavaScriptiä. Yhdessä SvelteKitin kanssa se tarjoaa täyden pinon kehyksen nopeiden ja tehokkaiden verkkosovellusten rakentamiseen.

Ennen aloittamista
Varmista, että kojelautasi on auki - tarvitset siellä näkyvät Git-tunnukset. Tämä malli sisältää Tailwind CSS 4:n tyylittelyyn ja käyttää Svelte 5:tä runeilla.

Pikaopas

1

Luo repositorio mallista

Siirry kojelaudallasi Tools & Deployment -välilehteen. Napsauta "New Repository" -painiketta, valitse Svelte-malli pudotusvalikosta, anna arkiston nimi ja alidomain ja napsauta "Create Repository".

2

Kloonaa repositorio

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

Asenna riippuvuudet

npm install
4

Käynnistä kehityspalvelin

npm run dev

Avaa http://localhost:4200 selaimessasi.

5

Rakenna ja lähetä

npm run build
git add .
git commit -m "Initial setup"
git push origin main
Jokainen Git-lähetys käyttöönottaa sovelluksesi automaattisesti. Tarkista moduulin työ-URL kojelaudalta nähdäksesi live-sivustosi.

Paikallinen kehitys Dockerilla

Jos sinulla ei ole Node.js:ää asennettuna paikallisesti, voit käyttää Dockeria Svelte-komentojen suorittamiseen. Projekti sisältää Dockerfilen tuotantorakennuksia varten.

Mikä on Docker?
Docker luo eristettyjä "kontteja", joissa on kaikki tarvitsemasi ohjelmistot (Node.js, npm) ilman, että niitä tarvitsee asentaa tietokoneellesi. Ajattele sitä kevyenä virtuaalikoneena.

Vaatimukset

Asenna Docker Desktop käyttöjärjestelmällesi (Windows, Mac tai Linux).

Komentojen suorittaminen Dockerilla

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

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

# Build for production
docker run --rm -v $(pwd):/app -w /app node:20-alpine npm run build
Huomio
Docker on valinnainen paikallisessa kehityksessä. NStrim-alusta hoitaa käyttöönoton automaattisesti - tarvitset Dockeria vain, jos haluat suorittaa komentoja paikallisesti ilman Node.js:n asennusta.

Projektin rakenne

Tiedostojen sijainnin ymmärtäminen:

├── src/
│   ├── routes/
│   │   ├── +page.svelte          # Home page component
│   │   └── +layout.svelte        # Root layout (wraps all pages)
│   ├── lib/
│   │   ├── index.js              # Shared exports
│   │   └── assets/               # Static assets (images, etc.)
│   ├── app.html                  # HTML template
│   └── app.css                   # Global styles (Tailwind)
├── static/                       # Public static files
├── svelte.config.js              # SvelteKit configuration
├── vite.config.js                # Vite build configuration
├── package.json                  # Dependencies and scripts
└── Dockerfile                    # Docker build configuration
        

Yleiset tehtävät

Uuden sivun luominen

Luo uusi kansio hakemistoon src/routes/ ja lisää siihen +page.svelte-tiedosto:

# Create an "about" page at /about
mkdir src/routes/about
touch src/routes/about/+page.svelte

Kansion nimestä tulee automaattisesti URL-polku.

Komponentin luominen

Luo .svelte-tiedostoja hakemistoon src/lib/ uudelleenkäytettäville komponenteille:

<!-- src/lib/Button.svelte -->
<script>
  let { label, onclick } = $props();
</script>

<button class="bg-blue-500 text-white px-4 py-2 rounded" {onclick}>
  {label}
</button>

Komponenttien tuominen

Käytä $lib-aliasta tuodaksesi lib-kansiosta:

<script>
  import Button from '$lib/Button.svelte';
</script>

<Button label="Click me" onclick={() => alert('Hello!')} />

Tailwind CSS:n käyttö

Tailwind CSS 4 on esikonfiguroitu. Käytä luokkia suoraan komponenteissasi:

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

Tilan hallinta Runesilla (Svelte 5)

Svelte 5 käyttää runeja reaktiivisuuteen:

<script>
  let count = $state(0);
  let doubled = $derived(count * 2);
</script>

<button onclick={() => count++}>
  Count: {count} (doubled: {doubled})
</button>

Hyödyllisiä komentoja

npm run dev Käynnistä kehityspalvelin (portti 4200)
npm run build Rakenna tuotantoa varten
npm run preview Esikatsele tuotantorakennusta paikallisesti
npm test Suorita yksikkötestit Vitestillä
npm run format Muotoile koodi Prettierillä
npm run lint Tarkista koodin tyyli ja virheet

Vianmääritys

npm install epäonnistuu käyttöoikeusvirheillä

Syy: Käyttöoikeusongelmat npm-välimuistin tai node_modules-kansion kanssa.

Ratkaisu: Poista node_modules-kansio ja package-lock.json, suorita sitten npm install uudelleen.

Portti 4200 on jo käytössä

Syy: Toinen prosessi käyttää porttia 4200.

Ratkaisu: Käytä eri porttia: npm run dev -- --port 3000 tai pysäytä toinen prosessi.

Moduulia ei löydy -virheet

Syy: Riippuvuuksia ei ole asennettu tai ne ovat vioittuneet.

Ratkaisu: Suorita npm install asentaaksesi kaikki riippuvuudet.

$state tai $derived ei toimi

Syy: Svelte 4 -syntaksin käyttö Svelte 5 -projektissa.

Ratkaisu: Svelte 5 käyttää runeja. Korvaa let count = 0 muodolla let count = $state(0) reaktiivista tilaa varten.

Rakennus epäonnistuu käyttöönoton jälkeen

Syy: Rakennusvirheitä tai puuttuvia riippuvuuksia.

Ratkaisu: Suorita npm run build ensin paikallisesti tarkistaaksesi virheet ennen lähetystä.

Käyttöönoton työnkulku

Joka kerta kun lähetät koodia Gitiin, sovelluksesi rakennetaan ja otetaan käyttöön automaattisesti:

Koodimuutos git push npm run build Staattiset tiedostot Tuotannossa!

Käyttöönotetun sovelluksesi URL noudattaa tätä muotoa:

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

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

Lisätietoja löydät virallisesta SvelteKit-dokumentaatiosta.