文档中写入 1.2.0 的变更 (#2058)

This commit is contained in:
吴多益 2021-06-04 17:45:30 +08:00 committed by GitHub
parent a823ff29b5
commit d1a4cad499
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 60 additions and 0 deletions

52
docs/zh-CN/start/1-2-0.md Normal file
View File

@ -0,0 +1,52 @@
# 1.2.0 版本变更
在 1.2.0 之前的版本中,表单项和非表单项在配置上不一致,名称重名也带来了很多困惑,系统实现也得分两份带来了维护成本,因此 1.2.0 对配置项做了调整,使得配置写法统一,表单项和非表单项也能混用了。
1.2.0 版本向下兼容之前的配置,但推荐使用新的配置方式。
具体改动如下:
- Form 下新增 body 容器controls 容器可用但是不推荐继续使用。
- 部分表单项改名,改名后不限制只能放在 form 下,比如表格中可以直接放 input-text。具体改动如下
- `text` => `input-text`
- `url` => `input-url`
- `email` => `input-email`
- `number` => `input-number`
- `array` => `input-array`
- `button-group` => `button-group-select`
- `city` => `input-city`
- `color` => `input-color`
- `date` => `input-date`
- `datetime` => `input-datetime`
- `time` => `input-time`
- `quarter` => `input-quarter`
- `month` => `input-month`
- `year` => `input-year`
- `date-range` => `input-date-range`
- `datetime-range` => `input-datetime-range`
- `diff` => `diff-editor`
- `image` => `input-image`
- `file` => `input-file`
- `list` => `list-select`
- `location` => `location-picker`
- `matrix` => `matrix-checkboxes`
- `month-range` => `input-month-range`
- `range` => `input-range`
- `rating` => `input-rating`
- `repeat` => `input-repeat`
- `rich-text` => `input-rich-text`
- `form` => `input-sub-form`
- `table` => `input-table`
- `tag` => `input-tag`
- `password` => `input-password`
- `tree` => `input-tree`
- 改名后不存在渲染器重名冲突问题,所以表单项容器组件不再区分 body 还是 controls 了,原来的设定是如果是要放表当项就放在 controls 里面,否则放 body 下,这次改动后,直接放 body 下即可,而且可以表单项和非表单项组合使用。
- 注册渲染器可直接通过 type 来,而不是需要写个正则来命中路径。
- combo 原有 controls 改名叫 items也不限制只能放表单项了可以表单项和非表单项组合使用。原有 controls 用法保持功能不变。
- combo 多条件分支中的 controls 也改名成了 items
- 表单项容器组件全部删除ContainerGrid, Hbox, Panel, Service, Tabs保持一份代码。
下载方法:
1. npm使用 `npm i amis@1.2.0-beta.1`
2. sdk通过 https://github.com/baidu/amis/blob/gh-pages/sdk.tar.gz 下载最新版本

View File

@ -23,6 +23,14 @@ export default [
)
},
{
label: '1.2.0 版本变更',
path: '/zh-CN/docs/start/1-2-0',
getComponent: () =>
// @ts-ignore
import('../../docs/zh-CN/start/1-2-0.md').then(makeMarkdownRenderer)
},
{
label: '常见问题',
path: '/zh-CN/docs/start/faq',