QuickTags
描述
QuickTags API允许您在WordPress Classic Editor的文本(HTML)模式中包含其他按钮。

历史
此API引入了WordPress 3.3。
用法
qtags.addbutton(id,display,arg1,arg2,access_key,title,priority,实例);
参数
ID
((细绳)(必需的):该按钮的HTML ID。默认:没有任何展示
((细绳)(必需的):按钮的HTML值。默认:没有任何arg1
((细绳)(必需的):要么像“ ”这样的启动标签,要么单击按钮时执行的回调。默认:没有任何arg2
((细绳)(可选的):结束标签,例如“ ”。如果不需要关闭标签(即“
”),请留空。默认:没有任何access_key
((细绳)(可选的):快捷方式访问按钮。默认:没有任何标题
((细绳)(可选的):该按钮的HTML标题值。默认:没有任何优先
((int)(可选的):一个代表工具栏中按钮所需位置的数字。1 - 9 =第一,11 - 19 =第二,21 - 29 =第三等。默认值:没有任何实例
((细绳)(可选的):将按钮限制为QuickTags的特定实例,添加到所有实例中,如果不存在。默认:没有任何
返回值
((混合)null或背面组件所需的按钮对象。
例子
//在HTML编辑器函数wporg_add_quicktags(){if(wp_script_is('quicktags')){?> <?php}} add_action('admin_print_footer_scripts','wporg_add_quicktags');
(注意:要避免参考错误,我们检查是否正在使用“ QuickTags”脚本。)
以上将在文本编辑器中的默认QuickTag中添加HTML按钮。例如,“ P”按钮HTML将是:
(每个按钮的ID值都会使用字符串自动预启动问t_content_
)
这是DocBlock的转储QuickTags.js
,它本身非常有用。
/** *用于将按钮添加到QuickTags * *的主要API函数 * *添加qt.button或qt.tagbutton取决于ARGS。总是需要前三个ARG。*为了能够将按钮添加到QuickTags中,您的脚本应以“ QuickTags”的依赖性为单位,并在页脚中输出。如果您直接从PHP呼应JS,请 *使用add_action('admin_print_footer_scripts','output_my_js',100)或add_action('wp_footer','output_my_js',100) * *添加一个呼叫外部功能的按钮所需的最小值* qtags.addbutton('my_id','my button',my_callback);*函数my_callback(){alert('yeah!');} * *添加一个插入标签的按钮所需的最低要求: * qtags.addbutton('my_id','my button','my button','','');* qtags.addbutton('my_id2','my button','
');*/
默认QuickTags
以下是WordPress添加到文本编辑器的默认QuickTags的值(按访问键值排序)。访问密钥和ID必须是唯一的。添加自己的按钮时,请勿使用以下值:
上面的一些标签值使用变量,例如URL和_约会时间
,从功能传递。
源文件
qt.addbutton()源位于js/_enqueues/lib/quicktags.js
,在构建过程中的输出wp-incudes/js/quicktags.js
和wp-rudes/js/quicktags.min.js
。