CSS: button

.instui-button — 一个可访问的操作控件，从令牌调色板中样式化；默认是主要操作。

AI 变体为其框架叠加两层渐变 — 一个 padding-box 填充和一个 border-box 描边，且 -color-ai-secondary 无法同时绘制渐变文本和填充，因此在静止时中心保持透明，悬停或激活时才填充。-without-background 的悬停和激活状态派生出低不透明度、略微加深的品牌色洗层，而不是使用原始的悬停背景令牌（那样会导致同色背景上的文本无法辨识）。还设置了自身的图标/标签 gap 和水平 padding；链式应用 -gap-*/-p-*/-padding-* 间距工具修饰符会覆盖这些内建值。可选的 .instui-button-group 包装器映射 Figma 的 .buttonGroup 并管理相邻按钮间距。

Source: button.css

无障碍

使用 aria-pressed 驱动 -toggle 变体的按下状态，并用 aria-disabled（或原生 disabled）标记禁用按钮。

用法

css

@import "@pantoken/components/components.css";
@import "@pantoken/components/button.css";

演示

示例

html

<div class="instui-button-group">
  <button class="instui-button">Primary</button>
  <button class="instui-button -color-secondary">Secondary</button>
</div>

结构

一个分组包装器以共享的按钮间隙布局相邻按钮。

text

.instui-button-group (0..1)
  .instui-button (1..n)

flowchart TD n0[".instui-button-group (0..1)"]:::cssdoc-root n1(".instui-button"):::cssdoc-part n0 -->|1..n| n1 classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

修饰符

修饰符	描述
`.-color-ai`	一个 AI 操作。
`.-color-ai-secondary`	较低强调的 AI 操作。
`.-color-danger`	破坏性操作。
`.-color-primary`	（默认）主要操作。
`.-color-primary-inverse`	已弃用 — use `.-on-color`.
`.-color-secondary`	较低强调的次要操作。
`.-color-success`	肯定/确认类操作。
`.-color-tertiary`	文本样式操作（在悬停前无填充或边框）。
`.-condensed`	用于紧凑工具栏的更窄内边距。
`.-display-block`	全宽块级按钮。
`.-ghost`	已弃用 — use `.-color-tertiary`.
`.-icon-*`	在标签前从图标集渲染一个字形（例如 `-icon-arrow-right`），按按钮文本颜色绘制；与 `-shape-square`/`-shape-circle` 配合可用于仅图标按钮。
`.-on-color`	用于放置在有色（非中性）表面上的按钮。与 `-color-primary` 组合（默认）会填充白色并使用深色文本；与 `-color-secondary` 组合则保持透明并使用白色边框和文本。
`.-shape-circle`	圆形图标按钮。
`.-shape-square`	方形图标按钮。
`.-size-large`	Large。`-size-lg` 的长形式别名。
`.-size-lg`	Large。
`.-size-md`	（默认）中等尺寸。
`.-size-medium`	（默认）中等尺寸。是 `-size-md` 的长形式别名。
`.-size-sm`	小号。
`.-size-small`	小号。`-size-sm` 的长形式别名。
`.-toggle`	按下态切换按钮（使用 aria-pressed 驱动）。
`.-without-background`	去除填充（幽灵）。
`.-without-border`	移除边框。

伪元素

伪元素	描述
`::after`	AI 次要渐变边框环，仅遮罩到按钮的框架部分。
`::before`	AI 字形，自动添加到 AI 按钮并使用该变体自身的颜色进行遮罩。

状态

状态	描述
`[aria-disabled="true"]`	—
`[aria-pressed="true"]`	—
`:disabled`	—
`:state(pressed)`	—

消耗代币

Token	类型	值
`--instui-border-width-md`	`<length>`	`0.125rem`
`--instui-border-width-sm`	`<length>`	`0.0625rem`
`--instui-color-background-interactive-action-ai-bottom-gradient-active`	`<color>`	`#01626E`
`--instui-color-background-interactive-action-ai-bottom-gradient-base`	`<color>`	`#027887`
`--instui-color-background-interactive-action-ai-bottom-gradient-hover`	`<color>`	`#00828E`
`--instui-color-background-interactive-action-ai-secondary-active-bottom-gradient`	`<color>`	LightDark`light-dark(#CFF0F6, #00424A)`
`--instui-color-background-interactive-action-ai-secondary-active-top-gradient`	`<color>`	LightDark`light-dark(#F3E5F7, #522965)`
`--instui-color-background-interactive-action-ai-secondary-hover-bottom-gradient`	`<color>`	LightDark`light-dark(#CFF0F6, #00424A)`
`--instui-color-background-interactive-action-ai-secondary-hover-top-gradient`	`<color>`	LightDark`light-dark(#F3E5F7, #522965)`
`--instui-color-background-interactive-action-ai-top-gradient-active`	`<color>`	`#793F93`
`--instui-color-background-interactive-action-ai-top-gradient-base`	`<color>`	`#944FB3`
`--instui-color-background-interactive-action-ai-top-gradient-hover`	`<color>`	`#9E58BD`
`--instui-color-background-interactive-action-destructive-active`	`<color>`	`#AE161B`
`--instui-color-background-interactive-action-destructive-base`	`<color>`	`#CF1F24`
`--instui-color-background-interactive-action-destructive-hover`	`<color>`	`#E62429`
`--instui-color-background-interactive-action-primary-active`	`<color>`	LightDark`light-dark(#061C30, #D5E2F6)`
`--instui-color-background-interactive-action-primary-base`	`<color>`	LightDark`light-dark(#1D354F, #EEF4FD)`
`--instui-color-background-interactive-action-primary-hover`	`<color>`	LightDark`light-dark(#234465, #ffffff)`
`--instui-color-background-interactive-action-secondary-active`	`<color>`	LightDark`light-dark(#44709F, #2E5177)`
`--instui-color-background-interactive-action-success-base`	`<color>`	`#037D37`
`--instui-color-background-interactive-action-success-hover`	`<color>`	`#03893D`
`--instui-color-background-muted`	`<color>`	LightDark`light-dark(#F2F4F5, #273540)`
`--instui-color-stroke-interactive-action-ai-bottom-gradient-active`	`<color>`	LightDark`light-dark(#01626E, #02717E)`
`--instui-color-stroke-interactive-action-ai-bottom-gradient-base`	`<color>`	`#027887`
`--instui-color-stroke-interactive-action-ai-bottom-gradient-hover`	`<color>`	`#00828E`
`--instui-color-stroke-interactive-action-ai-top-gradient-active`	`<color>`	LightDark`light-dark(#793F93, #8A49A7)`
`--instui-color-stroke-interactive-action-ai-top-gradient-base`	`<color>`	`#944FB3`
`--instui-color-stroke-interactive-action-ai-top-gradient-hover`	`<color>`	`#9E58BD`
`--instui-color-stroke-interactive-action-primary-active`	`<color>`	LightDark`light-dark(#061C30, #D5E2F6)`
`--instui-color-stroke-interactive-action-primary-base`	`<color>`	LightDark`light-dark(#1D354F, #EEF4FD)`
`--instui-color-stroke-interactive-action-primary-hover`	`<color>`	LightDark`light-dark(#234465, #ffffff)`
`--instui-color-stroke-interactive-action-secondary-active`	`<color>`	LightDark`light-dark(#44709F, #2E5177)`
`--instui-color-text-interactive-action-ai-active`	`<color>`	`#ffffff`
`--instui-color-text-interactive-action-ai-base`	`<color>`	`#ffffff`
`--instui-color-text-interactive-action-ai-hover`	`<color>`	`#ffffff`
`--instui-color-text-interactive-action-ai-secondary-bottom-gradient-base`	`<color>`	LightDark`light-dark(#027887, #3CC0D4)`
`--instui-color-text-interactive-action-ai-secondary-top-gradient-base`	`<color>`	LightDark`light-dark(#944FB3, #CAA1D9)`
`--instui-color-text-interactive-action-primary-base`	`<color>`	LightDark`light-dark(#ffffff, #1D354F)`
`--instui-color-text-interactive-action-secondary-base`	`<color>`	LightDark`light-dark(#1D354F, #ffffff)`
`--instui-color-text-interactive-action-status-base`	`<color>`	`#ffffff`
`--instui-component-base-button-ai-disabled-background-color`	`<color>`	LightDark`light-dark(#DFE1E3, #334450)`
`--instui-component-base-button-ai-disabled-border-color`	`<color>`	LightDark`light-dark(#DFE1E3, #334450)`
`--instui-component-base-button-ai-disabled-text-color`	`<color>`	LightDark`light-dark(#9EA6AD, #6A7883)`
`--instui-component-base-button-border-radius`	`<length>`	`0.75rem`
`--instui-component-base-button-large-font-size`	`<length>`	`1.125rem`
`--instui-component-base-button-large-height`	`<length>`	`3rem`
`--instui-component-base-button-large-padding-horizontal`	`<length>`	`1.25rem`
`--instui-component-base-button-medium-font-size`	`<length>`	`1rem`
`--instui-component-base-button-medium-height`	`<length>`	`2.5rem`
`--instui-component-base-button-medium-padding-horizontal`	`<length>`	`1rem`
`--instui-component-base-button-primary-color`	`<color>`	LightDark`light-dark(#ffffff, #1D354F)`
`--instui-component-base-button-primary-disabled-background-color`	`<color>`	LightDark`light-dark(#DFE1E3, #334450)`
`--instui-component-base-button-primary-disabled-border-color`	`<color>`	LightDark`light-dark(#DFE1E3, #334450)`
`--instui-component-base-button-primary-ghost-active-background`	`<color>`	LightDark`light-dark(#1D354F33, rgba(255,255,255,0.1))`
`--instui-component-base-button-primary-ghost-background`	`<color>`	`transparent`
`--instui-component-base-button-primary-ghost-border-color`	`<color>`	LightDark`light-dark(#1D354F66, #EEF4FD)`
`--instui-component-base-button-primary-ghost-color`	`<color>`	LightDark`light-dark(#1D354F, #EEF4FD)`
`--instui-component-base-button-primary-ghost-hover-background`	`<color>`	LightDark`light-dark(#1D354F1A, rgba(255,255,255,0.1))`
`--instui-component-base-button-primary-inverse-active-background`	`<color>`	`#B6CCEA`
`--instui-component-base-button-primary-inverse-background`	`<color>`	`#ffffff`
`--instui-component-base-button-primary-inverse-border-color`	`<color>`	`#ffffff`
`--instui-component-base-button-primary-inverse-color`	`<color>`	`#213D5B`
`--instui-component-base-button-primary-inverse-ghost-active-background`	`<color>`	`rgba(255,255,255,0.1)`
`--instui-component-base-button-primary-inverse-ghost-border-color`	`<color>`	`#ffffff`
`--instui-component-base-button-primary-inverse-ghost-color`	`<color>`	`#ffffff`
`--instui-component-base-button-primary-inverse-ghost-hover-background`	`<color>`	`rgba(255,255,255,0.1)`
`--instui-component-base-button-primary-inverse-hover-background`	`<color>`	`#D5E2F6`
`--instui-component-base-button-primary-on-color-active-border-color`	`<color>`	`#B6CCEA`
`--instui-component-base-button-primary-on-color-active-text-color`	`<color>`	`#213D5B`
`--instui-component-base-button-primary-on-color-disabled-background-color`	`<color>`	`#8D959F`
`--instui-component-base-button-primary-on-color-disabled-border-color`	`<color>`	`#8D959F`
`--instui-component-base-button-primary-on-color-disabled-text-color`	`<color>`	`#4A5B68`
`--instui-component-base-button-primary-on-color-hover-border-color`	`<color>`	`#D5E2F6`
`--instui-component-base-button-primary-on-color-hover-text-color`	`<color>`	`#213D5B`
`--instui-component-base-button-secondary-active-background`	`<color>`	LightDark`light-dark(#3D658F33, #86A8D5)`
`--instui-component-base-button-secondary-active-border-color`	`<color>`	LightDark`light-dark(#44709F00, #86A8D5)`
`--instui-component-base-button-secondary-active-text-color`	`<color>`	LightDark`light-dark(#1D354F, #ffffff)`
`--instui-component-base-button-secondary-background`	`<color>`	LightDark`light-dark(#44709F33, #86A8D5)`
`--instui-component-base-button-secondary-border-color`	`<color>`	LightDark`light-dark(#44709F00, #86A8D5)`
`--instui-component-base-button-secondary-color`	`<color>`	LightDark`light-dark(#1D354F, #ffffff)`
`--instui-component-base-button-secondary-disabled-background-color`	`<color>`	LightDark`light-dark(#DFE1E3, #334450)`
`--instui-component-base-button-secondary-disabled-border-color`	`<color>`	LightDark`light-dark(#DFE1E3, #334450)`
`--instui-component-base-button-secondary-disabled-text-color`	`<color>`	LightDark`light-dark(#9EA6AD, #6A7883)`
`--instui-component-base-button-secondary-hover-background`	`<color>`	LightDark`light-dark(#4D7EB333, #86A8D5)`
`--instui-component-base-button-secondary-hover-border-color`	`<color>`	LightDark`light-dark(#44709F00, #86A8D5)`
`--instui-component-base-button-secondary-hover-text-color`	`<color>`	LightDark`light-dark(#1D354F, #ffffff)`
`--instui-component-base-button-secondary-on-color-active-border-color`	`<color>`	`#B6CCEA`
`--instui-component-base-button-secondary-on-color-active-text-color`	`<color>`	`#ffffff`
`--instui-component-base-button-secondary-on-color-disabled-border-color`	`<color>`	`#8D959F`
`--instui-component-base-button-secondary-on-color-disabled-text-color`	`<color>`	`#9EA6AD`
`--instui-component-base-button-secondary-on-color-hover-text-color`	`<color>`	`#ffffff`
`--instui-component-base-button-small-font-size`	`<length>`	`0.875rem`
`--instui-component-base-button-small-height`	`<length>`	`2rem`
`--instui-component-base-button-small-padding-horizontal`	`<length>`	`0.75rem`
`--instui-component-base-button-tertiary-active-border-color`	`<color>`	LightDark`light-dark(#1D354F4D, #EEF4FD)`
`--instui-component-base-button-tertiary-active-text-color`	`<color>`	LightDark`light-dark(#1D354F, #EEF4FD)`
`--instui-component-base-button-tertiary-disabled-border-color`	`<color>`	LightDark`light-dark(#C7CACD, #4A5B68)`
`--instui-component-base-button-tertiary-disabled-text-color`	`<color>`	LightDark`light-dark(#AAB0B5, #4A5B68)`
`--instui-component-base-button-tertiary-hover-border-color`	`<color>`	LightDark`light-dark(#1D354F33, #EEF4FD)`
`--instui-component-base-button-tertiary-hover-text-color`	`<color>`	LightDark`light-dark(#1D354F, #EEF4FD)`
`--instui-component-icon-action-ai-disabled-color`	`<color>`	LightDark`light-dark(#9EA6AD, #6A7883)`
`--instui-component-shared-tokens-spacing-gap-buttons`	`<length>`	`0.75rem`
`--instui-font-family-base`	`[ <font-family-name> \| <generic-font-family> ]#`	`Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif`
`--instui-font-weight-interactive`	`<integer>`	`500`
`--instui-line-height-standalone-text-base`	`<length>`	`1rem`
`--instui-spacing-space-xs`	`<length>`	`0.25rem`

tools

ai

platforms

renderers

packages

formats

design

bundlers

plugins

pantoken

postcss

typedoc

vite

组件

breadcrumb

calendar

drawer-layout

list

menu

modal

pagination

side-nav-bar

table

tabs

实用工具

规则

Plugins

layout

CSS: button

无障碍

用法

演示

示例

结构

修饰符

伪元素

状态

消耗代币

相关

pantoken

postcss

typedoc

vite

breadcrumb

calendar

drawer-layout

list

menu

modal

pagination

side-nav-bar

table

tabs

CSS: button ​

无障碍 ​

用法 ​

演示 ​

示例 ​

结构 ​

修饰符 ​

伪元素 ​

状态 ​

消耗代币 ​

相关 ​

CSS: button

无障碍

用法

演示

示例

结构

修饰符

伪元素

状态

消耗代币

相关