mirror of
https://gitee.com/baidu/amis.git
synced 2024-11-29 18:48:45 +08:00
161 lines
4.1 KiB
Markdown
161 lines
4.1 KiB
Markdown
---
|
||
title: 将 amis 当成 UI 库用
|
||
---
|
||
|
||
amis 不仅有纯配置的用法，还能当成 UI 库来使用，实现 90% 低代码，10% 代码开发的混合模式，在灵活性上。
|
||
|
||
> 需要注意以下都需要在配置中写函数，因此不再是纯粹的 JSON，所以暂时不能在可视化编辑器的「代码」模式下使用
|
||
> 从 1.3.0 开始按钮的 onClick 支持字符串格式，因此可以在可视化编辑器中使用
|
||
|
||
## 事件监听
|
||
|
||
amis 提供了一些交互配置，但有时候这些交互无法满足需求，这时我们可以监听这些事件，然后用代码实现复杂交互需求，比如最常见的是表单事件。
|
||
|
||
```javascript
|
||
let amisJSON = {
|
||
type: 'page',
|
||
title: '表单页面',
|
||
body: [
|
||
{
|
||
type: 'form',
|
||
mode: 'horizontal',
|
||
onFinished: values => {
|
||
console.log('form', values);
|
||
return false; // 这样可以禁掉 amis 后续的默认行为
|
||
},
|
||
body: [
|
||
{
|
||
label: 'Name',
|
||
type: 'input-text',
|
||
name: 'name',
|
||
onChange: value => {
|
||
console.log('Name', value);
|
||
}
|
||
},
|
||
{
|
||
type: 'button',
|
||
label: '按钮修改',
|
||
onClick: (e, props) => {
|
||
console.log('消息通知');
|
||
props.formStore.setValues({name: 'amis'});
|
||
}
|
||
}
|
||
]
|
||
}
|
||
]
|
||
};
|
||
```
|
||
|
||
这个例子中我们监听了 3 个事件，输入框数据变化、表单提交、按钮点击，然后在这些地方使用代码实现特殊功能。
|
||
|
||
## 监听广播事件
|
||
|
||
> 3.0.0 以后引入
|
||
|
||
amis 从 1.7.0 版本开始支持了[事件动作](../concepts/event-action)，各个组件内部也陆续补充了很多事件（可以查看每个组件文档的最底下，有事件表说明）。像这类事件也是可以监听的，分为两步来实现：第一步监听组件事件做广播动作、第二步最外层监听广播事件写业务逻辑。
|
||
|
||
配置 form 事件动作，当表单提交成功后，广播一个 `formSubmited` 事件。
|
||
|
||
```js
|
||
let amisJSON = {
|
||
type: 'page',
|
||
title: '表单页面',
|
||
body: [
|
||
{
|
||
type: 'form',
|
||
mode: 'horizontal',
|
||
onEvent: {
|
||
submitSucc: {
|
||
actions: [
|
||
{
|
||
actionType: 'broadcast',
|
||
args: {
|
||
eventName: 'formSubmited'
|
||
}
|
||
}
|
||
]
|
||
}
|
||
},
|
||
body: [
|
||
{
|
||
label: 'Name',
|
||
type: 'input-text',
|
||
name: 'name'
|
||
},
|
||
{
|
||
type: 'submit',
|
||
label: 'Submit'
|
||
}
|
||
]
|
||
}
|
||
]
|
||
};
|
||
```
|
||
|
||
渲染 amis 的时候通过 `onBroadcast` 监听内部广播。
|
||
|
||
```tsx
|
||
import {render as renderAmis} from 'amis';
|
||
|
||
function DemoComponent() {
|
||
function handleBroadcast(type: string, rawEvent: any, data: any) {
|
||
console.log(type);
|
||
if (type === 'formSubmited') {
|
||
console.log('内部表单提交了');
|
||
}
|
||
}
|
||
|
||
return <div>
|
||
{renderAmis(amisJSON, {onBroadcast: handleBroadcast})}
|
||
</div>
|
||
};
|
||
```
|
||
|
||
## 使用 amis 公共方法
|
||
|
||
amis 对外还提供了一些方法，比如弹出消息通知，可以通过 `amisRequire('amis')` 获取到这些 amis 对外提供的方法。
|
||
|
||
```javascript
|
||
let amis = amisRequire('amis/embed');
|
||
let amisLib = amisRequire('amis');
|
||
let amisScoped = amis.embed('#root', {
|
||
type: 'page',
|
||
title: '表单页面',
|
||
body: {
|
||
type: 'form',
|
||
mode: 'horizontal',
|
||
api: '/saveForm',
|
||
body: [
|
||
{
|
||
type: 'button',
|
||
label: '按钮',
|
||
onClick: () => {
|
||
amisLib.toast.info('消息通知');
|
||
}
|
||
}
|
||
]
|
||
}
|
||
});
|
||
```
|
||
|
||
具体有哪些可以参考 [https://github.com/baidu/amis/blob/master/packages/amis/src/index.tsx](https://github.com/baidu/amis/blob/master/packages/amis/src/index.tsx)
|
||
|
||
## React 中引入 amis 的组件
|
||
|
||
在 React 环境下使用 amis，还可以直接引入 amis 内置组件，在 amis 项目源码 `src/components` 下的组件都是标准 React 组件，可以在项目中直接引用，这样就能将 amis 当成纯粹 UI 库来使用。
|
||
|
||
```jsx
|
||
import {Button} from 'amis-ui';
|
||
|
||
...
|
||
|
||
<Button
|
||
onClick={() => {}}
|
||
type="button"
|
||
level="link"
|
||
className="navbar-btn"
|
||
>
|
||
按钮
|
||
</Button>
|
||
```
|