Berkontribusi

Edit dokumentasi ini

Terjemahkan dokumentasi atau buka proyek lengkap di komputer Anda.

Tidak ada yang dipublikasikan hingga Anda memilih untuk mengirimkan pekerjaan Anda.

Perutean Frontend

Menggunakan perutean frontend dalam aplikasi Wails Anda

Perutean frontend merupakan cara populer untuk beralih tampilan dalam aplikasi satu halaman. Panduan ini membahas pendekatan yang direkomendasikan untuk berbagai framework frontend saat menggunakan Wails.

Pendekatan yang direkomendasikan untuk perutean di Vue adalah Mode Hash:

javascript
import { createRouter, createWebHashHistory } from "vue-router";

const router = createRouter({
  history: createWebHashHistory(),
  routes: [
    //...
  ],
});

Mode hash menggunakan hash URL untuk merender tampilan yang berbeda sehingga menghindari masalah akibat runtime Wails yang mengganggu perutean, dengan menggunakan format URL berbasis hash.

Mengapa Menggunakan Perutean Hash?

Wails menyematkan frontend Anda ke dalam jendela webview native. Penggunaan perutean berbasis hash (#/page, bukan /page) menghindari konflik dengan:

  • Perutean internal runtime Wails
  • Penanganan URL jendela native pada berbagai platform
  • Aset produksi yang disajikan dari jalur selain root

Pemecahan Masalah

Jika Anda mengalami masalah dengan perutean frontend dalam build produksi:

  • Pastikan alat build frontend Anda dikonfigurasi untuk menghasilkan output bagi perutean mode hash
  • Untuk proyek berbasis Vite, tambahkan base: "./" ke vite.config.js
  • Pastikan index.html Anda menangani fallback dengan benar untuk perutean SPA
Edit halaman

Terakhir diperbarui: