Hyfforddiant

Cwrs hunanarweiniol i dîm sy'n mabwysiadu Lily: wyth modiwl, pob un â nod, rhywbeth i'w ddarllen, ymarfer rydych chi'n ei wneud mewn porwr go iawn, a hunanwiriad gydag atebion. Tua diwrnod i gyd; mae un modiwl bob sesiwn yn gweithio'n dda.

Cyn i chi ddechrau

Dewiswch un tiwtorial fframwaith a'i orffen yn gyntaf. Rhedwch un o'r apiau enghreifftiol yn lleol, neu defnyddiwch y tudalennau cydrannau yma, ar gyfer yr ymarferion. Mae angen bysellfwrdd arnoch, ac ar gyfer modiwl 8 ddarllenydd sgrin: VoiceOver ar macOS ac iOS, NVDA ar Windows neu TalkBack ar Android, i gyd am ddim.

Modiwl 1 — Ystyr headless

Nod: gwybod beth mae Lily yn ei benderfynu a beth rydych chi'n ei benderfynu.

Darllen: y dudalen Amdanom, ac un dudalen gydran, fel Button, o'r dechrau i'r diwedd.

Gwneud: dangoswch Button a TextInput heb ddalen arddull. Yna cysylltwch un thema, yna un arall. Nodwch beth newidiodd a beth na newidiodd.

Hunanwiriad: beth nad yw cydran Lily byth yn ei gynnwys? Beth mae bob amser yn ei gynnwys?

Byth: CSS, ffontiau, eiconau na delweddau (ac eithrio eiconau'r dewiswyr), testun Saesneg, nôl data, locale nac arian cyfred rhagosodedig. Bob amser: yr elfen HTML fwyaf penodol, ei bachyn dosbarth kebab-case yn gyntaf, ARIA lle mae HTML yn brin, ymddygiad bysellfwrdd, a'ch priodoleddau eraill wedi'u trosglwyddo.

Hunanwiriad: rydych chi eisiau ffin goch ar un botwm. Ble mae'n mynd?

Yn eich CSS, ar y bachyn dosbarth (.button) neu ddosbarth rydych chi'n ei ychwanegu. Byth yn y gydran.

Modiwl 2 — Bysellfwrdd a ffocws

Nod: defnyddio a phrofi pob cydran heb lygoden.

Darllen: y tabl Rhyngweithiadau Bysellfwrdd ar TabBar, Listbox a Dialog.

Gwneud: datgysylltwch y llygoden. Ar bob un o'r tair tudalen, cyrhaeddwch y demo gyda Tab a gwnewch bopeth mae'r tabl yn ei restru. Agorwch y deialog, pwyswch Escape, a nodwch ble mae'r ffocws yn glanio.

Hunanwiriad: pam mai un arhosfan Tab sydd gan far tabiau, nid un i bob tab?

Patrwm cyfansawdd yr APG: Tab yn symud rhwng teclynnau, ac mae'r bysellau saeth yn symud o fewn un (mynegai tab crwydrol). Mae bar tabiau â deg arhosfan yn gwneud i ddefnyddiwr bysellfwrdd bwyso Tab ddeg gwaith i fynd heibio iddo.

Hunanwiriad: ar ôl i ddeialog moddol gau, ble dylai'r ffocws fod?

Ar y rheolydd a'i hagorodd. Mae deialogau moddol Lily yn defnyddio showModal(), sydd hefyd yn cadw Tab y tu mewn i'r deialog tra bydd ar agor.

Modiwl 3 — Enwau, rolau a chyflyrau

Nod: rhoi enw i bob rheolydd y gall darllenydd sgrin ei ddweud, yn eich geiriau chi.

Darllen: adran ARIA IconButton a SwitchButton.

Gwneud: yn eich ap eich hun, gyda'i weinydd datblygu, dangoswch IconButton heb ei label. Agorwch gonsol y porwr: mae Lily yn rhybuddio nad oes enw hygyrch gan y rheolydd. Ychwanegwch y label a gwiriwch fod y rhybudd wedi mynd. (Dim ond mewn adeiladwaith datblygu y mae'r rhybuddion yn bodoli, felly mae tudalen gynhyrchu, fel y wefan hon, yn aros yn dawel.)

Hunanwiriad: pryd ydych chi'n defnyddio aria-label, a phryd testun gweladwy?

Testun gweladwy pryd bynnag y gallwch: mae pawb yn ei weld, a gall defnyddwyr mewnbwn llais ei ddweud. aria-label dim ond lle nad oes testun gweladwy, fel eicon. Os yw'r ddau'n bodoli, rhaid i'r enw gynnwys y geiriau gweladwy (WCAG 2.5.3).

Hunanwiriad: statws wedi'i ddangos mewn coch yn unig. Beth sydd ar goll?

Testun. Gall lliw ailadrodd ystyr ond byth ei gario ar ei ben ei hun (WCAG 1.4.1); mae angen geiriau ar y statws.

Modiwl 4 — Ffurflenni

Nod: adeiladu ffurflen y gall unrhyw un ddod o hyd i'w gwallau a'u cywiro.

Darllen a gwneud: y tiwtorial ffurflenni hygyrch, y pum cam i gyd.

Hunanwiriad: mae'r ffurflen yn methu'r dilysu. Ble mae'r ffocws yn mynd, a beth sy'n cael ei ddarllen?

I'r crynodeb gwallau, a gyhoeddir gyda'i bennawd a'i restr o ddolenni, un i bob gwall, pob un yn arwain at ei faes.

Hunanwiriad: pam peidio ag analluogi'r botwm cyflwyno nes bod y ffurflen yn ddilys?

Ni all botwm wedi'i analluogi ddweud beth sydd o'i le, ac ni all llawer o bobl ddweud pam nad yw'n gwneud dim.

Modiwl 5 — Themâu a chyferbyniad

Nod: ail-steilio Lily heb dorri cyferbyniad na ffocws.

Darllen: y tiwtorial themâu a'r tabl cyferbyniad themâu .

Gwneud: diystyrwch --color-primary gyda lliw eich brand eich hun. Gwiriwch fod ei bâr, --color-primary-content, yn cyrraedd 4.5:1, a bod y cylch ffocws yn dal i ddangos yn erbyn y dudalen.

Hunanwiriad: mae lliw eich brand yn rhy olau ar gyfer testun gwyn. Allwch chi ei ddefnyddio o hyd?

Gallwch, fel addurn (--lily-brand: band pennyn, llinell, cefndir logo), byth ar gyfer testun na ffin rheolydd. Mae testun a ffiniau'n defnyddio parau cynnwys y thema.

Modiwl 6 — Ledled y byd

Nod: peidio â gwneud unrhyw wlad yn rhagosodiad.

Darllen a gwneud: ffurflen sy'n gweithio ledled y byd.

Hunanwiriad: pam nad oes gan CurrencyInput arian cyfred rhagosodedig?

Byddai unrhyw ragosodiad yn arian un wlad, yn anghywir yn dawel ym mhob man arall. Mae currencyCode coll yn ddiffyg yn y galwr.

Hunanwiriad: tudalen mewn Arabeg. Beth ydych chi'n ei osod, a beth rhaid i'ch CSS ei wneud?

lang="ar" a dir="rtl" (mae'r dewisydd iaith yn gosod y ddau); mae eich CSS yn defnyddio priodweddau rhesymegol fel bod y gosodiad yn adlewyrchu ar ei ben ei hun.

Modiwl 7 — Symud

Nod: animeiddio heb niweidio neb.

Darllen: y ryseitiau symud.

Gwneud: trowch "lleihau symudiad" ymlaen yn eich system weithredu ac ail-lwythwch dudalen gyda rysáit y marquee. Dylai sefyll yn llonydd a lapio. Yna cyrhaeddwch ei botwm saib gyda'r bysellfwrdd.

Hunanwiriad: mae rhywbeth yn symud ar ei ben ei hun am fwy na phum eiliad. Beth rhaid iddo ei gael?

Ffordd o'i oedi, ei atal neu ei guddio (WCAG 2.2.2), y gellir ei chyrraedd gyda'r bysellfwrdd, nid dim ond drwy hofran.

Modiwl 8 — Gwirio eich gwaith

Nod: profi tudalen yn y ffordd y mae Lily yn profi ei rhai ei hun.

Gwneud: cymerwch un dudalen a adeiladwyd gennych yn y cwrs hwn a rhedwch bedwar gwiriad:

  1. axe (estyniad y porwr, neu @axe-core/playwright mewn prawf): dim torri rheolau.
  2. Bysellfwrdd yn unig: pob tasg wedi'i gwneud, ffocws bob amser yn weladwy, byth wedi'i ddal.
  3. Chwyddwch i 400% a culhewch y ffenestr i 320 picsel: dim sgrolio i'r ochr, dim wedi'i dorri.
  4. Darllenydd sgrin: mae gan bob rheolydd enw, rôl a'i gyflwr, a chyhoeddir gwallau.
Hunanwiriad: nid yw axe yn adrodd unrhyw doriadau. Ydy'r dudalen yn hygyrch?

Heb ei brofi eto. Mae gwiriadau awtomatig yn canfod efallai draean o'r problemau; mae'r gwiriadau bysellfwrdd, chwyddo a darllenydd sgrin yn canfod llawer o'r gweddill. Gweler y dudalen ansawdd am yr hyn y mae Lily ei hun wedi'i wirio a heb ei wirio.

Ar ôl y cwrs