Kuidas luua Djangos kohandatud 404 vealehte

Vealehed on veebirakenduste puhul tavalised. Django kaasautorid on pakkunud mõnele sellisele veale (nt 404 (ei leitud)) vaikelehti. Kuid arendajana on parem omada vealehte, mis järgib teie ülejäänud veebirakenduse kujundamise põhimõtteid.

Kohandatud 404 lehe loomine Djangos

Viga 404 on osa mitmest HTTP olekukoodid mida brauser kasutab serveri vastuse näitamiseks kasutaja brauseri päringutele. Django pakub mõnele sellisele olekukoodile vaikemalle ja Django tõrkeleht 404 näeb välja selline:

Ülaltoodud pilt ei näe kena välja ja enamik ettevõtteid ei aktsepteeri seda oma veebisaidil. Selle lehe muutmiseks oma valitud kohandatud 404-leheks järgige alltoodud samme.

1. samm: looge vaade tõrke 404 käsitlemiseks

Ava oma views.py faili ja looge 404 vealehe vaade. See vaade peaks tagastama malli, mis sisaldab teie kohandatud 404 vealehe kujundust. Siin on lihtne Django vaade, mida saate oma projektis kasutada:

alates django.otseteed importida renderdama
# kohandatud 404 vaade
defkohandatud_404(taotlus, erand):
tagasi renderdama (päring, '404.html', staatus=404)

Ülaltoodud koodilõik on a Pythoni funktsioon (eelistatavalt nimetatakse antud juhul Django vaateks), mis võtab kaks funktsiooni argumenti; nõudaja erand. Teine argument -erand— võimaldab teil pääseda juurde erandiobjektile, mis käivitas vea 404.

Peaksite asendama "404.html" ülaltoodud vaates õige teega teie vea 404 HTML-i mallilehele.

2. samm: looge oma 404 vea jaoks mall

Looge uus HTML-fail, mis sisaldab teie kohandatud kujundust tõrkelehe 404 jaoks. Kujundus peaks olema kooskõlas ülejäänud rakendusega. Siin on lihtne HTML-mall, mida saate oma projektis kasutada. Peaksite seda malli oma äranägemise järgi muutma:

 404.html mall 
html>
<htmllang="en">
<pea>
<metacharset="UTF-8">
<metanimi="vaateava"sisu="laius = seadme laius, esialgne skaala = 1,0">
<pealkiri>404 lehte ei leitudpealkiri>
<link
 importida Bootstrap 
 href=" https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css"
 rel="laadileht" 
 integrity="sha384-KK94CHFLe+nY2dmCWGMq91rCGa5gtU4mk92HdvYe+M/SXH301p5ILy+dN9+nJOZ"
 crossorigin="anonüümne">
 kohandatud css 
<stiilis>
 keha {
 ekraan: flex;
 paindesuund: veerg;
 õigustama-sisu: keskpunkt;
 joonda-elemendid: keskel;
 kõrgus: 100vh;
 fondiperekond: Arial, sans-serif;
 }
 .container {
 teksti joondamine: keskel;
 maksimaalne laius: 600 pikslit;
 }
 .emoji {
 fondi suurus: 8rem;
 veeris-alumine: 20px;
 }
 h1 {
 fondi suurus: 3rem;
 veeris-alumine: 20px;
 }
 p {
 fondi suurus: 1,5 rem;
 veeris-alumine: 20px;
 }
 .btn {
 fondi suurus: 1,25 rem;
 polsterdus: 10px 20px;
 }
stiilis>
pea>
<keha>
<divklass="konteiner">
<divklass="emoji">😕div>
<h1>Oih! Lehte ei leitudh1>
<lk>Me ei leidnud lehte, mida otsisite.lk>
<aklass="btn btn-primary"href="/">Minge tagasi avalehelea>
div>
keha>
html>

3. samm: muutke oma projekti URL-i faili

Teie projekti tasemel (kus teie settings.py fail on), avage oma urls.py faili ja suunake vea 404 töötleja vaatele, mille lõite vea 404 käsitlemiseks. Kutsutakse välja vea 404 töötleja käitleja404. Et osutada käitleja404 teie arvates peaksite järgima järgmist vormingut:

käitleja404 = „app_name.views.custom_404_view_name”

Kui teie rakendust kutsutakse retsept, ja vaadet nimetatakse kohandatud_404, siis peaksite ülaltoodud vormingut muutma järgmiselt:

käitleja404 = "recipe.views.custom_404"

Veenduge, et teete seda oma projekti, mitte rakenduse tasemel. Seal on Django projekti ja rakenduse erinevused.

4. toiming: testige oma uut tõrke 404 lehte

Uue vealehe testimiseks käivitage arendusserver ja navigeerige oma rakenduses olematule lehele. Saate oma serveri käivitada, käivitades käsurea tööriistas (CLI) selle käsu:

python manage.py runserver

Ülaltoodud käsu toimimiseks peate asuma oma projekti juurkataloogis, st kaustas, kus manager.py faili elusid.

Kui server käivitub, testige oma kohandatud 404 lehte, liikudes olematule lehele, näiteks http://127.0.0.1:8000/hello. Kui olete kõik õigesti teinud, peaksite nägema kohandatud 404 vealehte.

Kui teie kohandatud 404 vealehte ei kuvata, peaksite kaaluma oma vaadete kontrollimist, et olla kindel, et kirjutasite HTML-mallile õige tee. render () funktsiooni, kuna see on tavaline probleem.

Kohandatud vealehed pakuvad paremat kasutuskogemust

Kui teie rakenduses on kohandatud vealeht, paraneb teie kasutajate kogemus vigade ilmnemisel. Üldise veateate nägemise asemel võib kohandatud vealeht anda vea kohta täpsemat teavet ja soovitada võimalikke lahendusi.

See võib aidata kasutajatel mõista, mis läks valesti ja kuidas seda parandada, vähendades frustratsiooni ja suurendades nende usaldust teie rakenduse vastu. Samuti saate muuta lehe kaasavaks, lisades juurdepääsetavuse funktsioone.