TypeScript Academy · Pelajaran

Generik komponen — pengenalan

Bina komponen boleh guna semula dengan parameter jenis , kekangan dan inferens; hantar props render serta kunci yang ditaip dengan selamat.

Pelajaran 3 daripada 38 langkah

Generik komponen — pengenalan ialah pelajaran TypeScript Academy percuma di CoddyKit. Ini ialah pelajaran 3 daripada 3. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran TypeScript Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus TypeScript Academy merangkumi sejumlah 3 pelajaran.

Pengenalan

Matlamat: Jadikan satu komponen berfungsi untuk pelbagai bentuk data menggunakan <T>. Anda akan menghantar prop pemaparan bertaip, mengehadkan kekunci, dan membiarkan TypeScript membuat inferens terhadap T berdasarkan penggunaan.

  • Props generik dan fungsi pemaparan
  • Kekangan dengan extends
  • Pengekstrakan kekunci tanpa any

Senarai generik List<T>

List<T> generik memastikan items dan render kekal selaras. Pengguna boleh menghantar apa-apa T; inferens berfungsi apabila T jelas.

import React from "react"

type ListProps<T> = { items: T[]; render: (item: T, index: number) => React.ReactNode }

export function List<T>({ items, render }: ListProps<T>) {
  return <div style={{ display: "grid", gap: 6 }}>{items.map(render)}</div>
}

export default function App() {
  return (
    <div style={{ display: "grid", gap: 12 }}>
      <List<number> items={[1,2,3]} render={(n) => <span>#{n}</span>} />
      <List<{ id: string; name: string }>
        items={[{ id: "u1", name: "Ada" }, { id: "u2", name: "Lin" }]}
        render={(u) => <strong>{u.name}</strong>}
      />
    </div>
  )
}

Kekangan dengan extends

Gunakan T extends Keyed untuk mewajibkan id bagi kekunci. Pemanggil akan menerima ralat jika menghantar item tanpa medan yang diperlukan.

import React from "react"

type Keyed = { id: string }

type KeyListProps<T extends Keyed> = { items: T[]; render: (item: T) => React.ReactNode }

export function KeyList<T extends Keyed>({ items, render }: KeyListProps<T>) {
  return (
    <ul>
      {items.map((x) => (
        <li key={x.id}>{render(x)}</li>
      ))}
    </ul>
  )
}

export default function App() {
  const users = [{ id: "u1", name: "Ada" }, { id: "u2", name: "Lin" }]
  return <KeyList items={users} render={(u) => <span>{u.name}</span>} />
}

Inferens T

Parameter jenis biasanya dibuat inferens daripada props: di sini, T datang daripada items. Buat anotasi hanya apabila inferens tidak jelas.

import React from "react"

type GridProps<T> = { items: T[]; columns?: number; render: (item: T) => React.ReactNode }

export function Grid<T>({ items, columns = 2, render }: GridProps<T>) {
  const css = { display: "grid", gridTemplateColumns: `repeat(${columns}, 1fr)`, gap: 8 }
  return <div style={css as React.CSSProperties}>{items.map(render)}</div>
}

export default function App() {
  const products = [
    { sku: "p1", title: "Mouse", price: 25 },
    { sku: "p2", title: "Keyboard", price: 80 }
  ]
  // T is inferred from products; no need to annotate
  return <Grid items={products} render={(p) => <span>{p.title} — ${p.price}</span>} />
}

Pembantu pemaparan

Keluarkan jenis Render<T> yang boleh diguna semula untuk kejelasan. Buat kekangan apabila perlu (T extends { id: string }) untuk menyokong kekunci.

import React from "react"

type Render<T> = (item: T) => React.ReactNode

type TableProps<T extends { id: string }> = { items: T[]; renderRow: Render<T> }

export function Table<T extends { id: string }>({ items, renderRow }: TableProps<T>) {
  return (
    <table>
      <tbody>
        {items.map((x) => (
          <tr key={x.id}><td>{renderRow(x)}</td></tr>
        ))}
      </tbody>
    </table>
  )
}

export default function App() {
  const rows = [ { id: "1", label: "One" }, { id: "2", label: "Two" } ]
  return <Table items={rows} renderRow={(r) => <span>{r.label}</span>} />
}

Petua dan perangkap

Petua:

  • Utamakan inferens; buat anotasi hanya apabila membantu kebolehbacaan.
  • Gunakan kekangan extends untuk menyatakan keperluan.
  • Elakkan any dalam prop pemaparan generik; ia menggagalkan keselamatan jenis.

Semakan komponen generik

Semakan pantas: Pengisytiharan yang manakah mentakrifkan komponen React generik dengan betul?

Ringkasan

Ringkasan: Gunakan <T> untuk membina komponen yang boleh diguna semula, buat kekangan dengan extends untuk kekunci, dan biarkan inferens mengekalkan kod supaya ringkas.

Percuma untuk bermula

Pelajari TypeScript dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus
101
Pelajaran
352

Soalan Lazim

Adakah pelajaran “Generik komponen — pengenalan” percuma?

Ya — teks penuh “Generik komponen — pengenalan” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus TypeScript Academy, tingkat taraf kepada CoddyKit PRO. Kursus TypeScript Academy merangkumi sejumlah 3 pelajaran.

Apakah yang akan saya pelajari dalam “Generik komponen — pengenalan”?

Bina komponen boleh guna semula dengan parameter jenis , kekangan dan inferens; hantar props render serta kunci yang ditaip dengan selamat. Anda berlatih TypeScript Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan TypeScript Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran TypeScript Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 3 daripada 3.

Berapa lamakah pelajaran “Generik komponen — pengenalan” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran TypeScript Academy ini?

Ya. Setiap pelajaran TypeScript Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

  1. Props dan children; pengendali peristiwa; ref
  2. State dan reducer; penaipan Context
  3. Generik komponen — pengenalan
← Kembali ke TypeScript Academy