日期选取器内容控件



thead>

属性名 描述 类型 默认值

/thead>

elem

绑定元素选择器或 DOM 对象

string/DOM -

type

• 年选择器，只提供年列表选择
• 年月选择器，只提供年、月选择
• 日期选择器（默认），可选择：年、月、日选择
• 时间选择器，只提供时、分、秒选择
• 日期时间选择器，可选择：年月日、时分秒

效果详见： #示例

string

id

设定实例唯一索引，以便用于其他方法对例进行相关操作。若该属性未设置，则默认从 属性绑定的元素中的 属性值中获取。

string -

range

• 若为 类型，即表示是否开启范围选择，若设为 ，则开始日期与结束日期默认采用 连接符
• 若为 类型，则表示开启范围选择，且自定义开始日期与结束日期的连接符。如：
• 若为 类型，即表示开启范围选，且开始日期和结束日期分别赋值在两个目标选择器中，如：

详细用法可参考： #示例

boolean
string
array

rangeLinked ^2.8+

是否开启日期范围选择时的区间联动标注模式，该模式必须开启 属性才能生效。日期范围默认采用的是左右面板独立选择模式，设置该属性后，将采用左右面板联动选择模式。
效果详见： #示例

boolean

fullPanel ^2.8+ boolean

format

通过上述格式符组成日期时间字符串，如下所示：

相关用法可参考： #示例

formatToDisplay ^2.9.9+

仅用于格式化日期显示的格式，不影响日期值

function -

value

• 若为 类型，则必须和 属性格式对应

• 若为 对象类型，则可直接赋值

• 当开启 时，初始设置日期范围值

string
date

isInitValue

是否将初始值填充在目标元素中，一般配合 属性使用

boolean

shortcuts ^2.8+

其中 支持以下类型：

• 若为 类型，必须和 设置的格式对应；
• 若为 对象类型，则可通过操作 来对选项值进行相应的返回计算；
• 若为 类型，则数组成员可填写开始日期和结束日期。
• 若为 类型，返回值同上。^2.8.16+

详细用法可参考： #示例

string
date
array
function - weekStart ^2.7+

设置起始周。 支持 0-6 的数字， 即代表从周日开始。

number

isPreview

用于是否在面板左下角显示当前结果的预览。当 时强制为 。

boolean

min / max

属性值支持以下可选类型：

• 若值为字符类型，则：年月日必须用 连接，且时分秒必须用 连接。 此处无需遵循 设定的格式；
• 若值为整数类型，且数字 ＜ ，则数字代表天数，如： 即代表最小日期在 7 天前，正数代表若干天后；
• 若值为整数类型，且数字 ≥ ，则数字代表毫秒数，如： 即代表最大日期在公元 3000年1月1日。

示例：

相关效果可参考： #示例

disabledDate ^2.9.8+

用于设置不可选取的日期。示例：

function - disabledTime ^2.9.8+

用于设置不可选取的时间。示例：

function - trigger

自定义弹出组件面板的事件

string

show

是否在渲染时默认显示组件面板。组件在执行渲染时，默认需通过触发目标元素的事件，方可显示组件面板，而该属性可跳过目标元素的事件，直接显示组件面板。

boolean

position

设置组件面板的定位方式。支持以下可选值：

• 绝对定位，始终吸附在绑定元素周围。
• 固定定位，初始吸附在绑定元素周围，不随浏览器滚动条所左右。一般用于在固定定位的弹层中使用。
• 静态定位，控件将直接嵌套显示在指定容器中。用法详见：#示例

string

zIndex

设置组件面板的层叠顺序。一般用于解决与其它元素的互相被遮掩的问题。若 时，则该属性无效。

number

shade ^2.8+

• 若为 类型，则表示遮罩透明度。如：

• 若为 类型，则可设置遮罩颜色和透明度，如：

效果详见： #示例

number
array - showBottom

是否显示组件面板的底部栏

boolean

btns

自定义排版组件面板底部栏中的按钮，按钮将按照数组顺序排列。内置按钮名称： 。

array - autoConfirm ^2.8+ boolean

lang

设置组件的语言版本。可选值如下：

• 中文版
• 英文版

string

theme

注 ^2.8+ : 多个主题可用数组格式，如：

若第 1 个成员为 hex 格式的主色值，则第 2 个成员为辅色值

效果及用法详见： #示例

string
array - calendar

是否显示我国常见的公历节日。当 时无效。

boolean

mark

• object 类型

前缀 即代表每年， 即代表每年每月。

• function 类型 ^2.9.9+

效果详见： #示例

object -

holidays ^2.7+

• 若为 array 类型，值是一个二维数组，如：

• 若为 function 类型 ^2.9.9+

相关日期值可详细参考国家每年公布的法定节假日安排

效果详见： #示例

array - cellRender ^2.9.9+

自定义单元格内容。

function -

ready

change

done

onConfirm ^2.8+

点击底部栏「确定」按钮时的回调函数。返回的参数同 。

onNow ^2.8+

点击底部栏「现在」按钮时的回调函数。返回的参数同 。

onClear ^2.8+

点击底部栏「清空」按钮时的回调函数。返回的参数同 。

close ^2.7+

组件面板被关闭（移除）后的回调函数。无返回参数。

版权声明：

本文来源网络，所有图片文章版权属于原作者，如有侵权，联系删除。

本文网址：https://www.mushiming.com/mjsbk/12268.html