docs(DatetimePicker): add tips of iOS date (#4839)

This commit is contained in:
neverland 2019-10-25 17:31:25 +08:00 committed by GitHub
parent d5c8647ecf
commit 3cef79a2eb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 48 additions and 45 deletions

View File

@ -118,13 +118,6 @@ export default {
</van-action-sheet>
```
## 常见问题
### 引入时提示 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`,请注意区分。

View File

@ -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)。

View File

@ -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 能正确判断元素位置