mirror of
https://gitee.com/baidu/amis.git
synced 2024-12-15 17:31:18 +08:00
f936777b64
* feat: env 增加 replaceText 配置用于 schema 里的文本替换 * 优化一下，改成黑名单模式；并且对 key 进行排序避免前缀匹配问题 * 修复编译报错
102 lines
3.1 KiB
Markdown
102 lines
3.1 KiB
Markdown
---
|
||
title: 常见问题
|
||
---
|
||
|
||
## 如何水平垂直居中
|
||
|
||
1.1.5 版本之后可以使用 flex 布局，默认就是水平垂直居中。
|
||
|
||
## CRUD 顶部有重叠遮挡
|
||
|
||
在初始化 amis 渲染器的时候设置 `affixOffsetTop`，或者通过 `"affixHeader": false` 关闭固定顶部功能。
|
||
|
||
## 如何换行
|
||
|
||
有时候返回结果中有 `\n`，在页面展现的时候默认不会有换行效果，解决办法有 3 个：
|
||
|
||
1. 使用 tpl、html、plain 或 static 组件，加上 `"wrapperComponent": "pre"` 配置项
|
||
2. 引入 `helper.css`，给组件加上 `"classname": "white-space-pre"` 配置项（预计从 1.1.5 开始内置这个类，从而不需要引入 `helper.css`）
|
||
3. 包在 `container` 容器中，使用 `style` 控制样式
|
||
|
||
前两种方法比较简单，这里就只演示第三种，如果熟悉 css 可以很灵活实现各种展现控制：
|
||
|
||
```schema
|
||
{
|
||
"type": "page",
|
||
"data": {
|
||
"log": "line 1\nline 2"
|
||
},
|
||
"body": {
|
||
"type": "container",
|
||
"style": {
|
||
"white-space": "pre"
|
||
},
|
||
"body": {
|
||
"type": "tpl",
|
||
"tpl": "${log}"
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## 如何折行
|
||
|
||
折行需要给对应的组件加上 `"classname": "word-break"`。
|
||
|
||
## 如何实现左侧导航栏页面跳转？
|
||
|
||
在 1.1.1 之后的版本提供了新的 app 组件，可以基于它实现导航功能，请参考 `https://github.com/aisuda/amis-admin` 项目。
|
||
|
||
另外 amis 团队还开发了「[爱速搭](http://suda.baidu.com/)」，即便完全不懂前端也能基于它开发应用。
|
||
|
||
## 集成到 React 项目中报错
|
||
|
||
一般都是因为 React、Mobx、mobx-react 版本有关，参考 amis 项目的 [package.json](https://github.com/baidu/amis/blob/master/package.json)，将版本保持一致，尤其是 Mobx，目前 amis 中使用的版本是 4，因为兼容性的考虑短期内不会升级到 5/6，使用 MobX 5/6 肯定会报错。
|
||
|
||
## 有的功能在官网示例中能用，但在 React/SDK 中无法使用
|
||
|
||
如果提示找不到渲染器，那肯定是版本较老，尝试以下两种方法解决：
|
||
|
||
1. 使用最新 beta 版本，方法是去 [npm](https://www.npmjs.com/package/amis?activeTab=versions) 查看最新版本号，比如最新版本是 1.1.2-beta.2
|
||
，就运行运行 `npm i amis@1.1.2-beta.2` 命令，在 `node_modules/amis/sdk` 目录中也能找到对应的 sdk 代码。
|
||
2. 如果还是报错，可以使用最新代码自动编译的 sdk，下载地址是 `https://github.com/baidu/amis/blob/gh-pages/sdk.tar.gz`
|
||
|
||
## 如何支持配置中的 URL 地址替换？
|
||
|
||
> 1.5.0 及以上版本
|
||
|
||
有个常用场景是在开发时使用 `localhost` 地址，而线上使用 `xxx.com`，这时可以使用 `replaceText` 属性，它是第四个参数，也就是 env 参数
|
||
|
||
```javascript
|
||
let amis = amisRequire('amis/embed');
|
||
let amisJSON = {
|
||
type: 'page',
|
||
body: {
|
||
type: 'service',
|
||
api: 'HOST/api'
|
||
}
|
||
};
|
||
let amisScoped = amis.embed(
|
||
'#root',
|
||
amisJSON,
|
||
{},
|
||
{
|
||
replaceText: {
|
||
HOST: 'http://localhost'
|
||
}
|
||
}
|
||
);
|
||
```
|
||
|
||
## 如何更新全局 data？
|
||
|
||
使用下面的方式
|
||
|
||
```
|
||
amisScoped.updateProps({
|
||
data: {
|
||
xxx: 'yyy'
|
||
}
|
||
})
|
||
```
|