Skip to content

Commit

Permalink
doc: 完善日期跳转链接
Browse files Browse the repository at this point in the history
  • Loading branch information
@lqPrototype
lqPrototype committed Dec 5, 2024
1 parent 3f1ba2c commit ed65d3d
Show file tree
Hide file tree
Showing 5 changed files with 45 additions and 83 deletions.
35 changes: 0 additions & 35 deletions docs/zh-CN/components/form/input-date.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -270,41 +270,6 @@ order: 13
}
```

### 通过 props env moment 自定义控制

经常在表单遇到开始时间和结束时间表单项分开的，但又有联动，规则还复杂，valueFormat 又是特定格式，而不是默认的时间戳格式(这样 minDate 和 maxDate 就会失效)，等等限制。可以通过 `props env moment` 字符函数将表单项转为 Moment 格式，就方便许多，以及更灵活，比如下面例子：需要禁用某些日期，开始时间小于结束时间，结束时间大于开始时间，通过 props env moment 更灵活配置。

```schema: scope="body"
{
"type": "form",
"debug": true,
"api": "/api/mock2/form/saveForm",
"body": [
{
"type": "input-date",
"name": "start",
"label": "开始时间",
"required": true,
"valueFormat": "YYYY-MM-DD HH:mm:ss",
"placeholder": "请选择日期以及时间",
"displayFormat": "YYYY-MM-DD HH:mm:ss",
"disabledDate": "if(!props.data.end)return;const moment = props.env.moment();const maxDate = moment(props.data.end).valueOf();return currentDate.valueOf() > maxDate"
},
{
"type": "input-date",
"name": "end",
"label": "结束时间",
"required": true,
"valueFormat": "YYYY-MM-DD HH:mm:ss",
"placeholder": "请选择日期以及时间",
"displayFormat": "YYYY-MM-DD HH:mm:ss",
"disabledDate": "console.log(props);if(!props.data.start)return false;const moment = props.env.moment();const minDate = moment(props.data.start).valueOf();return currentDate.valueOf() < minDate"
},
]
}
```

## 快捷键

你也可以配置`shortcuts`属性支持快捷选择日期
Expand Down
30 changes: 15 additions & 15 deletions docs/zh-CN/components/form/input-month-range.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -67,21 +67,21 @@ order: 15

除了支持 [普通表单项属性表](./formitem#%E5%B1%9E%E6%80%A7%E8%A1%A8) 中的配置以外，还支持下面一些配置

| 属性名 | 类型 | 默认值 | 说明 | 版本 |
| ------------------------ | --------- | ------------------ | ---------------------------------------------------------------------------- | ------- |
| format | `string` | `X` | [日期选择器值格式](./date#%E5%80%BC%E6%A0%BC%E5%BC%8F) |
| inputFormat | `string` | `YYYY-DD` | [日期选择器显示格式](./date#%E6%98%BE%E7%A4%BA%E6%A0%BC%E5%BC%8F) |
| placeholder | `string` | `"请选择月份范围"` | 占位文本 |
| minDate | `string` | | 限制最小日期，用法同 [限制范围](./date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| maxDate | `string` | | 限制最大日期，用法同 [限制范围](./date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| minDuration | `string` | | 限制最小跨度，如： 2days |
| maxDuration | `string` | | 限制最大跨度，如：1year |
| utc | `boolean` | `false` | [保存 UTC 值](./date#utc) |
| clearable | `boolean` | `true` | 是否可清除 |
| embed | `boolean` | `false` | 是否内联模式 |
| animation | `boolean` | `true` | 是否启用游标动画 | `2.2.0` |
| extraName | `string` | | 是否存成两个字段 | `3.3.0` |
| popOverContainerSelector | `string` | | 弹层挂载位置选择器，会通过`querySelector`获取 | `6.4.0` |
| 属性名 | 类型 | 默认值 | 说明 | 版本 |
| ------------------------ | --------- | ------------------ | ---------------------------------------------------------------------------------- | ------- |
| format | `string` | `X` | [日期选择器值格式](./input-date#%E5%80%BC%E6%A0%BC%E5%BC%8F) |
| inputFormat | `string` | `YYYY-DD` | [日期选择器显示格式](./input-date#%E6%98%BE%E7%A4%BA%E6%A0%BC%E5%BC%8F) |
| placeholder | `string` | `"请选择月份范围"` | 占位文本 |
| minDate | `string` | | 限制最小日期，用法同 [限制范围](./input-date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| maxDate | `string` | | 限制最大日期，用法同 [限制范围](./input-date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| minDuration | `string` | | 限制最小跨度，如： 2days |
| maxDuration | `string` | | 限制最大跨度，如：1year |
| utc | `boolean` | `false` | [保存 UTC 值](./input-date#utc) |
| clearable | `boolean` | `true` | 是否可清除 |
| embed | `boolean` | `false` | 是否内联模式 |
| animation | `boolean` | `true` | 是否启用游标动画 | `2.2.0` |
| extraName | `string` | | 是否存成两个字段 | `3.3.0` |
| popOverContainerSelector | `string` | | 弹层挂载位置选择器，会通过`querySelector`获取 | `6.4.0` |

## 事件表

Expand Down
30 changes: 15 additions & 15 deletions docs/zh-CN/components/form/input-quarter-range.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -66,21 +66,21 @@ order: 15

除了支持 [普通表单项属性表](./formitem#%E5%B1%9E%E6%80%A7%E8%A1%A8) 中的配置以外，还支持下面一些配置

| 属性名 | 类型 | 默认值 | 说明 | 版本 |
| ------------------------ | --------- | ------------------ | ---------------------------------------------------------------------------- | ------- |
| valueFormat | `string` | `X` | [日期选择器值格式](./date#%E5%80%BC%E6%A0%BC%E5%BC%8F) | `3.4.0` |
| displayFormat | `string` | `YYYY-DD` | [日期选择器显示格式](./date#%E6%98%BE%E7%A4%BA%E6%A0%BC%E5%BC%8F) | `3.4.0` |
| placeholder | `string` | `"请选择季度范围"` | 占位文本 |
| minDate | `string` | | 限制最小日期，用法同 [限制范围](./date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| maxDate | `string` | | 限制最大日期，用法同 [限制范围](./date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| minDuration | `string` | | 限制最小跨度，如： 2quarter |
| maxDuration | `string` | | 限制最大跨度，如：4quarter |
| utc | `boolean` | `false` | [保存 UTC 值](./date#utc) |
| clearable | `boolean` | `true` | 是否可清除 |
| embed | `boolean` | `false` | 是否内联模式 |
| animation | `boolean` | `true` | 是否启用游标动画 | `2.2.0` |
| extraName | `string` | | 是否存成两个字段 | `3.3.0` |
| popOverContainerSelector | `string` | | 弹层挂载位置选择器，会通过`querySelector`获取 | `6.4.0` |
| 属性名 | 类型 | 默认值 | 说明 | 版本 |
| ------------------------ | --------- | ------------------ | ---------------------------------------------------------------------------------- | ------- |
| valueFormat | `string` | `X` | [日期选择器值格式](./input-date#%E5%80%BC%E6%A0%BC%E5%BC%8F) | `3.4.0` |
| displayFormat | `string` | `YYYY-DD` | [日期选择器显示格式](./input-date#%E6%98%BE%E7%A4%BA%E6%A0%BC%E5%BC%8F) | `3.4.0` |
| placeholder | `string` | `"请选择季度范围"` | 占位文本 |
| minDate | `string` | | 限制最小日期，用法同 [限制范围](./input-date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| maxDate | `string` | | 限制最大日期，用法同 [限制范围](./input-date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| minDuration | `string` | | 限制最小跨度，如： 2quarter |
| maxDuration | `string` | | 限制最大跨度，如：4quarter |
| utc | `boolean` | `false` | [保存 UTC 值](./input-date#utc) |
| clearable | `boolean` | `true` | 是否可清除 |
| embed | `boolean` | `false` | 是否内联模式 |
| animation | `boolean` | `true` | 是否启用游标动画 | `2.2.0` |
| extraName | `string` | | 是否存成两个字段 | `3.3.0` |
| popOverContainerSelector | `string` | | 弹层挂载位置选择器，会通过`querySelector`获取 | `6.4.0` |

## 事件表

Expand Down
28 changes: 14 additions & 14 deletions docs/zh-CN/components/form/input-year-range.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -67,20 +67,20 @@ order: 15

除了支持 [普通表单项属性表](./formitem#%E5%B1%9E%E6%80%A7%E8%A1%A8) 中的配置以外，还支持下面一些配置

| 属性名 | 类型 | 默认值 | 说明 | 版本 |
| ------------------------ | --------- | ------------------ | ---------------------------------------------------------------------------- | ------- |
| valueFormat | `string` | `X` | [年份选择器值格式](./date#%E5%80%BC%E6%A0%BC%E5%BC%8F) | `3.4.0` |
| displayFormat | `string` | `YYYY` | [年份选择器显示格式](./date#%E6%98%BE%E7%A4%BA%E6%A0%BC%E5%BC%8F) | `3.4.0` |
| placeholder | `string` | `"请选择年份范围"` | 占位文本 |
| minDate | `string` | | 限制最小日期，用法同 [限制范围](./date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| maxDate | `string` | | 限制最大日期，用法同 [限制范围](./date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| minDuration | `string` | | 限制最小跨度，如： 2year |
| maxDuration | `string` | | 限制最大跨度，如：4year |
| utc | `boolean` | `false` | [保存 UTC 值](./date#utc) |
| clearable | `boolean` | `true` | 是否可清除 |
| embed | `boolean` | `false` | 是否内联模式 |
| animation | `boolean` | `true` | 是否启用游标动画 | `2.2.0` |
| popOverContainerSelector | `string` | | 弹层挂载位置选择器，会通过`querySelector`获取 | `6.4.0` |
| 属性名 | 类型 | 默认值 | 说明 | 版本 |
| ------------------------ | --------- | ------------------ | ---------------------------------------------------------------------------------- | ------- |
| valueFormat | `string` | `X` | [年份选择器值格式](./input-date#%E5%80%BC%E6%A0%BC%E5%BC%8F) | `3.4.0` |
| displayFormat | `string` | `YYYY` | [年份选择器显示格式](./input-date#%E6%98%BE%E7%A4%BA%E6%A0%BC%E5%BC%8F) | `3.4.0` |
| placeholder | `string` | `"请选择年份范围"` | 占位文本 |
| minDate | `string` | | 限制最小日期，用法同 [限制范围](./input-date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| maxDate | `string` | | 限制最大日期，用法同 [限制范围](./input-date#%E9%99%90%E5%88%B6%E8%8C%83%E5%9B%B4) |
| minDuration | `string` | | 限制最小跨度，如： 2year |
| maxDuration | `string` | | 限制最大跨度，如：4year |
| utc | `boolean` | `false` | [保存 UTC 值](./input-date#utc) |
| clearable | `boolean` | `true` | 是否可清除 |
| embed | `boolean` | `false` | 是否内联模式 |
| animation | `boolean` | `true` | 是否启用游标动画 | `2.2.0` |
| popOverContainerSelector | `string` | | 弹层挂载位置选择器，会通过`querySelector`获取 | `6.4.0` |

## 事件表

Expand Down
5 changes: 1 addition & 4 deletions packages/amis-core/src/factory.tsx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,6 @@ import type {RendererEnv} from './env';
import {OnEventProps, RendererEvent} from './utils/renderer-event';
import {Placeholder} from './renderers/Placeholder';
import {StatusScopedProps} from './StatusScoped';
import moment from 'moment';

export interface TestFunc {
(
Expand Down Expand Up @@ -136,7 +135,6 @@ export interface RenderOptions
session?: string;
theme?: string;
fetcher?: (config: FetcherConfig) => Promise<fetcherResult>;
moment?: () => typeof moment;
}

const renderers: Array<RendererConfig> = [];
Expand Down Expand Up @@ -539,8 +537,7 @@ export const defaultOptions: RenderOptions = {
* 过滤 html 标签，可用来添加 xss 保护逻辑
*/
filterHtml: (input: string) => input,
isMobile: isMobile,
moment: () => moment
isMobile: isMobile
};

export const stores: {
Expand Down

0 comments on commit ed65d3d

Please sign in to comment.