Léim chuig an ábhar
Rannóga
Teanga, Gaeilge faoi láthair
Córas Dearaidh Rastrillo
Teanga, Gaeilge faoi láthair
EnglishGaeilge简体中文Españolहिन्दीPortuguêsবাংলাРусский日本語廣東話Tiếng Việtالعربية

Taispeáint

Na píosaí beaga foclóra as a gcuirtear scáileán le chéile: stádas, céannacht, dul chun cinn, agus an t-aon chruth foláirimh.

Tá gach sampla beo, ach ní théann a naisc áit ar bith. Taispeánann HTML an marcáil le cóipeáil.

status-pill

Stádas taifid mar phillín daite, dath agus lipéad.

Réamhamharc

neutral

<span rst-status rst-tone="neutral">Dréacht</span>

positive

<span rst-status rst-tone="positive">Foilsithe</span>

warning

<span rst-status rst-tone="warning">Sceidealaithe</span>

negative

<span rst-status rst-tone="negative">Theip air</span>

neutral

{{template "status-pill" dict "Label" "Dréacht"}}

positive

{{template "status-pill" dict "Label" "Foilsithe" "Tone" "positive"}}

warning

{{template "status-pill" dict "Label" "Sceidealaithe" "Tone" "warning"}}

negative

{{template "status-pill" dict "Label" "Theip air" "Tone" "negative"}}

neutral Is é neutral an Tone réamhshocraithe, mar sin fágann an glao seo ar lár é.

badge

Slis le himlíne i gceannlitreacha do mharcóirí beaga statacha. Rud eile é seachas status-pill, arb é stádas taifid é.

Réamhamharc

Gan ton (an réamhshocrú ciúin)

<span rst-badge>Dréacht</span>

neutral

<span rst-badge="neutral">Inmheánach</span>

positive

<span rst-badge="positive">Beo</span>

warning

<span rst-badge="warning">Béite</span>

negative

<span rst-badge="negative">Díolta amach</span>

Gan ton (an réamhshocrú ciúin)

{{template "badge" dict "Label" "Dréacht"}}

neutral

{{template "badge" dict "Label" "Inmheánach" "Tone" "neutral"}}

positive

{{template "badge" dict "Label" "Beo" "Tone" "positive"}}

warning

{{template "badge" dict "Label" "Béite" "Tone" "warning"}}

negative

{{template "badge" dict "Label" "Díolta amach" "Tone" "negative"}}

meter

Barra acmhainne agus a uimhir leis.

Réamhamharc

Folamh

<span rst-meter>
  <meter rst-meter-bar value="0" min="0" max="100" aria-hidden="true"></meter>
  <span rst-meter-num>0/500</span>
</span>

Cuid den bhealach

<span rst-meter>
  <meter rst-meter-bar value="42" min="0" max="100" aria-hidden="true"></meter>
  <span rst-meter-num>210/500</span>
</span>

Beagnach lán

<span rst-meter>
  <meter rst-meter-bar value="82" min="0" max="100" aria-hidden="true"></meter>
  <span rst-meter-num>412/500</span>
</span>

Lán

<span rst-meter>
  <meter rst-meter-bar value="100" min="0" max="100" aria-hidden="true"></meter>
  <span rst-meter-num>500/500</span>
</span>

Thar an mbuiséad

<span rst-meter>
  <meter rst-meter-bar value="100" min="0" max="100" aria-hidden="true"></meter>
  <span rst-meter-num>700/500</span>
</span>

Folamh

{{template "meter" dict "Percent" 0 "Text" "0/500"}}

Cuid den bhealach

{{template "meter" dict "Percent" 42 "Text" "210/500"}}

Beagnach lán

{{template "meter" dict "Percent" 82 "Text" "412/500"}}

Lán

{{template "meter" dict "Percent" 100 "Text" "500/500"}}

Thar an mbuiséad

{{template "meter" dict "Percent" 140 "Text" "700/500"}}

Thar an mbuiséad Cuirtear teorainn 100% leis an líonadh sa pháirteach.

stat

Uimhir amháin ar phainéal, le lipéad agus a mhéid a d'athraigh sí.

An uimhir mhór

Réamhamharc

Cuir é seo taobh istigh de <div rst-stats>.

<div rst-stat="lead">
  <span rst-stat-label>Ioncam na míosa seo</span>
  <span rst-stat-num>€48,210</span>
  <span rst-stat-delta rst-tone="positive">&#43;12%</span>
  <span rst-stat-note>i gcomparáid leis an mí seo caite</span>
</div>

Cuir é seo taobh istigh de <div rst-stats>.

{{template "stat" dict
    "Label" "Ioncam na míosa seo"
    "Value" "€48,210"
    "Delta" "+12%"
    "Tone" "positive"
    "Note" "i gcomparáid leis an mí seo caite"
    "Lead" true}}

Cuir Lead le staitistic amháin sa tsraith chun í a dhéanamh mór. Is í an chomhpháirt chéanna í, níos mó amháin.

Uimhir níos lú

Réamhamharc

Cuir é seo taobh istigh de <div rst-stats>.

<div rst-stat>
  <span rst-stat-label>Sonraisc gan íoc</span>
  <span rst-stat-num>24</span>
</div>

Cuir é seo taobh istigh de <div rst-stats>.

{{template "stat" dict "Label" "Sonraisc gan íoc" "Value" "24"}}

Níl uait ach lipéad agus uimhir. Tá gach rud eile roghnach.

Nuair is maith an rud é titim

Réamhamharc

Cuir é seo taobh istigh de <div rst-stats>.

<div rst-stat>
  <span rst-stat-label>Am go dtí an chéad fhreagra</span>
  <span rst-stat-num>1 u 12 n</span>
  <span rst-stat-delta rst-tone="positive">−38%</span>
  <span rst-stat-note>i gcomparáid leis an tseachtain seo caite</span>
</div>

Cuir é seo taobh istigh de <div rst-stats>.

{{template "stat" dict
    "Label" "Am go dtí an chéad fhreagra"
    "Value" "1 u 12 n"
    "Delta" "−38%"
    "Tone" "positive"
    "Note" "i gcomparáid leis an tseachtain seo caite"}}

Is tusa a shocraíonn an dath, ní an chomhpháirt. Anseo thit an uimhir agus is dea-scéal é sin, mar sin tá an t-athrú glas.

Nuair is drochrud é ardú

Réamhamharc

Cuir é seo taobh istigh de <div rst-stats>.

<div rst-stat>
  <span rst-stat-label>Íocaíochtaí a theip</span>
  <span rst-stat-num>9</span>
  <span rst-stat-delta rst-tone="negative">&#43;3</span>
  <span rst-stat-note>i gcomparáid leis an tseachtain seo caite</span>
</div>

Cuir é seo taobh istigh de <div rst-stats>.

{{template "stat" dict
    "Label" "Íocaíochtaí a theip"
    "Value" "9"
    "Delta" "+3"
    "Tone" "negative"
    "Note" "i gcomparáid leis an tseachtain seo caite"}}

Anseo d'ardaigh an uimhir agus is drochscéal é sin, mar sin tá an t-athrú dearg.

Nuair nach féidir leat a rá

Réamhamharc

Cuir é seo taobh istigh de <div rst-stats>.

<div rst-stat>
  <span rst-stat-label>Meánfhad seisiúin</span>
  <span rst-stat-num>4 n 12 s</span>
  <span rst-stat-delta rst-tone="neutral">&#43;18 s</span>
  <span rst-stat-note>ó Dé hAoine</span>
</div>

Cuir é seo taobh istigh de <div rst-stats>.

{{template "stat" dict
    "Label" "Meánfhad seisiúin"
    "Value" "4 n 12 s"
    "Delta" "+18 s"
    "Note" "ó Dé hAoine"}}

Fág an dath ar lár agus beidh an t-athrú liath. Déan sin nuair nach féidir leat a rá an maith nó olc é.

Uimhir ghiorraithe

Réamhamharc

Cuir é seo taobh istigh de <div rst-stats>.

<div rst-stat>
  <span rst-stat-label>Teachtaireachtaí seolta</span>
  <span rst-stat-num><data value="4120">4.1k</data></span>
</div>

Cuir é seo taobh istigh de <div rst-stats>.

{{template "stat" dict
    "Label" "Teachtaireachtaí seolta"
    "Value" "4.1k"
    "Exact" "4120"}}

4.1k á thaispeáint agat in ionad 4120? Cuir an uimhir iomlán in Exact. Ní léann léitheoirí scáileáin ach a bhfuil ar an scáileán, mar sin coinnigh gach rud a theastaíonn ó dhuine san uimhir féin.

person

Abatár inisealacha, ainm agus ríomhphost. Aithnítear taifid daoine go tapa leis.

Ainm agus ríomhphost

Réamhamharc 
<a rst-person href="/people/1">
  <span rst-person-av aria-hidden="true">G</span>
  <span rst-person-meta>
    <span rst-person-name>Grace Hopper</span>
    <span rst-person-email>grace@example.com</span>
  </span>
</a>
{{template "person" dict
    "Href" "/people/1"
    "Name" "Grace Hopper"
    "Email" "grace@example.com"
    "Initial" "G"}}

Mór, méid an chinn taispeána

Réamhamharc 
<a rst-person="lg" href="/people/2">
  <span rst-person-av aria-hidden="true">A</span>
  <span rst-person-meta>
    <span rst-person-name>Ada Lovelace</span>
    <span rst-person-email>ada@example.com</span>
  </span>
</a>
{{template "person" dict
    "Href" "/people/2"
    "Name" "Ada Lovelace"
    "Email" "ada@example.com"
    "Initial" "A"
    "Large" true}}

Gan cheannlitir

Réamhamharc 
<a rst-person href="/people/3">
  <span rst-person-av="empty" aria-hidden="true"></span>
  <span rst-person-meta>
    <span rst-person-name>Cuireadh nár glacadh leis</span>
    <span rst-person-email>invited@example.com</span>
  </span>
</a>
{{template "person" dict
    "Href" "/people/3"
    "Name" "Cuireadh nár glacadh leis"
    "Email" "invited@example.com"}}

actor

Cé a rinne rud éigin, i bhfocail: ainm duine, nó an gníomhaire agus an duine ar ghníomhaigh sé ar a shon. Gan suaitheantas agus gan deilbhín.

Gníomhaire ag gníomhú ar son duine

Réamhamharc 
<span rst-actor>Claude ar son Grace Hopper</span>
{{template "actor" dict "Actor" .Actor}}

Socraigh ui.ActorName uair amháin ag am tosaithe chun ábhar a iompú ina ainm. Ní rindreálann an aip féin, an Actor nialasach, rud ar bith.

Duine

Réamhamharc 
<span rst-actor>Grace Hopper</span>
{{template "actor" dict "Actor" .Actor}}

callout

An t-aon fhoclóir foláirimh: stiall daite, deilbhín toin, teideal trom roghnach, aon alt coirp amháin.

info

Réamhamharc 
<div rst-callout rst-tone="info">
  <span rst-callout-ic aria-hidden="true">
    <svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/></svg>
  </span>
  <div rst-callout-body>
    <p>Ní fheiceann ach baill na postálacha go dtí go bhfoilsítear an suíomh.</p>
  </div>
</div>
{{template "callout" dict
    "Body" "Ní fheiceann ach baill na postálacha go dtí go bhfoilsítear an suíomh."
    "Tone" "info"}}

positive

Réamhamharc 
<div rst-callout rst-tone="positive">
  <span rst-callout-ic aria-hidden="true">
    <svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="m9 12 2 2 4-4"/></svg>
  </span>
  <div rst-callout-body>
    <strong>Tá íocaíochtaí ceangailte</strong>
    <p>Is féidir leat íocaíocht a ghlacadh as ticéid anois.</p>
  </div>
</div>
{{template "callout" dict
    "Body" "Is féidir leat íocaíocht a ghlacadh as ticéid anois."
    "Title" "Tá íocaíochtaí ceangailte"
    "Tone" "positive"}}

warning

Réamhamharc 
<div rst-callout rst-tone="warning">
  <span rst-callout-ic aria-hidden="true">
    <svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z"/><path d="M12 9v4"/><path d="M12 17h.01"/></svg>
  </span>
  <div rst-callout-body>
    <strong>Ceangail íocaíochtaí chun tosú ag díol</strong>
    <p>Tá d&#39;imeacht beo ach ní féidir leis íocaíocht a ghlacadh fós.</p>
  </div>
</div>
{{template "callout" dict
    "Body" "Tá d'imeacht beo ach ní féidir leis íocaíocht a ghlacadh fós."
    "Title" "Ceangail íocaíochtaí chun tosú ag díol"
    "Tone" "warning"}}

negative

Réamhamharc 
<div rst-callout rst-tone="negative">
  <span rst-callout-ic aria-hidden="true">
    <svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="m15 9-6 6"/><path d="m9 9 6 6"/></svg>
  </span>
  <div rst-callout-body>
    <strong>Theip ar an iompórtáil dheireanach</strong>
    <p>Níor athraíodh aon rud. Ceartaigh ró 91 agus bain triail eile as.</p>
  </div>
</div>
{{template "callout" dict
    "Body" "Níor athraíodh aon rud. Ceartaigh ró 91 agus bain triail eile as."
    "Title" "Theip ar an iompórtáil dheireanach"
    "Tone" "negative"}}

negative, fógartha mar fholáireamh

Réamhamharc 
<div rst-callout rst-tone="negative" role="alert">
  <span rst-callout-ic aria-hidden="true">
    <svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="m15 9-6 6"/><path d="m9 9 6 6"/></svg>
  </span>
  <div rst-callout-body>
    <strong>Stad an iompórtáil</strong>
    <p>Níor athraíodh aon rud. Ceartaigh ró 91 agus bain triail eile as.</p>
  </div>
</div>
{{template "callout" dict
    "Body" "Níor athraíodh aon rud. Ceartaigh ró 91 agus bain triail eile as."
    "Title" "Stad an iompórtáil"
    "Tone" "negative"
    "Alert" true}}

Cuireann alert role="alert" leis chun teachtaireachtaí tábhachtacha a thaispeáint.

detail-list

Liosta sainmhínithe faoi thaifead ar scáileán sonraí. Marcálann mono luachanna atá cosúil le sonraí meaisín.

Ceithre fhíric, ceann acu cosúil le sonraí meaisín

Réamhamharc

Cuir é seo taobh istigh de <section rst-box>.

<dl rst-detail>
  <dt>Lucht féachana</dt>
  <dd>Baill</dd>
  <dt>Príomhleathanach</dt>
  <dd>Níl</dd>
  <dt>Foilsithe</dt>
  <dd>
    <time datetime="2026-08-02">2 Lúnasa 2026</time>
  </dd>
  <dt>Tagairt</dt>
  <dd class="rst-mono">post_01H9ZQ</dd>
</dl>

Cuir é seo taobh istigh de <section rst-box>.

{{template "detail-list" dict
    "Items" (list
        (dict "Label" "Lucht féachana" "Value" "Baill")
        (dict "Label" "Príomhleathanach" "Value" "Níl")
        (dict "DateTime" "2026-08-02" "Label" "Foilsithe" "Value" "2 Lúnasa 2026")
        (dict "Label" "Tagairt" "Mono" true "Value" "post_01H9ZQ"))}}

notice

Deimhniú aonlíne tar éis atreoraithe. Glacann sé teaghrán simplí, ní dict, agus ní léiríonn sé aon rud do cheann folamh.

Teachtaireacht "sábháladh"

Réamhamharc 
<p rst-notice role="status">Sábháladh an phostáil.</p>
{{template "notice" "Sábháladh an phostáil."}}

region:notice

An fógra a choinníonn gach blaosc ar an leathanach, ag taispeáint Notice shonraí an leathanaigh, ionas go gcloiseann léitheoir scáileáin splanc agus gur féidir le live.js é a líonadh ina áit.

Teachtaireacht "sábháladh"

Réamhamharc 
<div id="notice" role="status">
  <p rst-notice>Sábháladh an phostáil.</p>
</div>
{{template "region:notice" dict "Notice" "Sábháladh an phostáil."}}

form-error

Líne achoimre earráide foirme, role="alert". Glacann sé teaghrán simplí; ní léiríonn sé aon rud mura bhfuil earráid ann.

Seoladh a diúltaíodh

Réamhamharc 
<p rst-form-error role="alert">Tá an teideal sin in úsáid cheana.</p>
{{template "form-error" "Tá an teideal sin in úsáid cheana."}}

job-status

Blúire de phost cúlra a dhéantar a vótáil. Ní chuirtear an aitreabúid data-poll amach ach fad a bhíonn an post ar siúl: is é a fhágáil ar lár a stopann an vótáil.

Ar siúl

Réamhamharc 

<div rst-job data-poll="/jobs/1/fragment" data-poll-every="2">
  <span rst-spin aria-hidden="true"></span> Tá <bdi><strong>Iompórtáil</strong></bdi> ar siúl: <bdi>128 as 400</bdi>…
  <progress rst-job-bar value="32" min="0" max="100" aria-hidden="true"></progress>
</div>

{{template "job-status" dict
    "Name" "Iompórtáil"
    "Percent" 32
    "PollSeconds" 2
    "PollURL" "/jobs/1/fragment"
    "Progress" "128 as 400"
    "Status" "running"}}

Déanann an ceann seo vótáil: is é an t-aon sampla ar an leathanach a iarrann aon rud ar an líonra, agus ar shuíomh statach ní thagann freagra choíche.

Críochnaithe

Réamhamharc 

<div rst-job>
  Tá <bdi><strong>Iompórtáil</strong></bdi> críochnaithe.
</div>

{{template "job-status" dict "Name" "Iompórtáil" "Status" "done"}}

Theip air

Réamhamharc 

<div rst-job>
  Theip ar <bdi><strong>Iompórtáil</strong></bdi>: <bdi>row 91: no such column &#34;published&#34;</bdi>
</div>

{{template "job-status" dict
    "Err" "row 91: no such column \"published\""
    "Name" "Iompórtáil"
    "Status" "failed"}}