组件Controls
TextLink
@mox-hub/ui 组件 · Controls · canonical
text-link@mox-hub/uiControlscanonicalsrc/components/text-link.tsxProps API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| className* | string | — | — |
源码
import type { ComponentProps } from 'react'
import { cn } from '../lib/utils'
/**
* TextLink —— 独立文本链接。
*
* 与 Button 的分工:
* - 按钮语义(会触发动作)用 `Button`(quiet / subtle / ghost 等),hover 靠底色与文字色,
* 不出现文字下划线;
* - 链接语义(导航到 URL)用本组件,下划线是唯一正确的可点击暗示。
*
* 作为纯 `<a>` 渲染,不承担按钮的固定高度、按下位移与 disabled 语义;
* 客户端路由链接由消费方包一层(如 Next.js `<Link>`)并透传 className。
*/
export interface TextLinkProps extends ComponentProps<'a'> {}
export function TextLink({ className, ...props }: TextLinkProps) {
return (
<a
data-slot="text-link"
className={cn(
'inline-flex items-center gap-1 rounded-sm text-primary underline underline-offset-4 decoration-primary/40 transition-colors duration-fast hover:decoration-primary focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/50',
className
)}
{...props}
/>
)
}
可访问性与 RTL
- 键盘:交互件保留
:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。 - RTL:间距、对齐与方向性图标使用逻辑属性 (
ms-*/text-start/rtl:-scale-x-100);通过ThemeProvider或I18nProvider的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。 - 文案:优先用组件
labels/translate/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
独立文本链接(<a>):常显下划线表达导航语义;触发动作请用 button,不要用文本链接伪装按钮。