{"title":"Feidhmeanna ``django.urls ``le húsáid in URLConfs","version":"6.0","locale":"ga","docname":"ref/urls","url":"/ga/6.0/ref/urls/","canonical":"https://djangodocs.dev/ga/6.0/ref/urls/","summary":"`` 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…","html":"
\n

Feidhmeanna ``django.urls ``le húsáid in URLConfsLink to this heading#

\n
\n

``cosán () ``Link to this heading#

\n
\n
\npath(route, view, kwargs=None, name=None)Link to this definition#
\n
\n\n

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

\n
Code
from django.urls import include, path\n\nurlpatterns = [\n    path("index/", views.index, name="main-view"),\n    path("bio/<username>/", views.bio, name="bio"),\n    path("articles/<slug:title>/", views.article, name="article-detail"),\n    path("articles/<slug:title>/<int:section>/", views.section, name="article-section"),\n    path("blog/", include("blog.urls")),\n    ...,\n]\n
\n
\n

bealaLink to this heading#

\n

The route argument should be a string or\ngettext_lazy() (see\nPatrúin URL a aistriú) that contains a URL pattern. The string\nmay contain angle brackets (like <username> above) to capture part of the\nURL and send it as a keyword argument to the view. The angle brackets may\ninclude a converter specification (like the int part of <int:section>)\nwhich limits the characters matched and may also change the type of the\nvariable passed to the view. For example, <int:section> matches a string\nof decimal digits and converts the value to an int.

\n

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

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.

\n
\n
\n

`amharcLink to this heading#

\n

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.

\n

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.

\n
\n
\n

`KwargsLink to this heading#

\n

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.

\n
\n
\n

``ainm `Link to this heading#

\n

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.

\n

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.

\n
\n
\n
\n

``re_path () ``Link to this heading#

\n
\n
\nre_path(route, view, kwargs=None, name=None)Link to this definition#
\n
\n\n

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

\n
Code
from django.urls import include, re_path\n\nurlpatterns = [\n    re_path(r"^index/$", views.index, name="index"),\n    re_path(r"^bio/(?P<username>\\w+)/$", views.bio, name="bio"),\n    re_path(r"^blog/", include("blog.urls")),\n    ...,\n]\n
\n

The route argument should be a string or\ngettext_lazy() (see\nPatrúin URL a aistriú) that contains a regular expression compatible\nwith Python's re module. Strings typically use raw string syntax\n(r'') so that they can contain sequences like \\d without the need to\nescape the backslash with another backslash. When a match is made, captured\ngroups from the regular expression are passed to the view -- as named arguments\nif the groups are named, and as positional arguments otherwise. The values are\npassed as strings, without any type conversion.

\n

When a route ends with $ the whole requested URL, matching against\npath_info, must match the regular expression\npattern (re.fullmatch() is used).

\n

The view, kwargs and name arguments are the same as for\npath().

\n
\n
\n

``san áireamh () `Link to this heading#

\n
\n
\ninclude(module, namespace=None)Link to this definition#
\n
\ninclude(pattern_list)
\n
\ninclude((pattern_list, app_namespace), namespace=None)
\n

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.

\n

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ú.

\n

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.

\n
\n
Paraiméadair:
\n
    \n

  • module -- Modúl URLConf (nó ainm an mhodúil)

    • \n

  • namespace (str) -- Spás ainmneacha sampla do na hiontrálacha URL atá san áireamh

    • \n

  • pattern_list -- Inathraithe o:func: ~django.urls.path agus/nó :func: ~django.urls.re_path cásanna.

    • \n

  • app_namespace (str) -- Spás ainmneacha feidhmchláir do na hiontrálacha URL atá san áireamh

    • \n
\n
\n
\n
\n\n

Féach:ref: including-ear-urlconfs agus:ref: spaces-ainmnea-agus-include.

\n
\n
\n

``tiontaire_cláraigh () ``Link to this heading#

\n
\n
\nregister_converter(converter, type_name)Link to this definition#
\n
\n\n

The function for registering a converter for use in path()\nroutes.

\n

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.

\n
\n
\n
\n

Feidhmeanna ``django.conf.urls ``le húsáid in URLConfsLink to this heading#

\n
\n

``statach () ``Link to this heading#

\n
\n
\nstatic.static(prefix, view=django.views.static.serve, **kwargs)Link to this definition#
\n
\n\n

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

\n
Code
from django.conf import settings\nfrom django.conf.urls.static import static\n\nurlpatterns = [\n    # ... the rest of your URLconf goes here ...\n] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)\n
\n
\n
\n

Handler400Link to this heading#

\n
\n
\nhandler400Link to this definition#
\n
\n\n

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.

\n

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.

\n
\n
\n

Handler403Link to this heading#

\n
\n
\nhandler403Link to this definition#
\n
\n\n

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.

\n

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.

\n
\n
\n

``Handler404 ``Link to this heading#

\n
\n
\nhandler404Link to this definition#
\n
\n\n

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.

\n

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.

\n
\n
\n

Handler500Link to this heading#

\n
\n
\nhandler500Link to this definition#
\n
\n\n

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.

\n

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.

\n
\n
\n","rootId":"","toc":[{"title":"Feidhmeanna ``django.urls ``le húsáid in URLConfs","anchor":"","children":[{"title":"``cosán () ``","anchor":"path","children":[{"title":"beala","anchor":"route","children":[]},{"title":"`amharc","anchor":"view","children":[]},{"title":"`Kwargs","anchor":"kwargs","children":[]},{"title":"``ainm `","anchor":"name","children":[]}]},{"title":"``re_path () ``","anchor":"re-path","children":[]},{"title":"``san áireamh () `","anchor":"include","children":[]},{"title":"``tiontaire_cláraigh () ``","anchor":"register-converter","children":[]}]},{"title":"Feidhmeanna ``django.conf.urls ``le húsáid in URLConfs","anchor":"module-django.conf.urls","children":[{"title":"``statach () ``","anchor":"static","children":[]},{"title":"Handler400","anchor":"handler400","children":[]},{"title":"Handler403","anchor":"handler403","children":[]},{"title":"``Handler404 ``","anchor":"handler404","children":[]},{"title":"Handler500","anchor":"handler500","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/6.0/ref/"}],"prev":{"docname":"ref/urlresolvers","title":"Feidhmeanna fóntais ``django.urls ``","url":"/ga/6.0/ref/urlresolvers/"},"next":{"docname":"ref/utils","title":"Úsáideacha Django","url":"/ga/6.0/ref/utils/"},"formats":{"html":"/ga/6.0/ref/urls/","markdown":"/ga/6.0/ref/urls.md","json":"/ga/6.0/ref/urls.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/ref/urls.txt","official":"https://docs.djangoproject.com/ga/6.0/ref/urls/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}