跳转到正文

按钮 ​

用于触发即时操作,例如提交、保存或确认。它是验证组件源码、样式、文档示例、类型和分包构建是否贯通的最小示例。

基础用法 ​

loading

API ​

Props ​

名称说明类型默认值
type按钮视觉类型'default' | 'primary''default'
disabled是否禁用按钮booleanfalse

Events ​

名称说明参数
click点击未禁用的按钮时触发(event: MouseEvent)

Slots ​

名称说明
default按钮内容

设计令牌 ​

Button 使用以下全局 CSS 变量,可以在应用主题中覆盖:

变量用途
--pl-color-primary主要按钮背景与边框
--pl-color-primary-text主要按钮文字
--pl-color-text默认按钮文字
--pl-color-bg默认按钮背景
--pl-color-border默认按钮边框

这些变量定义在令牌层。完整引入的 style.css 自带,按需引入时需要单独引入 @plinth/ui/tokens.css,见使用组件库。

示例组件

PlButton 是底座中的实验组件,不是完整设计系统的 Button。实际项目可以在保留工程契约的前提下重写它。pnpm bootstrap 若选择了 scss 或 less,它的 <style> 会被补上对应 lang;新组件由 pnpm gen component 按 lib.config.ts 生成。