2020-07-28 14:55:49 +08:00
|
|
|
|
---
|
2020-07-28 18:23:02 +08:00
|
|
|
|
title: 介绍
|
2020-07-31 15:35:17 +08:00
|
|
|
|
description: 介绍
|
2020-07-28 14:55:49 +08:00
|
|
|
|
type: 0
|
|
|
|
|
group: 💡 概念
|
2020-07-28 18:23:02 +08:00
|
|
|
|
menuName: 介绍
|
2020-07-28 14:55:49 +08:00
|
|
|
|
icon:
|
|
|
|
|
order: 8
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 什么是 amis
|
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
amis 是一个低代码前端框架,它使用 JSON 配置来生成页面,可以减少页面开发工作量,极大提升效率。
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
## 为什么要做 amis?
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
在经历了十几年的发展后,前端开发变得越来越复杂,门槛也越来越高,要使用当下流行的 UI 组件库,你必须懂 `npm`、`webpack`、`react/vue`,必须熟悉 `ES6` 语法,最好还了解状态管理,比如 `Redux`,如果没接触过函数式编程,光入门都很费劲,而入门之后会发现它还有巨大的 [生态](https://github.com/markerikson/redux-ecosystem-links),相关的库有 **2347** 个,很多功能相似,挑选成本高。
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
然而前端技术的发展不会停滞,等学完这些后可能会发现大家都用 `Hooks` 了、某个打包工具取代 `Webpack` 了……
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
而有时候其实只想做个普通的增删改查界面,用于信息管理,类似下面这种:
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2021-01-07 23:35:03 +08:00
|
|
|
|
```schema
|
2020-07-28 14:55:49 +08:00
|
|
|
|
{
|
|
|
|
|
"title": "浏览器内核对 CSS 的支持情况",
|
|
|
|
|
"remark": "嘿,不保证数据准确性",
|
|
|
|
|
"type": "page",
|
|
|
|
|
"body": {
|
|
|
|
|
"type": "crud",
|
|
|
|
|
"draggable": true,
|
2020-08-21 15:28:22 +08:00
|
|
|
|
"syncLocation": false,
|
2021-11-28 11:18:33 +08:00
|
|
|
|
"api": "/api/mock2/sample",
|
2020-07-28 14:55:49 +08:00
|
|
|
|
"keepItemSelectionOnPageChange": true,
|
2021-11-09 20:32:57 +08:00
|
|
|
|
"autoGenerateFilter": true,
|
2020-07-28 14:55:49 +08:00
|
|
|
|
"bulkActions": [
|
|
|
|
|
{
|
2020-09-16 23:41:51 +08:00
|
|
|
|
"type": "button",
|
2020-07-28 14:55:49 +08:00
|
|
|
|
"label": "批量删除",
|
|
|
|
|
"actionType": "ajax",
|
2021-11-28 11:18:33 +08:00
|
|
|
|
"api": "delete:/api/mock2/sample/${ids|raw}",
|
2020-07-28 14:55:49 +08:00
|
|
|
|
"confirmText": "确定要批量删除?"
|
|
|
|
|
},
|
|
|
|
|
{
|
2020-09-16 23:41:51 +08:00
|
|
|
|
"type": "button",
|
2020-07-28 14:55:49 +08:00
|
|
|
|
"label": "批量修改",
|
|
|
|
|
"actionType": "dialog",
|
|
|
|
|
"dialog": {
|
|
|
|
|
"title": "批量编辑",
|
|
|
|
|
"name": "sample-bulk-edit",
|
|
|
|
|
"body": {
|
|
|
|
|
"type": "form",
|
2021-11-28 11:18:33 +08:00
|
|
|
|
"api": "/api/mock2/sample/bulkUpdate2",
|
2021-06-07 10:09:55 +08:00
|
|
|
|
"body": [
|
2020-07-28 14:55:49 +08:00
|
|
|
|
{
|
|
|
|
|
"type": "hidden",
|
|
|
|
|
"name": "ids"
|
|
|
|
|
},
|
|
|
|
|
{
|
2021-06-07 10:09:55 +08:00
|
|
|
|
"type": "input-text",
|
2020-07-28 14:55:49 +08:00
|
|
|
|
"name": "engine",
|
|
|
|
|
"label": "Engine"
|
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
],
|
2021-11-28 11:18:33 +08:00
|
|
|
|
"quickSaveApi": "/api/mock2/sample/bulkUpdate",
|
|
|
|
|
"quickSaveItemApi": "/api/mock2/sample/$id",
|
2020-07-28 14:55:49 +08:00
|
|
|
|
"headerToolbar": [
|
|
|
|
|
"bulkActions",
|
2020-08-18 19:06:41 +08:00
|
|
|
|
{
|
2020-09-16 23:41:51 +08:00
|
|
|
|
"type": "button",
|
2020-08-18 19:06:41 +08:00
|
|
|
|
"label": "重置测试数据",
|
|
|
|
|
"actionType": "ajax",
|
|
|
|
|
"size": "sm",
|
2021-11-28 11:18:33 +08:00
|
|
|
|
"api": "/api/mock2/sample/reset"
|
2020-08-18 19:06:41 +08:00
|
|
|
|
},
|
2020-12-22 15:31:57 +08:00
|
|
|
|
"export-excel",
|
2020-07-28 14:55:49 +08:00
|
|
|
|
{
|
|
|
|
|
"type": "tpl",
|
|
|
|
|
"tpl": "一共有 ${count} 行数据。",
|
|
|
|
|
"className": "v-middle"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "columns-toggler",
|
2021-11-09 20:32:57 +08:00
|
|
|
|
"align": "right",
|
|
|
|
|
"draggable": true
|
2020-07-28 14:55:49 +08:00
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "drag-toggler",
|
|
|
|
|
"align": "right"
|
|
|
|
|
}
|
|
|
|
|
],
|
|
|
|
|
"footerToolbar": ["statistics", "switch-per-page", "pagination"],
|
|
|
|
|
"columns": [
|
|
|
|
|
{
|
|
|
|
|
"name": "id",
|
|
|
|
|
"label": "ID",
|
|
|
|
|
"width": 20,
|
|
|
|
|
"sortable": true,
|
2021-11-09 20:32:57 +08:00
|
|
|
|
"type": "text",
|
|
|
|
|
"searchable": {
|
|
|
|
|
"type": "input-text",
|
|
|
|
|
"name": "id",
|
|
|
|
|
"label": "主键",
|
|
|
|
|
"placeholder": "输入id"
|
|
|
|
|
}
|
2020-07-28 14:55:49 +08:00
|
|
|
|
},
|
|
|
|
|
{
|
2021-11-09 20:32:57 +08:00
|
|
|
|
"name": "browser",
|
|
|
|
|
"label": "Browser",
|
|
|
|
|
"searchable": {
|
|
|
|
|
"type": "select",
|
|
|
|
|
"name": "browser",
|
|
|
|
|
"label": "浏览器",
|
|
|
|
|
"placeholder": "选择浏览器",
|
|
|
|
|
"options": [
|
|
|
|
|
{
|
|
|
|
|
"label": "Internet Explorer ",
|
|
|
|
|
"value": "ie"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"label": "AOL browser",
|
|
|
|
|
"value": "aol"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"label": "Firefox",
|
|
|
|
|
"value": "firefox"
|
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|
2020-07-28 14:55:49 +08:00
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "platform",
|
2020-12-22 15:31:57 +08:00
|
|
|
|
"label": "平台",
|
2020-07-28 14:55:49 +08:00
|
|
|
|
"popOver": {
|
2021-06-07 10:09:55 +08:00
|
|
|
|
"trigger": "hover",
|
2020-07-28 14:55:49 +08:00
|
|
|
|
"body": {
|
|
|
|
|
"type": "tpl",
|
|
|
|
|
"tpl": "就是为了演示有个叫 popOver 的功能"
|
|
|
|
|
}
|
|
|
|
|
},
|
|
|
|
|
"sortable": true,
|
|
|
|
|
"type": "text"
|
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "grade",
|
2020-12-22 15:31:57 +08:00
|
|
|
|
"label": "CSS 等级",
|
2021-06-07 10:09:55 +08:00
|
|
|
|
"type": "select",
|
|
|
|
|
"options": ["A", "B", "C", "D", "X"]
|
2020-07-28 14:55:49 +08:00
|
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"type": "operation",
|
|
|
|
|
"label": "操作",
|
|
|
|
|
"width": 100,
|
|
|
|
|
"buttons": [
|
|
|
|
|
{
|
|
|
|
|
"type": "button",
|
|
|
|
|
"actionType": "ajax",
|
2021-04-09 09:17:50 +08:00
|
|
|
|
"label": "删除",
|
2020-07-28 14:55:49 +08:00
|
|
|
|
"confirmText": "您确认要删除?",
|
2021-11-28 11:18:33 +08:00
|
|
|
|
"api": "delete:/api/mock2/sample/$id"
|
2020-07-28 14:55:49 +08:00
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
2020-12-22 15:31:57 +08:00
|
|
|
|
这个界面虽然用 `Bootstrap` 及各种前端 UI 库也能做出个大概,但仔细观察会发现它有大量细节功能,比如:
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-12-22 15:31:57 +08:00
|
|
|
|
- 可以对数据做筛选
|
|
|
|
|
- 有按钮可以刷新数据
|
2020-07-28 14:55:49 +08:00
|
|
|
|
- 编辑单行数据
|
2020-08-24 14:27:13 +08:00
|
|
|
|
- 批量修改和删除
|
2020-07-28 14:55:49 +08:00
|
|
|
|
- 按某列排序
|
2021-11-09 20:32:57 +08:00
|
|
|
|
- 可以隐藏某些列
|
|
|
|
|
- 可以调整列顺序
|
|
|
|
|
- 自动生成顶部查询区域
|
|
|
|
|
- 可调整列宽度
|
2020-07-28 14:55:49 +08:00
|
|
|
|
- 开启整页内容拖拽排序
|
2020-12-22 15:31:57 +08:00
|
|
|
|
- 表格有分页(页数还能同步到地址栏,不过这个例子中关了)
|
|
|
|
|
- 有数据汇总
|
|
|
|
|
- 支持导出 Excel
|
|
|
|
|
- 「渲染引擎」那列的表头有提示文字
|
|
|
|
|
- 鼠标移动到「平台」那列的内容时还有放大镜符号,可以展开查看更多
|
|
|
|
|
- 如果往下拖动还有首行冻结来方便查看表头(因为文档页面的限制,这个功能在这里看不出来)
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-08-24 14:27:13 +08:00
|
|
|
|
全部实现这些需要大量的代码。
|
|
|
|
|
|
2020-12-22 15:31:57 +08:00
|
|
|
|
但可以看到,用 amis 只需要 **157** 行 JSON 配置(其中 47 行只有一个括号),你不需要了解 `React/Vue`、`Webpack`,甚至不需要很了解 `JavaScript`,即便没学过 amis 也能猜到大部分配置的作用,只需要简单配置就能完成所有页面开发。
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2021-01-04 20:10:08 +08:00
|
|
|
|
这正是建立 amis 的初衷,我们认为:**对于大部分常用页面,应该使用最简单的方法来实现**,甚至不需要学习前端框架和工具。
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
## 用 JSON 写页面有什么好处
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
为了实现用最简单方式来生成大部分页面,amis 的解决方案是基于 [JSON](https://baike.baidu.com/item/JSON) 来配置,它的独特好处是:
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
- **不需要懂前端**:在百度内部,大部分 amis 用户之前从来没写过前端页面,也不会 `JavaScript`,却能做出专业且复杂的后台界面,这是所有其他前端 UI 库都无法做到的;
|
2021-11-12 15:22:54 +08:00
|
|
|
|
- **不受前端技术更新的影响**:百度内部最老的 amis 页面是 6 年多前创建的,至今还在使用,而当年的 `Angular/Vue/React` 版本现在都废弃了,当年流行的 `Gulp` 也被 `Webpack` 取代了,如果这些页面不是用 amis,现在的维护成本会很高;
|
2020-09-07 14:14:34 +08:00
|
|
|
|
- **享受 amis 的不断升级**:amis 一直在提升细节交互体验,比如表格首行冻结、下拉框大数据下不卡顿等,之前的 JSON 配置完全不需要修改;
|
2021-01-29 19:35:15 +08:00
|
|
|
|
- 可以 **完全** 使用 [可视化页面编辑器](https://aisuda.github.io/amis-editor-demo/) 来制作页面:一般前端可视化编辑器只能用来做静态原型,而 amis 可视化编辑器做出的页面是可以直接上线的。
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
## amis 的其它亮点
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:16:10 +08:00
|
|
|
|
- **提供完整的界面解决方案**:其它 UI 框架必须使用 JavaScript 来组装业务逻辑,而 amis 只需 JSON 配置就能完成完整功能开发,包括数据获取、表单提交及验证等功能,做出来的页面不需要经过二次开发就能直接上线;
|
2021-11-12 15:22:54 +08:00
|
|
|
|
- **大量内置组件(120+),一站式解决**:其它 UI 框架大部分都只有最通用的组件,如果遇到一些稍微不常用的组件就得自己找第三方,而这些第三方组件往往在展现和交互上不一致,整合起来效果不好,而 amis 则内置大量组件,包括了富文本编辑器、代码编辑器、diff、条件组合、实时日志等业务组件,绝大部分中后台页面开发只需要了解 amis 就足够了;
|
2021-03-01 08:54:09 +08:00
|
|
|
|
- **支持扩展**:除了低代码模式,还可以通过 [自定义组件](./extend/internal) 来扩充组件,实际上 amis 可以当成普通 UI 库来使用,实现 90% 低代码,10% 代码开发的混合模式,既提升了效率,又不失灵活性;
|
2021-02-18 22:40:34 +08:00
|
|
|
|
- **容器支持无限级嵌套**:可以通过嵌套来满足各种布局及展现需求;
|
2021-11-12 15:22:54 +08:00
|
|
|
|
- **经历了长时间的实战考验**:amis 在百度内部得到了广泛使用,**在 6 年多的时间里创建了 5 万页面**,从内容审核到机器管理,从数据分析到模型训练,amis 满足了各种各样的页面需求,最复杂的页面有超过 1 万行 JSON 配置。
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
## amis 不适合做什么?
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
|
|
|
|
使用 JSON 有优点但也有明显缺点,在以下场合并不适合 amis:
|
|
|
|
|
|
2020-08-24 14:27:13 +08:00
|
|
|
|
- **大量定制 UI**:JSON 配置使得 amis 更适合做有大量常见 UI 组件的页面,但对于面向普通客户(toC)的页面,往往追求个性化的视觉效果,这种情况下用 amis 就不合适,实际上绝大部分前端 UI 组件库也都不适合,只能定制开发。
|
|
|
|
|
- **极为复杂或特殊的交互**:
|
|
|
|
|
- 有些复杂的前端功能,比如 可视化编辑器,其中有大量定制的拖拽操作,这种需要依赖原生 DOM 实现的功能无法使用 amis。
|
2020-07-28 14:55:49 +08:00
|
|
|
|
- 但对于某些交互固定的领域,比如图连线,amis 后续会有专门的组件来实现。
|
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
## 阅读建议
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2021-01-04 20:10:08 +08:00
|
|
|
|
- 如果你是第一次接触 amis,那么请 **务必认真阅读完概念部分**,它会让你对 amis 有个整体的认识
|
2021-02-02 12:45:53 +08:00
|
|
|
|
- 如果你已经掌握 amis 基本概念,且有一定的开发经验,需要参考 amis 组件相关文档的同学,那么请移步 [组件文档](../components/page)
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-09-07 14:14:34 +08:00
|
|
|
|
## 让我们马上开始吧
|
2020-07-28 14:55:49 +08:00
|
|
|
|
|
2020-08-24 14:27:13 +08:00
|
|
|
|
点击页面底部的下一篇,继续阅读文档。
|