Feidhmeanna ``django.urls ``le húsáid in URLConfsLink to this heading
``cosán () ``Link to this heading
- path(route, view, kwargs=None, name=None)Link to this definition
Tugann eilimint ar ais lena n-áireamh in urlpatterns. Mar shampla:
from django.urls import include, path
urlpatterns = [
path("index/", views.index, name="main-view"),
path("bio/<username>/", views.bio, name="bio"),
path("articles/<slug:title>/", views.article, name="article-detail"),
path("articles/<slug:title>/<int:section>/", views.section, name="article-section"),
path("blog/", include("blog.urls")),
...,
]
bealaLink to this heading
The route argument should be a string or
gettext_lazy() (see
Patrúin URL a aistriú) that contains a URL pattern. The string
may contain angle brackets (like <username> above) to capture part of the
URL and send it as a keyword argument to the view. The angle brackets may
include a converter specification (like the int part of <int:section>)
which limits the characters matched and may also change the type of the
variable passed to the view. For example, <int:section> matches a string
of decimal digits and converts the value to an int.
Agus iarratas á phróiseáil, tosaíonn Django ag an gcéad phatrún in urlpatterns agus déanann sé a bhealach síos an liosta, ag comparáid idir an URL iarrtha i gcoinne gach patrún go dtí go bhfaigheann sé ceann a mheaitseálann. Féach: ref: how django-processes-a-request le haghaidh tuilleadh sonraí.
Ní mheaitseálann patrúin paraiméadair GET agus POST, nó an t-ainm fearainn. Mar shampla, in iarratas chuig https://www.example.com/myapp/, cuardóidh an URLConf myapp/. In iarratas chuig https://www.example.com/myapp/?page=3, cuardóidh an URLConf myapp/ freisin.
`amharcLink to this heading
Is feidhm amharc é an argóint view nó toradh de:meth: ~django.views.generic.base.view.as_view le haghaidh tuairimí rang-bhunaithe. Is féidir é a bheith freisin a:func: django.urls.include.
Nuair a aimsíonn Django patrún meaitseála, glaonn sé an fheidhm amharc sonraithe le réad an:class: ~django.http.http.httpRequest mar an chéad argóint agus aon luachanna “gabháilte” ón mbealach mar argóintí eochairfhocal.
`KwargsLink to this heading
Ligeann an argóint ``kwargs ``duit argóintí breise a chur ar aghaidh chuig an bhfeidhm nó an modh amharc. Féach:ref: views-extra-options mar shampla.
``ainm `Link to this heading
Ligeann ainmniú do URL duit tagairt a dhéanamh dó gan amhbhrí ó áiteanna eile i Django, go háirithe ó theimpléid laistigh de. Ligeann an ghné chumhachtach seo duit athruithe domhanda a dhéanamh ar phatrúin URL do thionscadail agus gan teagmháil le comhad amháin.
Féach:ref: `Patrúin URL a ainmniúch <naming-url-patterns>`maidir le cén fáth go bhfuil an argóint ``ainm ``úsáideach.
``re_path () ``Link to this heading
- re_path(route, view, kwargs=None, name=None)Link to this definition
Tugann eilimint ar ais lena n-áireamh in urlpatterns. Mar shampla:
from django.urls import include, re_path
urlpatterns = [
re_path(r"^index/$", views.index, name="index"),
re_path(r"^bio/(?P<username>\w+)/$", views.bio, name="bio"),
re_path(r"^blog/", include("blog.urls")),
...,
]
The route argument should be a string or
gettext_lazy() (see
Patrúin URL a aistriú) that contains a regular expression compatible
with Python's re module. Strings typically use raw string syntax
(r'') so that they can contain sequences like \d without the need to
escape the backslash with another backslash. When a match is made, captured
groups from the regular expression are passed to the view -- as named arguments
if the groups are named, and as positional arguments otherwise. The values are
passed as strings, without any type conversion.
When a route ends with $ the whole requested URL, matching against
path_info, must match the regular expression
pattern (re.fullmatch() is used).
The view, kwargs and name arguments are the same as for
path().
``san áireamh () `Link to this heading
- include(module, namespace=None)Link to this definition
- include(pattern_list)
- include((pattern_list, app_namespace), namespace=None)
Feidhm a thógann cosán iomlán allmhairithe Python chuig modúl URLConf eile ba chóir a bheith “san áireamh” san áit seo. Go roghnach, is féidir an:term: spás ainmneacha feidhmchláir agus:term: spás ainmneacha sampla ina gcuirfear na hiontrálacha san áireamh iontu a shonrú freisin.
De ghnáth, ba cheart an modúl san áireamh spás ainmneacha an fheidhmchláir a shonrú. Má shocraítear spás ainmneacha feidhmchláir, is féidir an argóint ``spás ainmneacha ``a úsáid chun spás ainmneacha sampla difriúil a shocrú.
Glacann ``include () ``mar argóint freisin le hathrinneach a thugann patrúin URL ar ais nó le 2-tuple ina bhfuil athraitheach den sórt sin móide ainmneacha spás ainmneacha an fheidhmchláir.
- Paraiméadair:
module -- Modúl URLConf (nó ainm an mhodúil)
namespace (str) -- Spás ainmneacha sampla do na hiontrálacha URL atá san áireamh
pattern_list -- Inathraithe o:func: ~django.urls.path agus/nó :func: ~django.urls.re_path cásanna.
app_namespace (str) -- Spás ainmneacha feidhmchláir do na hiontrálacha URL atá san áireamh
Féach:ref: including-ear-urlconfs agus:ref: spaces-ainmnea-agus-include.
``tiontaire_cláraigh () ``Link to this heading
- register_converter(converter, type_name)Link to this definition
The function for registering a converter for use in path()
routes.
Is aicme tiontaire é an argóint tiontaire, agus is é type_name` an t-ainm tiontaire le húsáid i bpatrúin cosáin. Féach:ref: cláraithe saincheapach-path-tionters mar shampla.
Feidhmeanna ``django.conf.urls ``le húsáid in URLConfsLink to this heading
``statach () ``Link to this heading
- static.static(prefix, view=django.views.static.serve, **kwargs)Link to this definition
Feidhm chúntóra chun patrún URL a thabhairt ar ais chun comhaid a sheirbheáil i mód dífhabhtaithe:
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)
Handler400Link to this heading
- handler400Link to this definition
Is féidir glaoch, nó sreang a léiríonn an cosán iomlán allmhairithe Python chuig an radharc ba chóir a ghlaoch má sheol an cliant HTTP iarratas a d'fhág riocht earráide agus freagra le cód stádais 400.
De réir réamhshocraithe, is é seo: func: django.views.defaults.bad_request. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le hargóintí request agus exception agus tuairisceann sé an:class: ~django.http.httpResponseBadRequest.
Handler403Link to this heading
- handler403Link to this definition
Is féidir glaoch, nó sreang a léiríonn an cosán iomlán allmhairithe Python chuig an radharc ar chóir a ghlaoch mura bhfuil na ceadanna a theastaíonn ag an úsáideoir chun rochtain a fháil ar acmhainn.
De réir réamhshocraithe, is é seo: func: django.views.defaults.permission_denied. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le hargóintí request agus exception agus tuairisceann sé an:class: ~django.http.httpResponseForbidden.
``Handler404 ``Link to this heading
- handler404Link to this definition
Is féidir glaoch, nó sreang a léiríonn cosán iomlán iompórtála Python chuig an radharc ar chóir a ghlaoch mura n-oireann aon cheann de na patrúin URL.
De réir réamhshocraithe, is é seo: func: django.views.defaults.page_not_found. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le hargóintí request agus exception agus tuairisceann sé an:class: ~django.http.httpResponseNotFound.
Handler500Link to this heading
- handler500Link to this definition
Is féidir glaoch, nó sreang a léiríonn an cosán iomlán allmhairithe Python chuig an radharc ar chóir a ghlaoch i gcás earráidí freastalaí. Tarlaíonn earráidí freastalaí nuair a bhíonn earráidí rith agat i gcód amharc.
De réir réamhshocraithe, is é seo: func: django.views.defaults.server_error. Má chuireann tú dearcadh saincheaptha i bhfeidhm, bí cinnte go nglacann sé le argóint request agus filleann sé an:class: ~django.http.httpResponseservererror.