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, výběrem odkazu Produkty adresní řádek prohlížeče potvrdí, že jste na /products. Když na této stránce aktualizujete stránku, chcete, aby se aplikace znovu načetla a znovu zobrazila 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á přiřazuje všechny neodpovídající požadavky na stránku serveru.

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čit	["/_framework/*", "/css/*"]	Cesty, které se mají ignorovat při náhradním 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 trasy

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.