Spinner 加载中

一般用来做 loading 使用。

基本使用

show 属性控制 spinner 是否渲染。

  1. {
  2. "type": "page",
  3. "body": {
  4. "type": "spinner",
  5. "show": true,
  6. }
  7. }

size 属性控制 spinner 的大小,有三种配置:sm, lg 和 空值。

  1. {
  2. "type": "page",
  3. "body": [
  4. {
  5. "type": "spinner",
  6. "show": true,
  7. "size": "sm",
  8. "className": "mr-4"
  9. },
  10. {
  11. "type": "spinner",
  12. "show": true,
  13. "size": "",
  14. "className": "mr-4"
  15. },
  16. {
  17. "type": "spinner",
  18. "show": true,
  19. "size": "lg"
  20. }
  21. ]
  22. }

className 属性、 spinnerClassName属性和 spinnerWrapClassName属性可以配置 spinner 自定义的 class,className会添加到 spinner 组件的最外层标签上,spinnerClassName会添加到 icon 对应的标签上,spinnerWrapClassName 在作为组件容器使用时,会作用于整个 Spinner 组件的最外层元素上。

  1. {
  2. "type": "page",
  3. "body": [
  4. {
  5. "type": "spinner",
  6. "show": true,
  7. "className": "my-spinner",
  8. "spinnerClassName": "my-spinner-custom-icon",
  9. "spinnerWrapClassName": "my-spinner-wrap",
  10. }
  11. ]
  12. }

icon 属性可以配置自定义的图标,可以是 amis 内置的图标名称(需要是在 icons.tsx 组件中注册过的); 可以是字体图标库的名称(需要引入对应的图标库),比如fa fa-spinner; 也可以是网络图片,比如 /examples/static/logo.png;

  1. {
  2. "type": "page",
  3. "body": [
  4. {
  5. "type": "spinner",
  6. "show": true,
  7. "icon": "",
  8. "className": "mr-4"
  9. },
  10. {
  11. "type": "spinner",
  12. "show": true,
  13. "icon": "reload",
  14. "className": "mr-4"
  15. },
  16. {
  17. "type": "spinner",
  18. "show": true,
  19. "icon": "fa fa-spinner",
  20. "className": "mr-4"
  21. },
  22. {
  23. "type": "spinner",
  24. "show": true,
  25. "icon": "/examples/static/logo.png"
  26. }
  27. ]
  28. }

tip 属性可以配置 spinner 的文案,同时 tipPlacement可以配置 tip 的相对于 icon 的位置,有四种配置:top,right,bottom(默认),left;

  1. {
  2. "type": "page",
  3. "body": [
  4. {
  5. "type": "spinner",
  6. "show": true,
  7. "tip": "加载中...",
  8. "className": "mr-10"
  9. },
  10. {
  11. "type": "spinner",
  12. "show": true,
  13. "tip": "加载中...",
  14. "tipPlacement": "right",
  15. "className": "mr-10"
  16. },
  17. {
  18. "type": "spinner",
  19. "show": true,
  20. "tip": "加载中...",
  21. "tipPlacement": "top",
  22. "className": "mr-10"
  23. },
  24. {
  25. "type": "spinner",
  26. "show": true,
  27. "tip": "加载中...",
  28. "tipPlacement": "left"
  29. }
  30. ]
  31. }

delay 属性可以配置 spinner 的延迟显示时间,例如 delay=1000,show 属性设为 true 后,1000ms 后才会显示出来。

  1. {
  2. "type": "page",
  3. "body": {
  4. "type": "spinner",
  5. "show": true,
  6. "delay": 1000
  7. }
  8. }

作为容器使用

spinner 组件可以作为容器使用,被包裹的内容可通过 body 配置, 且作为容器使用的时候可以使用 overlay 属性来配置显示 spinner 的时候是否显示遮罩层(遮罩层背景颜色默认是透明的,可通过外层 className 自定义遮罩层颜色)。

  1. {
  2. "type": "page",
  3. "body": {
  4. "type": "spinner",
  5. "show": true,
  6. "overlay": true,
  7. "body": {
  8. "type": "form",
  9. "body": [
  10. {
  11. "type": "input-text",
  12. "name": "name",
  13. "label": "姓名:"
  14. },
  15. {
  16. "name": "email",
  17. "type": "input-email",
  18. "label": "邮箱:"
  19. }
  20. ]
  21. }
  22. }
  23. }

属性表

属性名 类型 默认值 说明
type string spinner 指定为 Spinner 渲染器
show boolean true 是否显示 spinner 组件
className string spinner 图标父级标签的自定义 class
spinnerClassName string 组件中 icon 所在标签的自定义 class
spinnerWrapClassName string 作为容器使用时组件最外层标签的自定义 class
size string 组件大小 sm lg
icon string 组件图标,可以是amis内置图标,也可以是字体图标或者网络图片链接,作为 ui 库使用时也可以是自定义组件
tip string 配置组件文案,例如加载中...
tipPlacement top, right, bottom, left bottom 配置组件 tip 相对于 icon 的位置
delay number 0 配置组件显示延迟的时间(毫秒)
overlay boolean true 配置组件显示 spinner 时是否显示遮罩层
body SchemaNode 作为容器使用时,被包裹的内容