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必须是唯一的。添加自己的按钮时,请勿使用以下值:

AccessKey ID 价值 标签启动 标签端
一个 关联 关联
b 强的 b
C 代码 代码
d del del
F 全屏 全屏
一世 Em 一世
l \ t
  • \ n
    m IMG IMG “'
    o ol ol
      \ n
    \ n \ n
    堵塞 B引用 \ n \ n
    \ n \ n
    s ins ins
    t 更多的 更多的 <! - 更多 - >
    Ul Ul
      \ n
    \ n \ n
    拼写 抬头

    上面的一些标签值使用变量,例如URL和_约会时间,从功能传递。

    顶部↑

    源文件

    qt.addbutton()源位于js/_enqueues/lib/quicktags.js,在构建过程中的输出wp-incudes/js/quicktags.jswp-rudes/js/quicktags.min.js