djangodocs

Django 5.2
Gaeilge
Documentation contents

Feidhmeanna ``django.urls ``le húsáid in URLConfs

``cosán () ``

path(route, view, kwargs=None, name=None)

Tugann eilimint ar ais lena n-áireamh in urlpatterns. Mar shampla:

Code
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")),
    ...,
]

beala

Ba chóir go mbeadh an argóint route ina teaghrán nó:func: ~django.utils.translation.gettext_lazy () `(féach:ref: `translating-urlpatterns) ina bhfuil patrún URL. D'fhéadfadh lúibíní uillinne a bheith sa sreangán (cosúil le <username>```thuas) chun cuid den URL a ghabháil agus é a sheoladh mar argóint eochairfhocal chuig an radharc. Féadfaidh sonraíocht tiontaire a bheith san áireamh sna lúibíní uillinne (cosúil leis an gcuid int ``de<int:section>) a chuireann teorainn leis na carachtair a mheaitseáiltear agus féadfaidh sé cineál an athróg a chuirtear chuig an radharc a athrú freisin. Mar shampla, meaitseálann <int:section>```sreang dhigit deachúil agus athraíonn sé an luach go 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.

`amharc

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.

`Kwargs

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 `

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 () ``

re_path(route, view, kwargs=None, name=None)

Tugann eilimint ar ais lena n-áireamh in urlpatterns. Mar shampla:

Code
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")),
    ...,
]

Ba chóir go mbeadh an argóint route ina teaghrán nó:func: ~django.utils.translation.gettext_lazy () `(féach:ref: `translating-urlpatterns) ina bhfuil abairt rialta atá comhoiriúnach le modúl Python: py:mod: re. Is iondúil go n-úsáideann teaghráin comhréir sreangán amh (r") ionas gur féidir leo seicheamh mar \ d a bheith iontu gan gá an cúlghabháil a éalú le cúltaca eile. Nuair a dhéantar meaitseáil, cuirtear grúpaí gabháilte ón léiriú rialta chuig an dearcadh - mar argóintí ainmnithe má ainmnítear na grúpaí, agus mar argóintí seasaimh a shlí eile. Cuirtear na luachanna ar aghaidh mar teaghráin, gan aon chineál comhshó.

Nuair a chríochnaíonn ród le $` caithfidh an URL iomlán a iarrtar, a mheaitseáil cois:attr: ~django.http.httpRequest.path_info, an patrún abairt rialta a mheaitseáil (:py:func: re.fullmatch úsáidtear).

Tá na hargóintí dearca, kwargs` agus ``ainm ``mar an gcéanna le haghaidh: func: `~django.urls.path () `.

``san áireamh () `

include(module, namespace=None)
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 () ``

register_converter(converter, type_name)

An fheidhm chun tiontaire a chlárú le húsáid in:func: ~django.urls.path () ```route`s.

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 URLConfs

``statach () ``

static.static(prefix, view=django.views.static.serve, **kwargs)

Feidhm chúntóra chun patrún URL a thabhairt ar ais chun comhaid a sheirbheáil i mód dífhabhtaithe:

Code
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)

Handler400

handler400

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.

Handler403

handler403

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 ``

handler404

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.

Handler500

handler500

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.

This page as Markdown JSON

Edit this page on GitHub Official version