amis2/docs/zh-CN/index.md

229 lines
9.0 KiB
Markdown
Raw Normal View History

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
```schema:height="900"
{
"title": "浏览器内核对 CSS 的支持情况",
"remark": "嘿,不保证数据准确性",
"type": "page",
"body": {
"type": "crud",
"draggable": true,
2020-08-21 15:28:22 +08:00
"syncLocation": false,
2020-07-28 14:55:49 +08:00
"api": "https://houtai.baidu.com/api/sample",
"keepItemSelectionOnPageChange": true,
"filter": {
"title": "筛选",
"submitText": "",
"controls": [
{
"type": "text",
"name": "keywords",
"placeholder": "关键字",
"addOn": {
"label": "搜索",
"type": "submit"
}
}
]
},
"bulkActions": [
{
2020-09-16 23:41:51 +08:00
"type": "button",
2020-07-28 14:55:49 +08:00
"label": "批量删除",
"actionType": "ajax",
"api": "delete:https://houtai.baidu.com/api/sample/${ids|raw}",
"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",
"api": "https://houtai.baidu.com/api/sample/bulkUpdate2",
"controls": [
{
"type": "hidden",
"name": "ids"
},
{
"type": "text",
"name": "engine",
"label": "Engine"
}
]
}
}
}
],
"quickSaveApi": "https://houtai.baidu.com/api/sample/bulkUpdate",
"quickSaveItemApi": "https://houtai.baidu.com/api/sample/$id",
"filterTogglable": true,
"headerToolbar": [
"filter-toggler",
"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",
"api": "https://houtai.baidu.com/api/sample/reset"
},
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",
"align": "right"
},
{
"type": "drag-toggler",
"align": "right"
},
{
"type": "pagination",
"align": "right"
}
],
"footerToolbar": ["statistics", "switch-per-page", "pagination"],
"columns": [
{
"name": "id",
"label": "ID",
"width": 20,
"sortable": true,
"type": "text"
},
{
"name": "engine",
2020-12-22 15:31:57 +08:00
"label": "渲染引擎",
2020-07-28 14:55:49 +08:00
"sortable": true,
"searchable": true,
"type": "text",
"remark": "Trident 就是 IEGecko 就是 Firefox"
},
{
"name": "platform",
2020-12-22 15:31:57 +08:00
"label": "平台",
2020-07-28 14:55:49 +08:00
"popOver": {
"body": {
"type": "tpl",
"tpl": "就是为了演示有个叫 popOver 的功能"
}
},
"sortable": true,
"type": "text"
},
{
"name": "grade",
2020-12-22 15:31:57 +08:00
"label": "CSS 等级",
2020-07-28 14:55:49 +08:00
"quickEdit": {
"mode": "inline",
"type": "select",
"options": ["A", "B", "C", "D", "X"]
},
"type": "text"
},
{
"type": "operation",
"label": "操作",
"width": 100,
"buttons": [
{
"type": "button",
"icon": "fa fa-times text-danger",
"actionType": "ajax",
"tooltip": "删除",
"confirmText": "您确认要删除?",
"api": "delete:https://houtai.baidu.com/api/sample/$id"
}
]
}
]
}
}
```
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
- 查询某列
- 按某列排序
- 隐藏某列
- 开启整页内容拖拽排序
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
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
## 用 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 库都无法做到的;
- **不受前端技术更新的影响**:百度内部最老的 amis 页面是 4 年多前创建的,至今还在使用,而当年的 `Angular/Vue/React` 版本现在都废弃了,当年流行的 `Gulp` 也被 `Webpack` 取代了,如果这些页面不是用 amis现在的维护成本会很高
- **享受 amis 的不断升级**amis 一直在提升细节交互体验,比如表格首行冻结、下拉框大数据下不卡顿等,之前的 JSON 配置完全不需要修改;
2020-07-28 14:55:49 +08:00
- 可以 **完全** 使用 [可视化页面编辑器](https://fex-team.github.io/amis-editor/#/edit/0) 来制作页面:一般前端可视化编辑器只能用来做静态原型,而 amis 可视化编辑器做出的页面是可以直接上线的。
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 配置就能完成完整功能开发,包括数据获取、表单提交及验证等功能,做出来的页面不需要经过二次开发就能直接上线;
2020-09-07 14:14:34 +08:00
- **内置 100+ 种 UI 组件**:包括其它 UI 框架都不会提供的富文本编辑器、条件组合等,能满足各种页面组件展现的需求,而且对于特殊的展现形式还可以通过 [自定义组件](./start/custom.md) 来扩充;
2020-07-28 14:55:49 +08:00
- **容器支持无限级嵌套**:可以通过组合来满足各种布局需求;
2020-09-07 14:14:34 +08:00
- **经历了长时间的实战考验**amis 在百度内部得到了广泛使用,**在 4 年多的时间里创建了 3 万+ 页面**从内容审核到机器管理从数据分析到模型训练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
- 如果你是第一次接触 amis 的新同学,那么请 **务必认真阅读完概念部分**,它会让你对 amis 有个整体的认识
- 如果你已经掌握 amis 基本概念,且有一定的开发经验,需要参考 amis 组件相关文档的同学,那么请移步 [组件文档](./components/component)
2020-09-07 14:14:34 +08:00
## 让我们马上开始吧
2020-07-28 14:55:49 +08:00
2020-08-24 14:27:13 +08:00
点击页面底部的下一篇,继续阅读文档。