vendor: amis 6.13.0 base (fork root)

This commit is contained in:
2026-06-16 22:14:57 +08:00
commit 8c8e4247a9
3840 changed files with 2467374 additions and 0 deletions

View File

@@ -0,0 +1,84 @@
---
title: CSS 变量
---
目前示例中包含了一个[主题编辑器](../../examples/theme),可以在线实时预览效果。
要想使用 CSS 变量就必须知道某个组件都用到了哪些变量,目前最完善的方式是用 Chrome 开发者工具。
不过如果你不知道如何使用,本文将会介绍一些常用的 CSS 变量,掌握他们也能完成大部分定制工作。
## 基础颜色
| 变量 | 类型 | 说明 |
| -------------------- | ---- | ------------------------------ |
| --black | 颜色 | 黑色颜色 |
| --white | 颜色 | 白色颜色 |
| --light | 颜色 | 最浅的颜色 |
| --dark | 颜色 | 最深的颜色 |
| --body-bg | 颜色 | 全局背景色 |
| --background | 颜色 | table 等背景色 |
| --primary | 颜色 | 主颜色,会影响主按钮颜色 |
| --primary-onHover | 颜色 | 主颜色在鼠标移上去后的颜色 |
| --primary-onActive | 颜色 | 主颜色在激活时的颜色,比如选中 |
| --secondary | 颜色 | 次颜色,比如第二个按钮的颜色 |
| --secondary-onHover | 颜色 | 次颜色在鼠标移上去后的颜色 |
| --secondary-onActive | 颜色 | 次颜色在激活时的颜色 |
| --success | 颜色 | 成功时的颜色 |
| --success-onHover | 颜色 | 在鼠标移上去后的颜色 |
| --success-onActive | 颜色 | 在激活时的颜色 |
| --info | 颜色 | 显示信息的颜色,一般是蓝色 |
| --info-onHover | 颜色 | 在鼠标移上去后的颜色 |
| --info-onActive | 颜色 | 在激活时的颜色 |
| --warning | 颜色 | 警告的颜色 |
| --warning-onHover | 颜色 | 在鼠标移上去后的颜色 |
| --warning-onActive | 颜色 | 在激活时的颜色 |
| --danger | 颜色 | 错误的颜色 |
| --danger-onHover | 颜色 | 在鼠标移上去后的颜色 |
| --danger-onActive | 颜色 | 在激活时的颜色 |
## 字体相关
| 变量 | 类型 | 说明 |
| --------------------- | -------- | ----------------------- |
| --text-color | 颜色 | 文字颜色 |
| --text--muted-color | 颜色 | 文字置灰时的颜色 |
| --text--loud-color | 颜色 | 一般用于标题文字颜色 |
| --button-color | 颜色 | 按钮文字颜色 |
| --fontFamilyBase | 字体家族 | 基础字体家族 |
| --fontFamilyMonospace | 字体家族 | 等宽字体家族 |
| --fontSizeBase | 大小 | 基础字体大小,默认 14px |
| --fontSizeMd | 大小 | 中等字体大小 |
| --fontSizeLg | 大小 | 大字体大小 |
| --fontSizeXl | 大小 | 最大字体大小 |
| --fontSizeSm | 大小 | 小字体大小 |
| --fontSizeXs | 大小 | 最小的字体大小 |
| --lineHeightBase | 大小 | 基础行高 |
## 边框相关
| 变量 | 类型 | 说明 |
| -------------- | ---- | ------------ |
| --borderColor | 颜色 | 边框颜色 |
| --borderRadius | 大小 | 默认边框圆角 |
## 链接相关
| 变量 | 类型 | 说明 |
| ------------------------- | --------------- | ---------------------------------- |
| --link-color | 颜色 | 链接颜色,默认用 --primary |
| --link-decoration | text-decoration | 可以控制是否显示下划线 |
| --link-onHover-color | 颜色 | 链接在鼠标移上去之后的颜色 |
| --link-onHover-decoration | text-decoration | 可以控制鼠标移上去后是否显示下划线 |
## 动画
| 变量 | 类型 | 说明 |
| -------------------- | ---- | ------------------------------------------------ |
| --animation-duration | 时长 | 动画效果时长,默认 0.1s,可以设置为 0 来关闭动画 |
## 图片
| 变量 | 类型 | 说明 |
| ------------ | ---------- | ---------------------------------- |
| --Spinner-bg | background | 加载时的图片 url('data:image/...') |

95
docs/zh-CN/style/index.md Normal file
View File

@@ -0,0 +1,95 @@
---
title: 快速开始
---
示例有个[主题编辑器](../../examples/theme),可以在线实时预览效果。
> 这是 1.1.0 版本中新增的功能
在 amis 中自定义样式有四种方式:
1. 使用 CSS 变量动态修改,通过这种方式修改大部分 amis 组件的样式,所有组件都会生效,注意这种方法不支持 IE11。
2. 使用辅助 class,可以对单个组件做定制修改。
3. 自己生成主题 CSS,可以修改所有配置,目前只能通过源码方式,请参考 `scss\themes\cxd.scss` 文件,修改变量后重新编译一个 css,需要注意这种方式在更新 amis 版本的时候最好重新编译,否则就会出现使用旧版 css 的情况,可能导致出错,因此不推荐使用。
4. `wrapper` 组件可以直接写内嵌 `style`。
本文主要介绍前两种方法:
## CSS 变量
在 page 下可以设置 cssVars 属性,通过它来动态修改 amis 内的 css 变量。
```schema
{
"type": "page",
"cssVars": {
"--text-color": "#CD3632",
"--primary": "#CD3632",
"--primary-onHover": "#F23F3A",
"--primary-onActive": "#BB312D"
},
"body": {
"type": "form",
"body": [
{
"type": "input-text",
"label": "文本",
"name": "text"
},
{
"type": "input-password",
"label": "密码",
"name": "password"
}
]
}
}
```
具体有哪些变量请参考左侧的 [CSS 变量](css-vars) 说明。
## 辅助 class
辅助 class 参考自[tailwindcss](https://tailwindcss.com/), 做了精简,把一些不常用的剔除了,响应式方面只保留 pc 和手机两种,css 未压缩版本大概是 800K 左右,比 tailwind 要小很多。
使用方法:
- JS SDK
- 引入 sdk 中的文件 `<link rel="stylesheet" href="sdk/helper.css" />`
- React
- `import 'amis/lib/helper.css'`;
目前这个文件没有和主题文件合并在一起,用户可以选择性加载。
大部分 amis 组件都有 `className` 或者 `xxxClassName` 的配置,比如下面的配置给表单增加了边框、圆角和阴影
```schema: scope="body"
{
"type": "form",
"panelClassName": "border-solid border-2 border-blue-500 rounded-xl shadow-lg",
"body": [
{
"type": "input-text",
"className": "text-green-700",
"label": "文本框",
"name": "text"
},
{
"type": "input-password",
"label": "密码",
"name": "password"
}
]
}
```
还可以:
- 通过 `flex` `flex-shrink-0` 来设置布局方式。
- 通过 `bg-blue-100` `bg-white` 之类的类名设置背景色。
- 通过 `shadow-md` 设置投影。
- 通过 `rounded-xl` 设置圆角。
- 通过 `text-xl`、`font-medium` 设置字体大小粗细。
- 等等。。
具体用法请查看左边的文档列表。

View File

@@ -0,0 +1,13 @@
---
title: 辅助类 - 响应式设计
---
响应式设计目前只支持 pc 端和手机端,其他设备目前不支持,貌似也没必要支持。当什么前缀都不加时,就是给所有视图模式添加样式,包括移动端和 pc 端。如果你在 css 类名前面再加个 `m:` 前缀,就是专门给手机端设置样式。如果你在类名前面加个 `pc:` 前缀,则是给桌面端设置样式。
```schema: scope="body"
{
"type": "tpl",
"className": "text-blue-500 m:text-red-500",
"tpl": "这段文字在 pc 端是蓝色的,在移动端则是是红色的。"
}
```

142
docs/zh-CN/style/state.md Normal file
View File

@@ -0,0 +1,142 @@
---
title: 辅助类 - 状态样式
---
除了给默认状态设置样式外,还支持几个特定状态的样式设置比如:hover(鼠标悬停)、active(当前选中)、focus(当前聚焦)或者 disabled(当前不可用)。
```html
<button
class="Button
rounded-xl text-light
bg-pink-400 border-pink-600
hover:bg-pink-500 hover:border-pink-800
active:bg-pink-600 active:border-pink-900"
>
按钮示例
</button>
<button
class="Button m-l-16
rounded-xl text-light
bg-pink-500 border-pink-800
hover:bg-pink-500 hover:border-pink-800"
>
悬停态
</button>
<button
class="Button m-l-xs
rounded-xl text-light
bg-pink-600 border-pink-900
hover:bg-pink-600 hover:border-pink-900"
>
按下态
</button>
<button
class="Button m-l-xs
rounded-xl text-light
disabled:text-dark disabled:bg-pink-200 disabled:border-pink-400"
disabled
>
禁用态
</button>
```
## Hover
在 css 类名前面添加 `hover:` 表示在 hover 时启用这个样式比如。
```html
<button
class="Button
text-blue-500
hover:text-red-500"
>
蓝色按钮,hover 红色
</button>
```
## Group-Hover
当 hover 某个元素的时候,你想要给子元素设置不同的样式,需要两步操作。
1. 给容器添加 `group` 类名。
2. 给子元素添加 `group-hover:` 前缀形式的样式类。
```html
<div
class="group p-4 border border-solid border-dark
hover:bg-dark"
>
<p class="group-hover:text-red-500">整体hover 红色</p>
<p class="group-hover:text-green-500">整体hover 绿色</p>
</div>
```
## Focus
当要给元素设置「聚焦态」样式时,类名添加 `focus:` 前缀。
```html
<button
class="Button
text-blue-500
focus:border-dark
focus:text-red-500"
>
蓝色按钮,focus 红色
</button>
```
## Active
当要给元素设置「选中态」样式时,类名添加 `active:` 前缀。
```html
<button
class="Button
text-blue-500
active:border-dark
active:text-red-500
is-active"
>
蓝色按钮,active 红色
</button>
```
## Disabled
当要给元素设置「禁用态」样式时,类名添加 `disabled:` 前缀。
```html
<button
disabled
class="Button
text-blue-500
disabled:border-dark
disabled:text-red-500"
>
蓝色按钮,disabled 红色
</button>
```
## 结合响应式设计一起?
那就先加「设备前缀」,再加「状态前缀」。如:`pc:hover:bg-pink-500`、`m:hover:bg-blue-500`
```html
<button
class="Button
rounded-xl text-light
pc:bg-pink-400 pc:border-pink-600
pc:hover:bg-pink-500 pc:hover:border-pink-800
m:bg-blue-400 m:border-blue-600
m:hover:bg-blue-500 m:hover:border-blue-800
"
>
按钮示例
</button>
```