For AI agents: the complete documentation index is available at /next/zh/llms.txt, the full documentation bundle is available at /next/zh/llms-full.txt, and this page is available as Markdown at /next/zh/ui/components/button.md.
lynx-ui logo
lynx-ui
  • 简体中文
  • Button

    一个适用于 ReactLynx 的无样式按钮组件,提供按压态(`active`)追踪和用于自定义样式的 render props。
    Info

    你可以查看源码来了解它的运行原理,也欢迎大家提 MR 来丰富其能力。

    此外,你也可以参考这个实现,自行实现定制化的 Button 能力;

    基础用法

    结构

    <Button>
      {/* Your content */}
    </Button>

    组件 API

    Button

    The root component of the Button, containing all of its child components.

    buttonPropsiOSAndroidHarmony
    类型ViewProps
    按钮支持将原始视图属性直接展开到这个属性中。
    classNameiOSAndroidHarmony
    类型string
    类名
    disablediOSAndroidHarmony
    类型boolean·默认值false
    决定按钮是否被禁用。
    onClickiOSAndroidHarmony
    类型() => void
    按钮被点击时触发。
    styleiOSAndroidHarmony
    类型CSSProperties
    样式
    childreniOSAndroidHarmony
    类型| ReactNode | ((state: {active: boolean, disabled: boolean}) => ReactNode)
    子组件

    基于状态的样式与渲染

    该组件通过以下一种或两种方式暴露运行时状态。下表仅展示每个状态实际支持的方式:

    • UI variant class:支持时,对应组件节点会动态加上 ui-<state> 形式的类名,可用 .ui-<state> { ... } 选择器定制样式;
    • Render-prop 字段:支持时,当 children 传入函数,状态会以 children({ <state>: boolean, ... }) 的形式作为参数传入,便于在运行时做条件渲染。

    UI variants applied by Button based on its render state.

    类名渲染属性类型说明
    ui-activeactiveboolean按钮当前是否处于按下态(且未被禁用)。 当 status.active 为 true 时生效,可用于 `.ui-active { ... }`。
    ui-disableddisabledboolean按钮是否处于禁用态。 当 status.disabled 为 true 时生效,可用于 `.ui-disabled { ... }`。
    除非另有说明,本项目采用知识共享署名 4.0 国际许可协议进行许可,代码示例采用 Apache License 2.0 许可协议进行许可。