Ffurflen sy'n gweithio ledled y byd

Mae Lily yn anelu at bob gwlad, nid un. Nid yw'n cynnwys Saesneg ac nid yw'n rhagdybio gwlad, felly eich dewisiadau chi yw'r rhai sy'n gwneud ffurflen yn lleol, wedi'u gwneud yn fwriadol. Mae'r tiwtorial hwn yn mynd drwyddyn nhw.

Beth fyddwch chi'n ei adeiladu

Ffurflen gofrestru i glinig sy'n gwasanaethu pobl o lawer o wledydd: enw, dyddiad geni, cyfeiriad, rhif ffôn, ffi, a thudalen sy'n darllen o'r dde i'r chwith pan ddylai. Mae'r enghreifftiau'n defnyddio Svelte; mae pob catalog yn derbyn yr un props. Tua 20 munud, ar ôl y tiwtorial ffurflenni hygyrch.

Cam 1 — Enwau: un maes, nid dau

<label class="label" for="name">Full name</label>
<TextInput id="name" name="name" autocomplete="name" label="Full name" />

Mae "enw cyntaf" a "chyfenw" yn methu llawer o bobl: un enw yn unig, enw teulu yn gyntaf, dau enw teulu, nawddenw. Gofynnwch am yr enw llawn mewn un maes, ac os oes angen gwybod beth i alw rhywun, gofynnwch hynny ar wahân.

Cam 2 — Dyddiadau: y rhannau yn nhrefn y darllenydd

<DateField
  label="Date of birth"
  dayLabel="Day"
  monthLabel="Month"
  yearLabel="Year"
  order="dmy"
  autocomplete="bday"
  name="dob"
  bind:value={dob}
/>

order yw "dmy", "mdy" neu "ymd": dewiswch yr un mae eich darllenwyr yn ei ddisgwyl, oherwydd mae 03/04 yn fis Mawrth mewn un wlad ac yn fis Ebrill yn y nesaf. Mae'r gwerth bob amser yn ISO (YYYY-MM-DD), beth bynnag fo'r drefn. Ar gyfer dyddiad nad yw rhywun ond hanner ei wybod, fel pryd y dechreuodd salwch, mae precision="month" yn storio 2019-03 ac nid yw byth yn dyfeisio diwrnod.

I ddangos dyddiad, fformatiwch ef gyda Intl.DateTimeFormat yn locale y darllenydd; nid yw Lily byth yn fformatio un i chi.

Cam 3 — Cyfeiriadau: dim siâp gwlad fel y rhagosodiad

<AddressInput label="Home address">
  <label class="label" for="address">Address</label>
  <textarea class="text-area-input" id="address" name="address" autocomplete="street-address" rows="4"></textarea>
  <label class="label" for="country">Country or territory</label>
  <select class="select" id="country" name="country" autocomplete="country"> … </select>
</AddressInput>

AddressInput yw grŵp wedi'i enwi; eich meysydd chi yw'r rhai y tu mewn. Mae un cyfeiriad testun rhydd a gwlad yn gweithio ym mhobman. Os ydych chi'n ei rannu, gwnewch hynny fesul gwlad (mae cod post yn ddewisol neu'n absennol mewn llawer) a pheidiwch byth â gwneud maes "talaith" yn orfodol.

Cam 4 — Rhifau ffôn ac arian

<TelInput label="Phone number" name="phone" autocomplete="tel" />
<CurrencyInput label="Fee" currencyCode="KES" bind:value={fee} />

Derbyniwch rif ffôn fel y'i teipiwyd, gyda bylchau a +; peidiwch â gorfodi fformat un wlad. CurrencyInput — nid oes ganddo arian cyfred rhagosodedig: currencyCode (ISO 4217) — mae'n orfodol, oherwydd byddai rhagosodiad yn arian un wlad.

Cam 5 — Cyfeiriad testun ac iaith

<LocalePicker label="Language" locales={["en", "fr", "ar", "sw"]} bind:value={locale} />

Mae'r dewisydd iaith yn gosod lang a dir ar y dudalen, felly mae Arabeg neu Hebraeg yn darllen o'r dde i'r chwith. Mae pob cydran Lily yn etifeddu dir; mae'r themâu'n defnyddio priodweddau rhesymegol (margin-inline-start, nid margin-left), a dylai eich CSS chi hefyd. Nid yw'r dewisydd yn cyfieithu dim: daw eich testun o'ch cyfieithiadau eich hun.

Cam 6 — Labeli'r cynorthwywyr, yn iaith y darllenydd

<script lang="ts">
  import { labelsFor } from "@lilydesignsystem/svelte-locale-translations";
  import sw from "@lilydesignsystem/svelte-locale-translations/sw-001";
  import DataGrid from "@lilydesignsystem/svelte-data-grid";
</script>

<DataGrid label="Wagonjwa" labels={labelsFor("data-grid", sw)} … />

Mae'r grid data, y bwrdd kanban, y calendr, y siart Gantt a'r hidlydd yn cario llawer o labeli darllenydd sgrin. Mae Lily yn eu darparu mewn 64 iaith fel pecynnau labeli. Dim ond y Saesneg sydd wedi'i adolygu; drafftiau peiriant yw'r 63 arall, felly gofynnwch i siaradwr brodorol wirio'r geiriad cyn dibynnu ar un. Nid yw pecyn byth yn disgyn yn ôl i iaith arall.

Gwiriwch eich gwaith: newidiwch y dudalen i Arabeg a gwiriwch fod y gosodiad yn adlewyrchu heb dorri testun; rhowch ddyddiad yn eich trefn chi a chadarnhewch fod y gwerth a gyflwynwyd yn ISO; rhowch enw un gair i rywun, a chyfeiriad heb god post, a gwnewch yn siŵr bod y ffurflen yn derbyn y ddau.

Camau nesaf

  • Hyfforddiant — wyth modiwl, pob un gydag ymarfer a hunanwiriad.
  • Dynodwyr cenedlaethol: 164 cydran ar gyfer 82 math o ddynodwr mewn mwy na 50 gwlad, pob un yn -input a -view.
  • Cynorthwywyr dewisiadau: iaith, maint testun, symud a chylchfa amser.
  • Locales: yr ieithoedd y mae'r wefan a'r pecynnau labeli yn eu cwmpasu.