TypeScript Academy · 课时

多态组件；as 属性

构建带有 as 属性的多态 Button 组件；合并内置属性和 DOM 属性；使用 forwardRef 和 ComponentRef 为引用指定类型。

多态组件；as 属性 是 CoddyKit 上的免费 TypeScript Academy 课时。这是第 1 节课，共 1 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 1 节课。

入门

目标：构建一个多态 Button，使其可以通过 as 属性渲染为 button、a 或任意元素，同时保留属性和引用类型。

将 T 约束为 React.ElementType
安全地合并属性
为转发的引用指定类型

基础类型

从 OwnProps 开始，使用工具类型 PolymorphicProps<T, P>，将 T 的内置属性与自定义属性合并。

import React from "react"

type OwnProps = {
  variant?: "solid" | "outline"
  children: React.ReactNode
}

type PolymorphicProps<T extends React.ElementType, P> = {
  as?: T
} & P & Omit<React.ComponentPropsWithoutRef<T>, keyof P | "as">

// Example: Omit avoids prop collisions (e.g., our OwnProps vs intrinsic props)

多态 Button

该组件默认为 button，但也接受 as。引用类型会随 T 改变（例如，"a" 对应 HTMLAnchorElement）。

import React, { forwardRef } from "react"

type OwnProps = { variant?: "solid" | "outline"; children: React.ReactNode }

type PolymorphicProps<T extends React.ElementType, P> = { as?: T } & P & Omit<React.ComponentPropsWithoutRef<T>, keyof P | "as">

const ButtonInner = <T extends React.ElementType = "button">(
  { as, variant = "solid", children, ...rest }: PolymorphicProps<T, OwnProps>,
  ref: React.ForwardedRef<React.ComponentRef<T>>
) => {
  const Component = (as || "button") as React.ElementType
  const style = variant === "outline" ? { border: "1px solid #333", padding: 8 } : { background: "#2563eb", color: "white", padding: 8, borderRadius: 6 }
  return <Component ref={ref} style={style} {...rest}>{children}</Component>
}

export const Button = forwardRef(ButtonInner) as <T extends React.ElementType = "button">(
  props: PolymorphicProps<T, OwnProps> & { ref?: React.Ref<React.ComponentRef<T>> }
) => JSX.Element

使用示例

当 as="a" 时，href 等内置属性会变得可用，并且引用的类型为 HTMLAnchorElement。

import React, { useRef } from "react"
import { Button } from "./Button"

export default function App() {
  const btnRef = useRef<HTMLButtonElement>(null)
  const linkRef = useRef<HTMLAnchorElement>(null)

  return (
    <div style={{ display: "grid", gap: 8 }}>
      <Button ref={btnRef} onClick={() => alert("clicked")}>Save</Button>
      <Button as="a" ref={linkRef} href="#docs" variant="outline">Docs</Button>
    </div>
  )
}

变体

您可以包装这个多态组件，同时保留其灵活性。使用 ComponentProps<typeof Button> 继承它的属性。

import React from "react"
import { Button } from "./Button"

export function DangerButton(props: Omit<React.ComponentProps<typeof Button>, "variant">) {
  return <Button {...props} style={{ background: "#dc2626", color: "white", padding: 8, borderRadius: 6 }} />
}

// Works with polymorphism too
export default function App() {
  return (
    <div style={{ display: "grid", gap: 8 }}>
      <DangerButton>Delete</DangerButton>
      <DangerButton as="a" href="#confirm">Delete link</DangerButton>
    </div>
  )
}

提示

提示：

将 T 约束为 React.ElementType。
使用 Omit 解决属性名称冲突。
使用 forwardRef 转发引用，并将其类型指定为 React.ComponentRef<T>。

多态类型检查

快速检查：哪种类型定义可以正确描述一个会转发引用的多态组件？

回顾

回顾：您构建了带有 as 属性的多态 Button，安全地合并了内置属性，并为转发的引用指定了类型，因此使用者可以获得正确的智能提示。

常见问题解答

「多态组件；as 属性」课时是免费的吗？

是的 — 「多态组件；as 属性」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 1 节课。

「多态组件；as 属性」这节课中我会学到什么？

构建带有 as 属性的多态 Button 组件；合并内置属性和 DOM 属性；使用 forwardRef 和 ComponentRef 为引用指定类型。你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 1 节。

「多态组件；as 属性」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

← 返回 TypeScript Academy