--- title: "django.urls funktioner för användning i URLconfs" version: 5.2 locale: sv source: https://docs.djangoproject.com/sv/5.2/ref/urls/ canonical: https://djangodocs.dev/sv/5.2/ref/urls/ --- # `django.urls` funktioner för användning i URLconfs ## `path()` #### `path(route, view, kwargs=None, name=None)` Returnerar ett element som kan ingå i `urlpatterns`. Till exempel: ``` from django.urls import include, path urlpatterns = [ path("index/", views.index, name="main-view"), path("bio//", views.bio, name="bio"), path("articles//", views.article, name="article-detail"), path("articles///", views.section, name="article-section"), path("blog/", include("blog.urls")), ..., ] ``` ### `route` Argumentet `route` bör vara en sträng eller [`gettext_lazy()`](/sv/5.2/ref/utils/#django.utils.translation.gettext_lazy) (se [Översättning av URL-mönster](/sv/5.2/topics/i18n/translation/#translating-urlpatterns)) som innehåller ett URL-mönster. Strängen kan innehålla vinkelparenteser (som `` ovan) för att fånga en del av URL:en och skicka den som ett nyckelordsargument till vyn. Vinkelparenteserna kan innehålla en konverteringsspecifikation (som `int`-delen av ``) som begränsar de tecken som matchas och kan också ändra typen av variabel som skickas till vyn. Exempelvis matchar `` en sträng med decimalsiffror och konverterar värdet till ett `int`. När Django bearbetar en begäran börjar den vid det första mönstret i `urlpatterns` och tar sig nedåt i listan och jämför den begärda URL:en med varje mönster tills den hittar ett som matchar. Se [Hur Django behandlar en förfrågan](/sv/5.2/topics/http/urls/#how-django-processes-a-request) för mer information. Mönster matchar inte GET- och POST-parametrar eller domännamnet. Till exempel:, i en begäran till `https://www.example.com/myapp/` kommer URLconf att leta efter `myapp/`. I en begäran till `https://www.example.com/myapp/?page=3` kommer URLconf också att leta efter `myapp/`. ### `vy` Argumentet `view` är en vyfunktion eller resultatet av [`as_view()`](/sv/5.2/ref/class-based-views/base/#django.views.generic.base.View.as_view) för klassbaserade vyer. Det kan också vara en [`django.urls.include()`](#django.urls.include). När Django hittar ett matchande mönster anropar den den angivna vyfunktionen med ett [`HttpRequest`](/sv/5.2/ref/request-response/#django.http.HttpRequest)-objekt som första argument och alla ”fångade” värden från rutten som nyckelordsargument. ### `kwargs` Med argumentet `kwargs` kan du skicka ytterligare argument till vyns funktion eller metod. Se [Överföra extra alternativ till vyfunktioner](/sv/5.2/topics/http/urls/#views-extra-options) för ett exempel. ### `namn` Genom att namnge din URL kan du hänvisa till den på ett otvetydigt sätt från andra ställen i Django, särskilt från mallar. Denna kraftfulla funktion gör att du kan göra globala ändringar av URL-mönstren i ditt projekt samtidigt som du bara rör en enda fil. Se [Namngivning av URL-mönster](/sv/5.2/topics/http/urls/#naming-url-patterns) för varför argumentet `name` är användbart. ## `re_path()` #### `re_path(route, view, kwargs=None, name=None)` Returnerar ett element som kan ingå i `urlpatterns`. Till exempel: ``` from django.urls import include, re_path urlpatterns = [ re_path(r"^index/$", views.index, name="index"), re_path(r"^bio/(?P\w+)/$", views.bio, name="bio"), re_path(r"^blog/", include("blog.urls")), ..., ] ``` Argumentet `route` bör vara en sträng eller [`gettext_lazy()`](/sv/5.2/ref/utils/#django.utils.translation.gettext_lazy) (se [Översättning av URL-mönster](/sv/5.2/topics/i18n/translation/#translating-urlpatterns)) som innehåller ett reguljärt uttryck som är kompatibelt med Pythons modul [`re`](https://docs.python.org/3/library/re.html#module-re). Strängar använder vanligtvis rå strängsyntax (`r''`) så att de kan innehålla sekvenser som `d` utan att behöva undkomma backslash med en annan backslash. När en träff görs skickas fångade grupper från det reguljära uttrycket till vyn - som namngivna argument om grupperna är namngivna och som positionella argument i annat fall. Värdena skickas som strängar, utan någon typkonvertering. När en `route` slutar med `$` måste hela den begärda URL:en, som matchas mot [`path_info`](/sv/5.2/ref/request-response/#django.http.HttpRequest.path_info), matcha det reguljära uttrycksmönstret ([`re.fullmatch()`](https://docs.python.org/3/library/re.html#re.fullmatch) används). Argumenten `view`, `kwargs` och `name` är desamma som för [`path()`](#django.urls.path). ## `include()` #### `include(module, namespace=None)` #### `include(pattern_list)` #### `include((pattern_list, app_namespace), namespace=None)` En funktion som tar en fullständig Python-importväg till en annan URLconf-modul som ska ”inkluderas” på denna plats. Eventuellt kan även [application namespace](/sv/5.2/topics/http/urls/#term-application-namespace) och [instance namespace](/sv/5.2/topics/http/urls/#term-instance-namespace) där posterna ska inkluderas i anges. Vanligtvis bör applikationens namnrymd anges av den inkluderade modulen. Om ett applikationsnamnområde har angetts kan argumentet `namespace` användas för att ange ett annat instansnamnområde. `include()` accepterar också som argument antingen en iterabel som returnerar URL-mönster eller en 2-tupel som innehåller en sådan iterabel plus namnen på applikationens namnrymder. **Parametrar:** - `module` – URLconf-modul (eller modulnamn) - `namespace` ([`str`](https://docs.python.org/3/library/stdtypes.html#str)) – Instansnamnområde för de URL-poster som inkluderas - `pattern_list` – Iterabel av [`path()`](#django.urls.path) och/eller [`re_path()`](#django.urls.re_path) instanser. - `app_namespace` ([`str`](https://docs.python.org/3/library/stdtypes.html#str)) – Applikationsnamnrymd för de URL-poster som inkluderas Se [Inkludera andra URLconfs](/sv/5.2/topics/http/urls/#including-other-urlconfs) och [URL-namnrymder och inkluderade URL-konf](/sv/5.2/topics/http/urls/#namespaces-and-include). ## `registrera_omvandlare()` #### `register_converter(converter, type_name)` Funktionen för att registrera en omvandlare för användning i ```path()``route`()```. Argumentet `converter` är en konverterarklass och `type_name` är det konverterarnamn som ska användas i sökvägsmönster. Se [Registrering av anpassade sökvägsomvandlare](/sv/5.2/topics/http/urls/#registering-custom-path-converters) för ett exempel. > **Deprecated since Django 5.1** > > Ersatt sedan version 5.1: Åsidosättande av befintliga omvandlare är föråldrat. # `django.conf.urls` funktioner för användning i URLconfs ## `static()` #### `static.static(prefix, view=django.views.static.serve, **kwargs)` Hjälpfunktion för att returnera ett URL-mönster för att visa filer i felsökningsläge: ``` from django.conf import settings from django.conf.urls.static import static urlpatterns = [ # ... the rest of your URLconf goes here ... ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) ``` ## `Handläggare400` #### `handler400` En callable, eller en sträng som representerar den fullständiga Python-importsökvägen till den vy som ska anropas om HTTP-klienten har skickat en begäran som orsakade ett feltillstånd och ett svar med statuskod 400. Som standard är detta [`django.views.defaults.bad_request()`](/sv/5.2/ref/views/#django.views.defaults.bad_request). Om du implementerar en anpassad vy, se till att den accepterar `request` och `exception` argument och returnerar en [`HttpResponseBadRequest`](/sv/5.2/ref/request-response/#django.http.HttpResponseBadRequest). ## `Handläggare403` #### `handler403` En anropsbar vy, eller en sträng som representerar den fullständiga Python-importsökvägen till den vy som ska anropas om användaren inte har de behörigheter som krävs för att komma åt en resurs. Som standard är detta [`django.views.defaults.permission_denied()`](/sv/5.2/ref/views/#django.views.defaults.permission_denied). Om du implementerar en anpassad vy, se till att den accepterar argumenten `request` och `exception` och returnerar en [`HttpResponseForbidden`](/sv/5.2/ref/request-response/#django.http.HttpResponseForbidden). ## `Handläggare404` #### `handler404` En anropsbar vy, eller en sträng som representerar den fullständiga Python-importsökvägen till den vy som ska anropas om inget av URL-mönstren matchar. Som standard är detta [`django.views.defaults.page_not_found()`](/sv/5.2/ref/views/#django.views.defaults.page_not_found). Om du implementerar en anpassad vy, se till att den accepterar `request` och `exception` argument och returnerar en [`HttpResponseNotFound`](/sv/5.2/ref/request-response/#django.http.HttpResponseNotFound). ## `handläggare500` #### `handler500` En callable, eller en sträng som representerar den fullständiga Python-importsökvägen till den vy som ska anropas vid serverfel. Serverfel inträffar när du har körtidsfel i vykoden. Som standard är detta [`django.views.defaults.server_error()`](/sv/5.2/ref/views/#django.views.defaults.server_error). Om du implementerar en anpassad vy, se till att den accepterar ett `request`-argument och returnerar en [`HttpResponseServerError`](/sv/5.2/ref/request-response/#django.http.HttpResponseServerError).