Go coitianta in iarratais gréasáin, ní mór duit teachtaireacht fógra aon-uaire (ar a dtugtar “teachtaireacht splanc” freisin) a thaispeáint don úsáideoir tar éis foirm nó cineálacha éigin eile ionchuir úsáideora a phróiseáil.
\nChuige seo, soláthraíonn Django tacaíocht iomlán do theachtaireachtaí bunaithe ar fhianán agus seisiún, d'úsáideoirí gan ainm agus fíordheimhnithe araon. Ligeann an creat teachtaireachtaí duit teachtaireachtaí a stóráil go sealadach in iarratas amháin agus iad a aisghabháil le taispeáint in iarratas ina dhiaidh sin (an chéad cheann eile de ghnáth). Tá “leibhéal” ar leith clibeáilte ar gach teachtaireacht a chinneann a thosaíocht (m.sh., info, rabhadh `, nó earráid).
Cuirtear teachtaireachtaí i bhfeidhm trí aicme a:doc: middleware agus comhfhreagraí:doc: próiseálaí comhthéacs </ref/middleware> </ref/templates/api>.
\nTá na socruithe go léir a theastaíonn chun feidhmiúlacht teachtaireachta a chumasú sa réamhshocraithe settings.py a chruthaigh django-admin startproject cheana féin:
Tá ``'django.contrib.messages'` in:setting: INSTALLED_APPS.
MIDDLEWARE contains\n'django.contrib.sessions.middleware.SessionMiddleware' and\n'django.contrib.messages.middleware.MessageMiddleware'.
</topics/http/sessions> <message-storage-backends>Braitheann an réamhshocraithe:ref: backend stórála `ar:doc: `seisiúin. Sin an fáth go gcaithfear SessionMiddleware a chumasú agus a bheith le feiceáil roimh MessageMiddleware in:setting: MIDDLEWARE.
Tá django.contrib.messages.context_processors.messages' sa rogha context_processors' ``den chúlcheann ``DjangoTemplates a shainmhínítear i do shuíomh: TEMPLATES.
Mura dteastaíonn uait teachtaireachtaí a úsáid, is féidir leat ``django.contrib.messages'` a bhaint as d':setting: INSTALLED_APPS, an líne ``MessageMiddleware` ó:setting: MIDDLEWARE, agus an próiseálaí comhthéacs teachtaireachtaí ``ó:setting: `TEMPLATES.
\nIs féidir leis an gcreat teachtaireachtaí cúltaca éagsúla a úsáid chun teachtaireachtaí sealadacha a stó
\nSoláthraíonn Django trí rang stórála ionsuite in:mod: django.contrib.messages:
\nStórálann an rang seo gach teachtaireacht taobh istigh de sheisiún an iarratais. Dá bhrí sin éilíonn sé iarratas ``contrib.sessions` Django.
\nStórálann an rang seo sonraí na teachtaireachta i bhfianán (sínithe le hash rúnda chun ionramháil a chosc) chun fógraí a leanúint ar fud iarratais. Scaoiltear seantheachtaireachtaí dá mbeadh méid na sonraí fianán níos mó ná 2048 beát.
\nÚsáideann an rang seo CookieStorage` den chéad uair, agus titim siar ar SessionStorage a úsáid do na teachtaireachtaí nach bhféadfadh a bheith oiriúnach i bhfianán amháin. Éilíonn sé freisin iarratas ``contrib.sessions` Django.
Seachnaíonn an t-iompar seo scríobh chuig an seisiún nuair is féidir. Ba chóir dó an fheidhmíocht is fearr a sholáthar sa chás ginearálta.
\nFallbackStorage is the\ndefault storage class. If it isn't suitable to your needs, you can select\nanother storage class by setting MESSAGE_STORAGE to its full import\npath, for example:
MESSAGE_STORAGE = "django.contrib.messages.storage.cookie.CookieStorage"\nChun do rang stórála féin a scríobh, fo-aicmigh an rang BaseStorage i django.contrib.messages.storage.base agus cuir na modhanna _get agus _store i bhfeidhm.
Tá creat na teachtaireachtaí bunaithe ar ailtireacht leibhéal inchumraithe cosúil le hailtireacht an mhodúl logála Python. Ligeann leibhéil teachtaireachtaí duit teachtaireachtaí a ghrúpáil de réir cineálacha ionas gur féidir iad a scagadh nó a thaispeáint go difriúil i
\nIs iad na leibhéil ionsuite, ar féidir iad a allmhairiú go díreach ó django.contrib.messages:
Tairiseach | \nCuspóir | \n
|---|---|
| \nTeachtaireachtaí a bhaineann le forbairt a ndéanfar neamhaird orthu (nó a bhaint) in imscaradh táirgeachta | \n
``EOLAS `` | \nTeachtaireachtaí faisnéise don úsáideoir | \n
``RATH `` | \nD'éirigh le gníomh, m.sh. “Nuashonraíodh do phróifíl go rathúil” | \n
``RABHADH `` | \nNíor tharla teip ach d'fhéadfadh sé a bheith le teacht | \n
| \nNíor éirigh le gníomh nó tharla teip éigin eile | \n
Is féidir an socrú: SETTING: MESSAGE_LEVEL a úsáid chun an leibhéal íosta taifeadta a athrú (nó is féidir é a athrú in aghaidh an iarrata). Déanfar neamhaird ar iarrachtaí teachtaireachtaí de leibhéal níos lú ná seo a chur leis.
\nChun teachtaireacht a chur leis, glaoigh ar:
\nfrom django.contrib import messages\n\nmessages.add_message(request, messages.INFO, "Hello world.")\nSoláthraíonn roinnt modhanna aicearra bealach caighdeánach chun teachtaireachtaí a chur le clibeanna a úsáidtear go coitianta (a léirítear de ghnáth mar ranganna HTML don teachtaireacht):
\nmessages.debug(request, "%s SQL statements were executed." % count)\nmessages.info(request, "Three credits remain in your account.")\nmessages.success(request, "Profile details updated.")\nmessages.warning(request, "Your account expires in three days.")\nmessages.error(request, "Document deleted.")\n** I do theimpléad**, bain úsáid as rud éigin mar:
\n{% if messages %}\n<ul class="messages">\n {% for message in messages %}\n <li{% if message.tags %} class="{{ message.tags }}"{% endif %}>{{ message }}</li>\n {% endfor %}\n</ul>\n{% endif %}\nMá tá an próiseálaí comhthéacs á úsáid agat, ba chóir do theimpléad a léiriú le RequestContext. Seachas sin, cinntigh go bhfuil `teachtaireachtaí ``ar fáil do chomhthéacs an teimpléid.
Fiú má tá a fhios agat nach bhfuil ach teachtaireacht amháin ann, ba cheart duit athrá a dhéanamh fós thar an seicheamh ``teachtaireachtaí ``, mar ar shlí eile ní ghlanfar an stóráil teachtaireachta don chéad iarratas eile.
\nSoláthraíonn an próiseálaí comhthéacs athróg DEFAULT_MESSAGE_LEVELS freisin ar mhapáil ar ainmneacha leibhéal na teachtaireachta ar a luach uimhriúil:
{% if messages %}\n<ul class="messages">\n {% for message in messages %}\n <li{% if message.tags %} class="{{ message.tags }}"{% endif %}>\n {% if message.level == DEFAULT_MESSAGE_LEVELS.ERROR %}Important: {% endif %}\n {{ message }}\n </li>\n {% endfor %}\n</ul>\n{% endif %}\nTaobh amuigh de theimpléid, is féidir leat úsáid a úsáid:func: ~django.contrib.messages.get_messages:
\nfrom django.contrib.messages import get_messages\n\nstorage = get_messages(request)\nfor message in storage:\n do_something_with_the_message(message)\n<jsonresponsemixin-example>Mar shampla, is féidir leat na teachtaireachtaí go léir a fháil chun iad a thabhairt ar ais in a:ref: JsonResponseMixin `in ionad a:class: `~Django.Views.Generic.Base.TemplateResponseMixin.
\nget_messages() will return an\ninstance of the configured storage backend.
Nuair a bhíonn tú ag lúb thar liosta na dteachtaireachtaí i dteimpléad, is cásanna den rang ``Teachtaireacht ``a fhaigheann tú. Níl ach cúpla tréith acu:
\n``leibhéil ``: Sláimhir a thuairiscíonn cineál na teachtaireachta (féach an chuid `leibhéil teachtaireachtaí `_ thuas).
tags: Sreang a chomhcheanglaíonn clibeanna uile na teachtaireachta (extra_tags agus level_tag) scartha le spásanna.
extra_tags: Sreang ina bhfuil clibeanna saincheaptha don teachtaireacht seo, scartha le spásanna. Tá sé folamh de réir réamhshocraithe.
level_tag: An léiriú teaghrán ar an leibhéal. De réir réamhshocraithe, is é an leagan beaga d'ainm an tairiseach gaolmhar é, ach is féidir é seo a athrú más gá duit tríd an socrú: setting: MESSAGE_TAGS a úsáid.
Níl aon rud níos mó ná sláimhreacha iad leibhéil teachtaireachtaí, ionas gur féidir leat do choirmeannaigh leibhéil féin a shainiú agus iad a úsáid chun aiseolas úsáideoirí níos saincheaptha a chruthú, m.sh.:
\nCRITICAL = 50\n\n\ndef my_view(request):\n messages.add_message(request, CRITICAL, "A serious error occurred.")\nAgus leibhéil teachtaireachta saincheaptha á chruthú agat ba chóir duit a bheith cúramach chun ró-ualú a sheachaint Is iad na luachanna do na leibhéil ionsuite:
\nLeibhéal Tairiseach | \nLuach | \n
|---|---|
| \n10 | \n
``EOLAS `` | \n20 | \n
``RATH `` | \n25 | \n
``RABHADH `` | \n30 | \n
| \n40 | \n
Más gá duit na leibhéil saincheaptha i do HTML nó CSS a aithint, ní mór duit mapáil a sholáthar tríd an socrú: setting: MESSAGE_TAGS.
\n\nIs féidir an leibhéal íosta taifeadta a shocrú in aghaidh an iarratais tríd an modh set_level:
\nfrom django.contrib import messages\n\n# Change the messages level to ensure the debug message is added.\nmessages.set_level(request, messages.DEBUG)\nmessages.debug(request, "Test message...")\n\n# In another request, record only messages with a level of WARNING and higher\nmessages.set_level(request, messages.WARNING)\nmessages.success(request, "Your profile was updated.") # ignored\nmessages.warning(request, "Your account is about to expire.") # recorded\n\n# Set the messages level back to default.\nmessages.set_level(request, None)\nAr an gcaoi chéanna, is féidir an leibhéal éifeachtach reatha a aisghabháil le ``get_level`:
\nfrom django.contrib import messages\n\ncurrent_level = messages.get_level(request)\nLe haghaidh tuilleadh faisnéise faoi conas a fheidhmíonn an leibhéal íosta taifeadta, féach `Leibhéil teachtaireachtaí `_ thuas
\nMá tá tú ag scríobh aip in-athúsáidte (nó píosa cód eile) agus má theastaíonn uait feidhmiúlacht teachtaireachtaí a áireamh, ach mura dteastaíonn uait a cheangal ar d'úsáideoirí é a chumasú mura dteastaíonn uathu, féadfaidh tú argóint eochairfhocal breise fail_silently=true a chur chuig aon cheann de na modhanna add_message. Mar shampla:
messages.add_message(\n request,\n messages.SUCCESS,\n "Profile details updated.",\n fail_silently=True,\n)\nmessages.info(request, "Hello world.", fail_silently=True)\nCuireann tréith teachtaireachta rathúlachta leis a:class: ~django.views.generic.edit.formView ranganna bunaithe
\nIs é ``cleaned_data ``na sonraí glanta ón bhfoirm a úsáidtear le haghaidh formáidiú teaghrán
\nAmharcanna sampla.py:
\nfrom django.contrib.messages.views import SuccessMessageMixin\nfrom django.views.generic.edit import CreateView\nfrom myapp.models import Author\n\n\nclass AuthorCreateView(SuccessMessageMixin, CreateView):\n model = Author\n success_url = "/success/"\n success_message = "%(name)s was created successfully"\nTá na sonraí glanta ón foirm ``ar fáil le haghaidh idirphóireacht sreangán ag baint úsáide as an gcomhréir ``% (field_name) s. Maidir le ModelForms, má theastaíonn rochtain uait ar réimsí ón object shábháilte, athraigh an modh:meth: ~django.contrib.messages.views.successMessageMixin.get_success_message.
Sampla views.py le haghaidh ModelForms:
\nfrom django.contrib.messages.views import SuccessMessageMixin\nfrom django.views.generic.edit import CreateView\nfrom myapp.models import ComplicatedModel\n\n\nclass ComplicatedCreateView(SuccessMessageMixin, CreateView):\n model = ComplicatedModel\n success_url = "/success/"\n success_message = "%(calculated_field)s was created successfully"\n\n def get_success_message(self, cleaned_data):\n return self.success_message % dict(\n cleaned_data,\n calculated_field=self.object.calculated_field,\n )\nTá na teachtaireachtaí marcáilte le glanadh nuair a dhéantar an cás stórála a athrá (agus a ghlanadh nuair a dhéantar an freagra a phróiseáil).
\nChun na teachtaireachtaí a sheachaint a ghlanadh, is féidir leat stóráil na dteachtaireachtaí a shocrú go False` tar éis iad a athrú:
\nstorage = messages.get_messages(request)\nfor message in storage:\n do_something_with(message)\nstorage.used = False\nMar gheall ar an mbealach a oibríonn fianáin (agus dá bhrí sin seisiúin), ní shainmhínítear iompar aon chúltaca a úsáideann fianáin nó seisiúin nuair a dhéanann an cliant céanna iolracha iarrataí a leagann nó a fhaigheann teachtaireachtaí comhthreomhaol. Mar shampla, má thionscnaíonn cliant iarratas a chruthaíonn teachtaireacht i bhfuinneog amháin (nó cluaisín) agus ansin ceann eile a fhaigheann aon teachtaireachtaí neamhliteartha i bhfuinneog eile, sula ndéanann an chéad fhuinneog a atreorú, féadfaidh an teachtaireacht a bheith le feiceáil sa dara fuinneog in ionad an chéad fhuinneog inar féidir a bheith ag súil leis.
\nI mbeagán focal, nuair a bhíonn iliarratais chomhuaineach ón gcliant céanna i gceist, ní ráthaítear go seachadfar teachtaireachtaí chuig an bhfuinneog chéanna a chruthaigh iad ná, i gcásanna áirithe, ar chor ar bith. Tabhair faoi deara nach fadhb í seo de ghnáth i bhformhór na bhfeidhmchlár agus go mbeidh sé ina neamhcheist i HTML5, áit a mbeidh a chomhthéacs brabhsála féin ag gach fuinneog/cluaisín.
\nTugann beaga:ref: `socruithe <settings-messages>`smacht duit ar iompar teachtaireachta:
\n\nMaidir le cúltaca a úsáideann fianáin, tógtar na socruithe don fhianán ó na socruithe fianán seisiúin:
\n\nCuireann an modúl seo modh dearbhaithe tástála saincheaptha ar fáil, chun teachtaireachtaí atá ceangailte le ha:class: ~.httpResponse a thástáil.
\nChun leas a bhaint as an dearbhú seo, cuir MessagestestMixin leis an ordlathas ranga:
from django.contrib.messages.test import MessagesTestMixin\nfrom django.test import TestCase\n\n\nclass MsgTestCase(MessagesTestMixin, TestCase):\n pass\nAnsin, oidhreacht ón MsgTestCase` i do thástálacha.
\n<django.http.HttpResponse>Deilíonn sé gur:mod: ~django.contrib.messages a chuirtear leis an: class: `response `a mheaitseálann ``teachtaireachtaí a bhí ag súil leis `teachtaireachtaí a bhí ag súil leis.
\nIs é expected_messages liosta de:class: ~django.contrib.messages.message rudaí.
De réir réamhshocraithe, tá an comparáid ag brath ar ordú. Is féidir leat é seo a dhíchumasú tríd an argóint ordaithe ``a shocrú go ``False.