链接API
React Link 组件的 API 参考文档。了解此导出模块的属性、CSS 和其他 API。
演示
导入
import Link from '@mui/joy/Link';
// or
import { Link } from '@mui/joy';通过阅读关于最小化 bundle 大小的指南，了解它们之间的区别。
原生组件的属性也可用。
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| children | node | - | 组件的内容。 |
| color | 'danger' | 'neutral' | 'primary' | 'success' | 'warning' | string | 'primary' | 链接的颜色。 要了解如何添加自定义颜色，请查看主题组件 - 扩展颜色。 |
| component | elementType | - | 用于根节点的组件。可以使用字符串来使用 HTML 元素或组件。 |
| disabled | bool | false | 如果为 |
| endDecorator | node | - | 放置在 children 之后的元素。 |
| level | 'body1' | 'body2' | 'body3' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'inherit' | string | 'body-md' | 应用主题排版样式。 |
| overlay | bool | false | 如果为 |
| slotProps | { endDecorator?: func | object, root?: func | object, startDecorator?: func | object } | {} | 用于每个内部插槽的属性。 |
| slots | { endDecorator?: elementType, root?: elementType, startDecorator?: elementType } | {} | 用于每个内部插槽的组件。 有关更多详细信息，请参阅下面的 Slots API。 |
| startDecorator | node | - | 放置在 children 之前的元素。 |
| sx | Array<func | object | bool> | func | object | - | 允许定义系统覆盖以及其他 CSS 样式的系统属性。 有关更多详细信息，请参阅 `sx` 页面。 |
| textColor | any | - | 系统颜色。 |
| underline | 'always' | 'hover' | 'none' | 'hover' | 控制链接何时应带有下划线。 |
| variant | 'outlined' | 'plain' | 'soft' | 'solid' | string | 'plain' | 应用主题链接样式。 要了解如何添加自定义变体，请查看主题组件 - 扩展变体。 |
ref 被转发到根元素。主题默认属性
您可以使用 JoyLink 通过主题更改此组件的默认属性。
要了解如何自定义插槽，请查看覆盖组件结构指南。
| 插槽名称 | 类名 | 默认组件 | 描述 |
|---|---|---|---|
| root | .MuiLink-root | 'a' | 渲染根节点的组件。 |
| startDecorator | .MuiLink-startDecorator | 'span' | 渲染 start 装饰器的组件。 |
| endDecorator | .MuiLink-endDecorator | 'span' | 渲染 end 装饰器的组件。 |
这些类名对于使用 CSS 进行样式设置很有用。当触发特定状态时，它们将应用于组件的插槽。
| 类名 | 规则名称 | 描述 |
|---|---|---|
| .Mui-disabled | 如果 disabled={true}，则应用于根元素的状态类。 | |
| .Mui-focusVisible | 如果链接是键盘聚焦的，则应用于根元素的状态类。 | |
| .MuiLink-body-lg | body-lg | 如果 level="body-lg"，则应用于根元素的类名。 |
| .MuiLink-body-md | body-md | 如果 level="body-md"，则应用于根元素的类名。 |
| .MuiLink-body-sm | body-sm | 如果 level="body-sm"，则应用于根元素的类名。 |
| .MuiLink-body-xs | body-xs | 如果 level="body-xs"，则应用于根元素的类名。 |
| .MuiLink-colorContext | colorContext | 当颜色反转被触发时应用于根元素的类名。 |
| .MuiLink-colorDanger | colorDanger | 如果 color="danger"，则应用于根元素的类名。 |
| .MuiLink-colorNeutral | colorNeutral | 如果 color="neutral"，则应用于根元素的类名。 |
| .MuiLink-colorPrimary | colorPrimary | 如果 color="primary"，则应用于根元素的类名。 |
| .MuiLink-colorSuccess | colorSuccess | 如果 color="success"，则应用于根元素的类名。 |
| .MuiLink-colorWarning | colorWarning | 如果 color="warning"，则应用于根元素的类名。 |
| .MuiLink-h1 | h1 | 如果 level="h1"，则应用于根元素的类名。 |
| .MuiLink-h2 | h2 | 如果 level="h2"，则应用于根元素的类名。 |
| .MuiLink-h3 | h3 | 如果 level="h3"，则应用于根元素的类名。 |
| .MuiLink-h4 | h4 | 如果 level="h4"，则应用于根元素的类名。 |
| .MuiLink-title-lg | title-lg | 如果 level="title-lg"，则应用于根元素的类名。 |
| .MuiLink-title-md | title-md | 如果 level="title-md"，则应用于根元素的类名。 |
| .MuiLink-title-sm | title-sm | 如果 level="title-sm"，则应用于根元素的类名。 |
| .MuiLink-underlineAlways | underlineAlways | 如果 underline="always"，则应用于根元素的类名。 |
| .MuiLink-underlineHover | underlineHover | 如果 underline="hover"，则应用于根元素的类名。 |
| .MuiLink-underlineNone | underlineNone | 如果 underline="none"，则应用于根元素的类名。 |
| .MuiLink-variantOutlined | variantOutlined | 如果 variant="outlined"，则应用于根元素的类名。 |
| .MuiLink-variantPlain | variantPlain | 如果 variant="plain"，则应用于根元素的类名。 |
| .MuiLink-variantSoft | variantSoft | 如果 variant="soft"，则应用于根元素的类名。 |
| .MuiLink-variantSolid | variantSolid | 如果 variant="solid"，则应用于根元素的类名。 |
您可以使用以下自定义选项之一覆盖组件的样式
- 使用全局类名。
- 在自定义主题中，使用作为组件
styleOverrides属性一部分的规则名称。
源代码
如果您在此页面中找不到所需信息，请考虑查看组件的实现以获取更多详细信息。