Kuwaza katika React

Anza na kiigizo

Wazia kuwa tayari unayo API ya JSON na picha kutoka kwa mbuni.

JSON API inarejesha data fulani ambayo inaonekana kama hii:

[
  { category: "Fruits", price: "$1", stocked: true, name: "Apple" },
  { category: "Fruits", price: "$1", stocked: true, name: "Dragonfruit" },
  { category: "Fruits", price: "$2", stocked: false, name: "Passionfruit" },
  { category: "Vegetables", price: "$2", stocked: true, name: "Spinach" },
  { category: "Vegetables", price: "$4", stocked: false, name: "Pumpkin" },
  { category: "Vegetables", price: "$1", stocked: true, name: "Peas" }
]

Kiigizo (Mockup) kinaonekana hivii:

Ili kutekeleza UI katika React, kwa kawaida utafuata hatua tano sawa.

Hatua ya 1: Vunja UI kuwa daraja la vijenzi

Anza kwa kuchora visanduku kuzunguka kila kijenzi na kijenzi kidogo kwenye kiigizo na uvipe majina. Ikiwa unafanya kazi na mbuni, wanaweza kuwa tayari wamevipa majina vijenzi hivi kwenye zana yao ya kubuni. Waulize!

Kulingana na msingi wako, unaweza kufikiria kugawanya muundo katika vijenzi kwa njia tofauti:

• Programming—tumia mbinu zile zile za kuamua ikiwa unapaswa kuunda kitendaji kipya au object. Mbinu moja kama hiyo ni kanuni ya uwajibikaji mmoja (single responsibility principle), yaani, kijenzi kinapaswa kufanya jambo moja tu. Ikiwa kitaishia kukua, inapaswa kigawanywe kiwe vijenzi vidogo.
• CSS—fikiria ni nini ungetengeneza viteule vya darasa. (Hatahivyo, vijenzi ni vidogo kwa kiasi fulani.)
• Design—fikiria jinsi unavyoweza kupanga safu za muundo.

Ikiwa JSON yako imeundwa vizuri, mara nyingi utapata kwamba inaelekeza kwa muundo wa vijenzi vya UI yako. Hiyo ni kwa sababu UI na miundo ya data mara nyingi huwa na usanifu sawa wa habari—yaani, umbo sawa. Tenganisha UI yako katika vijenzi, ambapo kila kijenzi kinalingana na kipande kimoja cha muundo yako wa data.

Kuna vijenzi vitano kwenye skrini hii:

Ukiangalia ProductTable (lavenda), utaona kwamba kichwa cha jedwali (kilicho na lebo za “Name” na “Price”) si kijenzi chake chenyewe. Hili ni suala la upendeleo, na unaweza kwenda kwa njia yoyote. Kwa mfano huu, ni sehemu ya ProductTable kwa sababu inaonekana ndani ya orodha ya ProductTable. Hatahivyo, ikiwa kichwa hiki kitakua kikubwa (k.m., ukiongeza kupanga), unaweza kukisogeza hadi kijenzi chake cha ProductTableHeader.

Sasa kwa kuwa umetambua vijenzi kwenye kiigizo, vipange katika daraja (hierachy). Vijenzi vinavyoonekana ndani ya kijenzi kingine katika kiigizo vinapaswa kuonekana kama mtoto katika daraja:

• FilterableProductTable
  • SearchBar
  • ProductTable
    • ProductCategoryRow
    • ProductRow

Hatua ya 2: Unda toleo tuli katika React

Kwa kuwa sasa unalo daraja lako la vijenzi, ni wakati wa kutekeleza programu yako. Mbinu iliyonyooka zaidi ni kuunda toleo ambalo linatoa UI kutoka kwa muundo wako wa data bila kuongeza mwingiliano wowote… bado! Mara nyingi ni rahisi kuunda toleo tuli kwanza na kuongeza mwingiliano baadaye. Kuunda toleo tuli (static version) kunahitaji kuandika sana bila kufikiria, lakini kuongeza mwingiliano kunahitaji kufikiria sana na sio kuandika sana.

Ili kuunda toleo tuli la programu yako linalotoa muundo wa data yako, utataka kuunda vijenzi ambavyo vinatumia tena vipengele vingine na kupitisha data kwa kutumia viunga (props). Viunga ni njia ya kupitisha data kutoka kwa mzazi hadi kwa mtoto. (Ikiwa unafahamu dhana ya hali (state), usitumie hali hata kidogo kuunda toleo hili tuli. Hali imetengwa kwa ajili ya mwingiliano pekee, yaani, data ambayo hubadilika baada ya muda. Kwa kuwa hili ni toleo tuli la programu, huhihitaji.)

Unaweza kujenga “juu chini” kwa kuanza na kujenga vijenzi juu zaidi katika daraja (kama FilterableProductTable) au “chini juu” kwa kufanya kazi kutoka kwa vijenzi chini chini (kama ProductRow). Katika mifano rahisi, kwa kawaida ni rahisi kwenda juu-chini, na kwenye miradi mikubwa, ni rahisi kwenda chini-juu.

(Ikiwa msimbo huu unaonekana wa kuudhi, pitia Anza Haraka kwanza!)

Baada ya kuunda vijenzi vyako, utakuwa na maktaba ya vijenzi vinavyoweza kutumika tena vinavyotoa kielelezo chako cha data. Kwa sababu hii ni programu tuli, vijenzi vitarejesha JSX pekee. Kijenzi kilicho juu ya daraja (FilterableProductTable) kitachukua kielelezo chako wa data kama mhimili. Hii inaitwa one-way data flow kwa sababu data hutiririka kutoka kijenzi cha kiwango cha juu hadi kile kilicho chini ya mti.

Hatua ya 3: Pata uwakilishi mdogo lakini kamili wa hali ya UI

Ili kufanya UI iwe na mwingiliano, unahitaji kuwaruhusu watumiaji kubadilisha kielelezo chako cha msingi wa data. Utatumia hali (state) kwa ajili ya hili.

Wazia hali kama seti ndogo ya kubadilisha data ambayo programu yako inahitaji kukumbuka. Kanuni muhimu zaidi ya uundaji wa hali ni kuitunza KAUSHA (Usijirudie). Tambua uwakilishi mdogo kabisa wa hali ambayo programu yako inahitaji na uhesabu kila kitu kingine unapohitaji. Kwa mfano, ikiwa unaunda orodha ya ununuzi, unaweza kuhifadhi bidhaa kama array katika hali. Ikiwa unataka pia kuonyesha idadi ya bidhaa kwenye orodha, usihifadhi idadi ya bidhaa kama thamani nyingine ya hali—badala yake, soma urefu wa array yako.

Sasa fikiria vipande vyote vya data katika programu hii ya mfano:

1. Orodha ya asili ya bidhaa
2. Maandishi ya utafutaji ambayo mtumiaji ameingiza
3. Value ya kisanduku cha kuteua
4. Orodha iliyochujwa ya bidhaa

Hali zipi kati ya hizi? Tambua zile ambazo sio:

• Je, inabaki ilivyo bila kubadilika baada ya muda? Ikiwa ni hivyo, hio sio hali.
• Je, imepitishwa kutoka kwa mzazi kupitia prop? Ikiwa ni hivyo, hio sio hali.
• Je, unaweza kuihesabu kulingana na hali iliyopo au vifaa katika kijenzi chako? Ikiwa ndivyo, bila shaka hio nayo sio hali!

Kilichobaki labda ni hali.

Wacha tupitie moja baada ya nyingine tena:

1. Orodha asili ya bidhaa imepitishwa kama vifaa, kwa hivyo haijabainishwa.
2. Maandishi ya utafutaji yanaonekana kuwa ya hali kwani yanabadilika kwa wakati na hayawezi kukokotwa kutoka kwa chochote.
3. Thamani ya kisanduku cha kuteua inaonekana kuwa hali kwani inabadilika kwa wakati na haiwezi kukokotwa kutoka kwa chochote.
4. Orodha iliyochujwa ya bidhaa haijabainishwa kwa sababu inaweza kukokotwa kwa kuchukua orodha asili ya bidhaa na kuichuja kulingana na maandishi ya utafutaji na thamani ya kisanduku cha kuteua.

Hii ina maana kwamba ni maandishi ya utafutaji pekee na thamani ya kisanduku cha kuteua ndizo zilizotajwa! Imefanywa vizuri!

Hatua ya 4: Tambua pale hali yako itadumu

Baada ya kutambua data ya hali ya chini zaidi ya programu yako, unahitaji kutambua ni kijenzi kipi kinawajibika kubadilisha hali hii, au kinamiliki hali. Kumbuka: React hutumia mtiririko wa data wa njia moja, kupitisha data chini ya daraja ya vijenzi kutoka kijenzi mzazi hadi cha mtoto. Huenda isieleweke mara moja ni kijenzi gani kinapaswa kumiliki hali gani. Hili linaweza kuwa gumu ikiwa wewe ni mgeni kwa dhana hii, lakini unaweza kuibaini kwa kufuata hatua hizi!

Kwa kila sehemu ya hali katika programu yako:

1. Tambua kila kijenzi kinachofanya kitu kulingana na hali hiyo.
2. Tafuta kijenzi chao cha karibu zaidi cha mzazi—kijenzi kilicho juu yao yote katika daraja.
3. Amua mahali ambapo hali inapaswa kudumu:
   1. Mara nyingi, unaweza kuweka hali moja kwa moja kwenye mzazi wao wa kawaida.
   2. Unaweza pia kuweka hali katika kijenzi fulani juu ya mzazi wao wa kawaida.
   3. Iwapo huwezi kupata kipengele ambapo inaeleweka kumiliki jimbo, unda kijenzi kipya kwa ajili ya kushikilia hali pekee na uiongeze mahali fulani katika daraja juu ya kijenzi mzazi cha kawaida.

In the previous step, you found two pieces of state in this application: the search input text, and the thamani of the checkbox. In this example, they always appear together, so it makes sense to put them into the same place.

Katika hatua ya awali, ulipata vipande viwili vya hali katika programu hii: maandishi ya ingizo ya utafutaji, na thamani ya kisanduku cha kuteua. Katika mfano huu, daima huonekana pamoja, kwa hiyo ni mantiki kuviweka katika sehemu moja.

Sasa wacha tupitie mkakati wetu kwao:

1. Tambua vijenzi vinavyotumia hali:
   • ProductTable inahitaji kuchuja orodha ya bidhaa kulingana na hali hiyo (maandishi ya utafutaji na thamani ya kisanduku cha kuteua).
   • SearchBar inahitaji kuonyesha hali hiyo (maandishi ya utafutaji na thamani ya kisanduku cha kuteua).
2. Tafuta mzazi wao wa kawaida: Kijenzi mzazi cha kwanza ambacho vijenzi vyote viwili hushiriki ni FilterableProductTable.
3. Amua mahali pa kuishi: Tutaweka maandishi ya kichujio na thamani za hali zilizochaguliwa katika FilterableProductTable.

Kwa hivyo state thamani zitaishi katika FilterableProductTable.

Ongeza hali kwa kijenzi chenye Kiunganishi (Hook) cha useState(). Hooks ni vitendaji maalum ambavyo hukuruhusu “kuunganisha” React. Ongeza vigezo viwili vya hali juu ya FilterableProductTable na ubainishe hali yao ya awali:

function FilterableProductTable({ products }) {
  const [filterText, setFilterText] = useState('');
  const [inStockOnly, setInStockOnly] = useState(false);

Kisha, pitisha filterText na inStockOnly kwa ProductTable na SearchBar kama kiunga:

<div>
  <SearchBar 
    filterText={filterText} 
    inStockOnly={inStockOnly} />
  <ProductTable 
    products={products}
    filterText={filterText}
    inStockOnly={inStockOnly} />
</div>

Unaweza kuanza kuona jinsi programu yako itakavyofanya kazi. Hariri vakue ya awali ya filterText kutoka useState('') hadi useState('fruit') katika msimbo wa kisanduku hapa chini. Utaona maandishi ya utafutaji na sasisho la jedwali:

Kumbuka kwamba kuhariri fomu bado haifanyi kazi. Kuna hitilafu ya kiweko kwenye sanduku la mchanga hapo juu kuelezea kwa nini:

Katika kisanduku cha mchanga hapo juu, viunga ProductTable na SearchBar soma filterText na inStockOnly ili kutoa jedwali, ingizo, na kisanduku cha kuteua. Kwa mfano, hivi ndivyo SearchBar inavyojaza thamani ya ingizo:

function SearchBar({ filterText, inStockOnly }) {
  return (
    <form>
      <input 
        type="text" 
        value={filterText} 
        placeholder="Search..."/>

Hata hivyo, bado hujaongeza msimbo wowote ili kujibu vitendo vya mtumiaji kama vile kuandika. Hii itakuwa hatua yako ya mwisho.

Hatua ya 5: Ongeza mtiririko wa data kinyume

You want to make it so whenever the user changes the form inputs, the state updates to reflect those changes. The state is owned by FilterableProductTable, so only it can call setFilterText and setInStockOnly. To let SearchBar update the FilterableProductTable’s state, you need to pass these functions down to SearchBar:

Kwa sasa programu yako inatekelezwa kwa njia ipasavyo ikiwa na viunga na hali inayotiririka chini ya daraja. Lakini ili kubadilisha hali kulingana na ingizo la mtumiaji, utahitaji kuauni data inayotiririka kwa njia nyingine: vijenzi vya fomu vilivyo ndani kabisa ya daraja vinahitaji kusasisha hali katika FilterableProductTable.

React hufanya mtiririko huu wa data kuwa wazi, lakini unahitaji kuandika zaidi kuliko kuunganisha data kwa njia mbili. Ukijaribu kuandika au kuteua kisanduku katika mfano ulio hapo juu, utaona kuwa React inapuuza ingizo lako. Hii ni makusudi. Kwa kuandika <input value={filterText} />, umeweka value mhimili wa input kuwa sawa na filterText hali iliyopitishwa kutoka FilterableProductTable. Kwa kuwa hali ya filterText haijawekwa kamwe, ingizo halibadiliki.

Unataka kuifanya iwe hivyo wakati wowote mtumiaji anapobadilisha ingizo za fomu, hali husasisha ili kuonyesha mabadiliko hayo. Hali hiyo inamilikiwa na FilterableProductTable, kwa hivyo inaweza tu kuita setFilterText na setInStockOnly. Ili kuruhusu SearchBar kusasisha hali ya FilterableProductTable, unahitaji kupitisha vitendaji hivi hadi kwa SearchBar:

function FilterableProductTable({ products }) {
  const [filterText, setFilterText] = useState('');
  const [inStockOnly, setInStockOnly] = useState(false);

  return (
    <div>
      <SearchBar 
        filterText={filterText} 
        inStockOnly={inStockOnly}
        onFilterTextChange={setFilterText}
        onInStockOnlyChange={setInStockOnly} />

Ndani ya SearchBar, utaongeza vidhibiti vya tukio vya onChange na kuweka hali mzazi kutoka kwao:

<input 
  type="text" 
  value={filterText} 
  placeholder="Search..." 
  onChange={(e) => onFilterTextChange(e.target.value)} />

Sasa programu inafanya kazi kikamilifu!

Unaweza kujifunza yote kuhusu kushughulikia matukio na hali ya kusasisha katika sehemu ya Kuongeza Mwingiliano.

Uende wapi kutoka hapa

Huu ulikuwa utangulizi mfupi sana wa jinsi ya kuwaza juu ya kuunda vijenzi na programu ukitumia React. Unaweza kuanzisha mradi wa React sasa hivi au kupiga mbizi zaidi kwenye sintaksia yote iliyotumika katika funzo hili.