Konfigurace náhradních tras

Dokončeno

Ve front-endové aplikaci máte na straně klienta trasu /products, která zobrazuje seznam produktů pro váš nákupní seznam. Když v aplikaci přejdete na /products tak , že vyberete odkaz Produkty , adresní řádek prohlížeče potvrdí, že jste v /products. Když na této stránce aktualizujete zobrazení, očekáváte, že ho aplikace znovu načte a opět zobrazí produkty. Bez náhradní trasy se ale zobrazí chyba 404 s oznámením, že se stránka nenašla.

Chybu 404 při aktualizaci stránky vidíte proto, že prohlížeč na hostující platformu odesílá žádost o zobrazení stránky /products. Na serveru s názvem products ale není žádná stránka, která by se zobrazovala.

Naštěstí je snadné tento problém vyřešit vytvořením náhradní trasy. Náhradní trasa je trasa, která spáruje všechny požadavky na stránku, které neodpovídají na server.

Konfigurace náhradní trasy

Azure Static Web Apps podporuje vlastní pravidla směrování definovaná v volitelném souboru staticwebapp.config.json umístěném ve zdrojové složce aplikace. V objektu navigationFallback můžete definovat náhradní trasu navigace. Běžná konfigurace náhradní trasy vypadá jako v tomto příkladu.

{
  "navigationFallback": {
    "rewrite": "/index.html",
    "exclude": ["/_framework/*", "/css/*"]
  }
}

Nastavení	Hodnota	Popis
přepsat	/index.html	Soubor, který se má použít, když trasa neodpovídá žádným jiným souborům.
vyloučení	["/_framework/*", "/css/*"]	Cesty, které se mají ignorovat ze záložního směrování

Pravidlo záložní navigace se použije po všech ostatních pravidlech směrování, která se zobrazí v souboru staticwebapp.config.json .

Umístění souboru tras

Doporučené umístění pro staticwebapp.config.json je ve složce nastavené jako app_location v souboru pracovního postupu. Soubor ale můžete umístit do libovolného umístění ve složce zdrojového kódu aplikace.