Cyfarwyddiadau ffurflen

Mae Silktide yn canfod meysydd ffurflen a allai fod angen esboniad arnynt, megis meysydd testun rhydd, ac yn gofyn i chi benderfynu a oes angen cyfarwyddiadau ar bob un yn disgrifio beth i'w nodi. Dylai cyfarwyddiadau gael eu cysylltu yn y cod â meysydd sydd eu hangen arnynt, nid eu gosod gerllaw yn unig.

Pam mae hyn yn bwysig

Yn aml, nid yw label yn unig yn ddigon. Nid yw "Dyddiad" yn dweud dim wrthych am y fformat disgwyliedig, sy'n amrywio yn ôl gwlad; nid yw "Cyfeirnod" yn nodi pa un o'ch tair rhif cyfeirnod sy'n ofynnol. Mae ymwelwyr sy'n dyfalu'n anghywir yn cael gwall

neu'n waeth, caiff eu cyflwyniad ei dderbyn â data gwael.

Mae cysylltu'r cyfarwyddyd yn y cod yr un mor bwysig â'i ysgrifennu: mae awgrym dim ond yn weledol ger y maes yn anweledig i ddefnyddiwr sy'n canolbwyntio ar y mewnbwn.

Sut i'w drwsio

Ar gyfer pob maes sydd wedi'i farcio, penderfynwch a allai ymwelydd fod yn ansicr beth i'w nodi. Os felly:

Ychwanegwch ddisgrifiad a'i gysylltu â'r maes â'r briodwedd aria-describedby :

<!-- Caiff yr awgrym ei gyhoeddi pan fydd y maes yn derbyn ffocws -->
<label for="date">Dyddiad</label>
<input type="text" id="date" aria-describedby="date-hint">
<p id="date-hint">Fformat: diwrnod\/mis\/blwyddyn, e.e. 28\/07\/2026</p>

Neu defnyddiwch fath maes a gynlluniwyd at y diben yn lle hynny. Mae <input type="date"> yn rhoi dewisydd dyddiad i ymwelwyr yn eu locale eu hunain, heb fod angen esboniad - defnyddiwch hwn yn hytrach pan fo math addas ar gael.

Os yw'r maes yn hunanesboniadol - blwch "Chwilio", neu faes "Neges" ar ffurflen gyswllt - nid oes angen cyfarwyddyd; y canfyddiad.

Sut mae Silktide yn profi hyn

Canfod y rheolyddion ffurflen lle mae cyfarwyddiadau'n debygol o helpu: elfennau <textarea> a meysydd <input> o'r math text, email, file, number, password, neu range. Caiff botymau, blychau ticio, botymau radio, a bwydlenni cwymplen eu hepgor, gan fod label fel arfer yn ddigonol ar gyfer y rheini.
Hepgor meysydd nad ydynt yn weladwy i ddefnyddwyr sy'n gweld, a meysydd a fewnosodwyd gan widgetiau trydydd parti hysbys, megis y ffurflenni cudd y mae sgriptiau olrhain a chyfieithu yn eu hychwanegu at eu defnydd eu hunain.
Hepgor meysydd sydd eisoes â disgrifiad wedi'i gysylltu - aria-describedby sy'n pwyntio at destun go iawn, nad yw'n wag, neu briodwedd aria-description nad yw'n wag.
Marcio pob maes sy'n weddill i chi ei adolygu: mae person yn penderfynu a oes gwir angen cyfarwyddiadau arno.

Datrys problemau

Mae gan fy maes awgrym yn union oddi tano

Nid cysylltiad yw agosrwydd gweledol. Oni bai fod yr awgrym wedi'i gysylltu â'r maes gan aria-describedby (neu aria-description), nid yw yn ei gyhoeddi, ac mae Silktide yn marcio'r maes. Mae ychwanegu'r briodwedd yn datrys y ddwy broblem.