insertdatetime插件提供了一个工具栏控件和菜单项插入日期/时间(位于Insert菜单下),让用户可以轻松将当前日期和/或时间插入可编辑区域的光标插入点。
基本设置
tinymce.init({
selector: 'textarea', // 根据HTML更改此值
plugins: 'insertdatetime',
toolbar: 'insertdatetime'
});有关使用模块打包器捆绑此插件的信息,请参阅 捆绑 TinyMCE - 概述。
选项
这些设置影响insertdatetime插件的执行。可以通过这些配置选项设置日期和时间的格式。
insertdatetime_dateformat
此选项允许覆盖由mceInsertDate命令插入的日期格式的默认格式规则。默认为%Y-%m-%d,其中不同的%变量会被替换为各种日期格式选项。
类型:String
默认值:'%Y-%m-%d'
示例:使用 insertdatetime_dateformat
tinymce.init({
selector: 'textarea', // 根据HTML更改此值
plugins: 'insertdatetime',
toolbar: 'insertdatetime',
insertdatetime_dateformat: '%d-%m-%Y'
});insertdatetime_formats
允许指定要在日期菜单或日期选择框中使用的日期/时间格式列表。可在下方的日期格式中找到完整的格式列表。
类型:Array
默认值:[ '%H:%M:%S', '%Y-%m-%d', '%I:%M:%S %p', '%D' ]
示例:使用 insertdatetime_formats
tinymce.init({
selector: 'textarea', // 根据HTML更改此值
plugins: 'insertdatetime',
toolbar: 'insertdatetime',
insertdatetime_formats: [ '%H:%M:%S', '%Y-%m-%d', '%I:%M:%S %p', '%D' ]
});insertdatetime_timeformat
此选项允许覆盖由mceInsertTime命令插入的时间的默认格式规则。默认为%H:%M:%S,其中不同的%变量会被替换为各种日期格式选项。
类型:String
默认值:'%H:%M:%S'
示例:使用 insertdatetime_timeformat
tinymce.init({
selector: 'textarea', // 根据HTML更改此值
plugins: 'insertdatetime',
toolbar: 'insertdatetime',
insertdatetime_timeformat: '%H:%M:%S'
});insertdatetime_element
启用此选项后,插入日期/时间时会生成HTML5时间元素。
类型:Boolean
默认值:false
可能的值:true,false
示例:使用 insertdatetime_element
tinymce.init({
selector: 'textarea', // 根据HTML更改此值
plugins: 'insertdatetime',
toolbar: 'insertdatetime',
insertdatetime_element: true
});参考日期/时间格式
| 名称 | 摘要 |
|---|---|
%D | mm/dd/yy(与%m/%d/%y相同) |
%r | 12小时制时间hh:mm:ss,带有AM或PM(与%I:%M:%S %p相同) |
%y | 两位数年份(范围00到99) |
%Y | 四位数年份(包含世纪) |
%m | 两位数月份(范围01到12) |
%B | 完整的本地化月份名称(例如“January”) |
%b | 缩写的本地化月份名称(例如“Jan”) |
%d | 两位数日期(范围01到31) |
%A | 完整的本地化星期名称(例如“Monday”) |
%a | 缩写的本地化星期名称(例如“Mon”) |
%H | 24小时制的小时数(范围00到23) |
%I | 12小时制的小时数(范围01到12) |
%M | 两位数分钟(范围00-59) |
%S | 两位数秒数(范围00-59) |
%p | 根据给定时间值为“am”或“pm” |
%% | 一个字面的“%”字符 |
工具栏按钮
Insert Date/Time插件提供以下工具栏按钮:
| 工具栏按钮标识符 | 描述 |
|---|---|
| 插入当前日期/时间。 |
可以通过以下方式将这些工具栏按钮添加到编辑器中:
使用
toolbar配置选项。使用
quickbars_insert_toolbar配置选项。
菜单项
Insert Date/Time 插件提供以下菜单项:
| 菜单项标识符 | 默认菜单位置 | 描述 |
|---|---|---|
| 插入 | 将当前日期/时间插入编辑器。 |
可通过以下方式将这些菜单项添加到编辑器:
使用
menu配置选项。使用
contextmenu配置选项。
命令
Insert Date/Time 插件提供以下 TinyMCE 命令。
| 命令 | 描述 |
|---|---|
mceInsertDate | 插入当前日期(以人类可读字符串形式)。 |
mceInsertTime | 插入当前时间(以人类可读字符串形式)。 |
tinymce.activeEditor.execCommand('mceInsertDate');
tinymce.activeEditor.execCommand('mceInsertTime');