diff --git a/src/action-sheet/README.zh-CN.md b/src/action-sheet/README.zh-CN.md index a52cbc018..0cfa0097f 100644 --- a/src/action-sheet/README.zh-CN.md +++ b/src/action-sheet/README.zh-CN.md @@ -118,13 +118,6 @@ export default { ``` -## 常见问题 - -### 引入时提示 dependencies not found？ - -在 1.x 版本中，上拉菜单的组件名为`Actionsheet`，从 2.0 版本开始更名为`ActionSheet`，请注意区分。 - - ## API ### Props @@ -169,3 +162,9 @@ export default { | className | 为对应列添加额外的 class | *any* | | loading | 是否为加载状态 | *boolean* | | disabled | 是否为禁用状态 | *boolean* | + +## 常见问题 + +### 引入时提示 dependencies not found？ + +在 1.x 版本中，上拉菜单的组件名为`Actionsheet`，从 2.0 版本开始更名为`ActionSheet`，请注意区分。 diff --git a/src/datetime-picker/README.zh-CN.md b/src/datetime-picker/README.zh-CN.md index a1e009385..9a2f7f34d 100644 --- a/src/datetime-picker/README.zh-CN.md +++ b/src/datetime-picker/README.zh-CN.md @@ -147,15 +147,6 @@ export default { } ``` -## 常见问题 - -### 设置 min-date 或 max-date 后出现页面卡死的情况？ - -请注意不要在模板中直接使用类似`min-date="new Date()"`的写法，这样会导致每次渲染组件时传入一个新的 Date 对象，而传入新的数据会触发下一次渲染，从而陷入死循环。 - -正确的做法是将`min-date`作为一个数据定义在`data`函数中。 - - ## API ### Props @@ -199,3 +190,17 @@ export default { | setColumnValues(index, values) | 设置对应列中所有的备选值 | | getValues() | 获取所有列中被选中的值，返回一个数组 | | setValues(values) | `values`为一个数组，设置所有列中被选中的值 | + +## 常见问题 + +### 设置 min-date 或 max-date 后出现页面卡死的情况？ + +请注意不要在模板中直接使用类似`min-date="new Date()"`的写法，这样会导致每次渲染组件时传入一个新的 Date 对象，而传入新的数据会触发下一次渲染，从而陷入死循环。 + +正确的做法是将`min-date`作为一个数据定义在`data`函数中。 + +### 在 iOS 系统上初始化组件失败？ + +如果你遇到了在 iOS 上无法渲染组件的问题，请确认在创建 Date 对象时没有使用`new Date('2020-01-01')`这样的写法，iOS 不支持以中划线分隔的日期格式，正确写法是`new Date('2020/01/01')`。 + +对此问题的详细解释：[stackoverflow](https://stackoverflow.com/questions/13363673/javascript-date-is-invalid-on-ios)。 diff --git a/src/list/README.zh-CN.md b/src/list/README.zh-CN.md index 2dd9d33ce..21d0accb6 100644 --- a/src/list/README.zh-CN.md +++ b/src/list/README.zh-CN.md @@ -103,35 +103,6 @@ export default { } ``` -## 常见问题 - -### List 的运行机制是什么？ - -List 会监听浏览器的滚动事件并计算列表的位置，当列表底部与可视区域的距离小于`offset`时，List 会触发一次 load 事件。 - -### 为什么 List 初始化后会立即触发 load 事件？ - -List 初始化后会触发一次 load 事件，用于加载第一屏的数据，这个特性可以通过`immediate-check`属性关闭。 - -### 为什么会连续触发 load 事件？ - -如果一次请求加载的数据条数较少，导致列表内容无法铺满当前屏幕，List 会继续触发 load 事件，直到内容铺满屏幕或数据全部加载完成。因此你需要调整每次获取的数据条数，理想情况下每次请求获取的数据条数应能够填满一屏高度。 - -### loading 和 finished 分别是什么含义？ - -`List`有以下三种状态，理解这些状态有助于你正确地使用`List`组件： - -- 非加载中，`loading`为`false`，此时会根据列表滚动位置判断是否触发`load`事件（列表内容不足一屏幕时，会直接触发） -- 加载中，`loading`为`true`，表示正在发送异步请求，此时不会触发`load`事件 -- 加载完成，`finished`为`true`，此时不会触发`load`事件 - -在每次请求完毕后，需要手动将`loading`设置为`false`，表示加载结束 - -### 使用 float 布局后一直触发加载？ - -若 List 的内容使用了 float 布局，可以在容器上添加`van-clearfix`类名来清除浮动，使得 List 能正确判断元素位置 - - ## API ### Props @@ -168,3 +139,31 @@ List 初始化后会触发一次 load 事件，用于加载第一屏的数据， |------|------| | default | 列表内容 | | loading | 自定义底部加载中提示 | + +## 常见问题 + +### List 的运行机制是什么？ + +List 会监听浏览器的滚动事件并计算列表的位置，当列表底部与可视区域的距离小于`offset`时，List 会触发一次 load 事件。 + +### 为什么 List 初始化后会立即触发 load 事件？ + +List 初始化后会触发一次 load 事件，用于加载第一屏的数据，这个特性可以通过`immediate-check`属性关闭。 + +### 为什么会连续触发 load 事件？ + +如果一次请求加载的数据条数较少，导致列表内容无法铺满当前屏幕，List 会继续触发 load 事件，直到内容铺满屏幕或数据全部加载完成。因此你需要调整每次获取的数据条数，理想情况下每次请求获取的数据条数应能够填满一屏高度。 + +### loading 和 finished 分别是什么含义？ + +`List`有以下三种状态，理解这些状态有助于你正确地使用`List`组件： + +- 非加载中，`loading`为`false`，此时会根据列表滚动位置判断是否触发`load`事件（列表内容不足一屏幕时，会直接触发） +- 加载中，`loading`为`true`，表示正在发送异步请求，此时不会触发`load`事件 +- 加载完成，`finished`为`true`，此时不会触发`load`事件 + +在每次请求完毕后，需要手动将`loading`设置为`false`，表示加载结束 + +### 使用 float 布局后一直触发加载？ + +若 List 的内容使用了 float 布局，可以在容器上添加`van-clearfix`类名来清除浮动，使得 List 能正确判断元素位置