WordPress.org网站
获取WordPress
WordPress.org网站

WordPress开发人员资源

wp_add_inline_script（）

wp_add_inline脚本(一串 $句柄,一串 $数据,一串 $位置 = “之后” ):布尔

在本文中

返回页首

向注册脚本添加额外代码。

描述

只有当脚本已经在队列中时，才会添加代码。
接受字符串$数据包含代码。如果将两个或多个代码块添加到同一脚本$句柄，它们将按添加顺序打印，即后一个添加的代码可以重新声明前一个。

另请参见

参数

$句柄一串必修的
要将内联脚本添加到的脚本的名称。
$数据一串必修的
包含要添加的JavaScript的字符串。
$位置一串可选择的
是在句柄之前还是之后添加内联脚本。违约“之后”.

违约：“之后”

返回

布尔成功时正确，失败时错误。

来源

函数wp_add_inline_script（$handle，$data，$position='after'）{_wp_scripts_maybe_doing_it_wrong（__FUNCTION__，$handle）；if（false！==stripos（$data，'</script>'））{_做错了(__功能__，冲刺(/*转换器：1:<script>，2:wp_add_inline_script（）*/__（'不要将%1$s标记传递给%2$s。'），'<代码>&lt；脚本&gt</代码>'，'<code>wp_add_inline_script（）</code>'),'4.5.0');$data=修剪（preg_replace（'#<script[^>]*>（.*）</script>#is'，'$1'，$data））；}返回wp_scripts（）->add_inline_script（$handle，$data，$position）；}

查看所有引用 在Trac上查看 在GitHub上查看

使用描述
stripos（）wp-includes/class-pop3.php
WP_脚本：：add_inline_script（）wp-includes/class-wp-scripts.php

向注册脚本添加额外代码。

wp_scripts（）wp-includes/functions.wp-scripts.php

如果尚未设置$wp_scripts，则初始化它。

__()wp-includes/l10n.php

检索$text的翻译。

_doing_it_wrong（）wp-includes/functions.php

将某物标记为被错误调用。

再显示2个显示更少
使用者描述
wp_enqueue_block_template_skip_link（）wp-includes/theme-templates.php

加入skip-link脚本和样式。

wp_attach_theme_preview_middleware（）wp包括/theme-reviews.php

将中间件添加到api获取设置预览的主题。

块_编辑器_暂存_图像_重新加载（）wp-includes/块编辑器.php

通过指定将为给定块编辑器上下文预加载的REST API路径数组，预加载块编辑器使用的公共数据。

enqueue_editor_block_styles_assets（）wp-includes/script-loader.php

负责在编辑器上排队块样式功能所需的资源的函数。

块编辑器元数据框（）wp-admin/includes/post.php

呈现元框表单。

WP_Privacy_Policy_Content:：notice（）wp-admin/includes/class-wp-privacy-policy-content.php

编辑隐私政策页面时，添加带有指南链接的通知。

wp_enqueue_code_editor（）wp-includes/general-template.php

为给定设置排队代码编辑器所需的资产。

WP_Widget_Media库：：enqueue_admin_scripts（）wp-includes/widgets/class-wp-widget-media-gallery.php

加载媒体管理器所需的媒体文件和媒体小部件的脚本。

WP_Widget_Custom_HTML:：enqueue_admin_scripts（）wp-includes/widgets/class-wp-widget-custom-html.php

加载小部件控件所需的脚本和样式。

WP_Widget_Text:：enqueue_admin_scripts（）wp-includes/widgets/class-wp-widget-text.php

加载小部件控件所需的脚本和样式。

WP_Widget_Media音频：：enqueue_admin_scripts（）wp包含/widgets/class-wp-widget-media-audio.php

加载媒体管理器所需的媒体文件和媒体小部件的脚本。

WP_Widget_Media视频：：enqueue_admin_scripts（）wp-includes/widgets/class-wp-widget-media-video.php

加载小部件控件所需的脚本和样式。

WP_Widget_Media图像：：enqueue_admin_scripts（）wp-includes/widgets/class-wp-widget-media-image.php

加载媒体管理器所需的媒体文件和媒体小部件的脚本。

wp_localize_jquery_ui_datepicker（）wp-includes/script-loader.php

本地化jQuery UI日期选择器。

WP_Customize_Widgets:：入队脚本（）wp-includes/class-wp-customize-widgets.php

为Customizer面板排队脚本和样式，并将数据导出到JavaScript。

再显示10个显示更少

变更日志

版本描述
4.5.0介绍。

用户贡献的笔记

  1. 跳到注释7内容
    朱尔斯·科莱
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：35你必须登录才能对这个便条的帮助进行投票

    显然我们现在应该使用wp_add_inline_script（wp_add_inline_script）而不是wp_localize_script公开脚本需要使用的全局对象。

    因此，虽然以前您可以（现在仍然可以）这样做：

    wp_enqueue_script（'wpdocs-my-script'，'https://url-to/my-script.js' );wp_localize_script（'wpdocs-my-script'，'MYSCRIPT'，数组(“ajaxUrl”=>admin_url（“admin-ajax.php”），'otherParam'=>'some value'，) );

    现在似乎建议这样做（我个人认为这很难看）：

    wp_enque_script（'wpdocs我的脚本'，'https://url-to/my-script.js' );wp_add_inline_script（'wpdocs-my-script'，'const MYSCRIPT='.json_encode（数组(“ajaxUrl”=>admin_url（“admin-ajax.php”），'otherParam'=>'some value'，)），“之前”）；

    请注意，您需要添加“之前”作为第三个参数wp_add_inline_script（wp_add_inline_script）功能。

    现在，在JS脚本中，您可以访问以下PHP参数，如下所示：

    控制台.log（MYSCRIPT.ajaxUrl）；//输出：“https://your-site/wp-admin/admin-ajax.php&quot;控制台.log（MYSCRIPT.otherParam）；//输出：“一些值”
  2. 跳到备注8内容
    克利夫德·鲍利克
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：18你必须登录才能对这个便条的帮助进行投票

    可以使用以下代码轻松地将Typekit的JavaScript添加到主题中：

    函数mytheme_enqueue_typekit（）{wp_enque_script（'主题类型工具包'，'https://use.typekit.net/.js'，array（），'1.0'）；wp_add_inline_script（'mytheme-typekit'，'尝试{typekit.load（{async:true}）；}捕获（e）{}'）；}add_action（'wp_enqueue_scripts'，'mytheme_enqueue_typekit'）；

    结果是：

    <script type=“text/javascript”src=“https://use.typekit.net/.js？ver=1.0“></script&gt;尝试{Typekit.load（{async:true}）；}捕获（e）{}

    发件人https://make.wordpress.org/core/2016/03/08/enhanced-script-loader-in-wordpress-4-5/

  3. 跳到注释9内容
    Pepro开发集团
    你必须登录才能对这张纸条的有用性进行投票本附注的投票结果：11你必须登录才能对这个便条的帮助进行投票

    添加CSS样式没有依赖性

    wp_register_style（'myprefix-dummy-css'，false）；wp_enque_style（'myprefix dummy css'）；wp_add_inline_style（'myprefix-dummy-css'，“body*{box-sizing:inherit；}”）；

    添加JavaScript代码没有依赖性

    wp_register_script（'myprefix-dummy-js-header'，''，）；wp_enqueue_script（'myprefix-dummy-js-header'）；wp_add_inline_script（'myprefix-dummy-js-header'，“console.log（'加载到标题中'）；”）；

    添加JavaScript代码具有jQuery（jQuery）附属国

    wp_register_script（'myprefix-dummy-js-footer'，''，数组（“jquery”），''，true）；wp_enqueue_script（'myprefix-dummy-js-footer'）；wp_add_inline_script（'myprefix dummy js footer'，“console.log（'loaded in footer'）；”）；
  4. 跳到注释10内容
    Aurovrata威尼斯
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：2你必须登录才能对这个便条的帮助进行投票

    注：使用新的区块主题，如“二十二”，wp_localize_script/wp_add_inline_script（wp_add_inline_script）如果调用得太晚（例如在短代码呈现回调函数中），将不再工作。要实现这一点，您需要使用与wp_footer操作挂钩的匿名函数调用，

    $data=数组（）；//要传递给前端脚本的数据对象。$localise=json_encode（$data）；add_action（'wp_footer'，function（）use（$localise）{printf（'<script type=“text/javascript”>var myData=%s</script>'，$localise）；});
  5. 跳到备注11内容
    Aurovrata威尼斯
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：1你必须登录才能对这个便条的帮助进行投票

    当你想确保你的匿名函数使用一个使用javascript库实例化的对象时，这个函数很方便，因为javascript库可能会与其他插件或WordPress核心本身加载的其他版本发生冲突。例如，如果需要使用不同版本的jQuery，可以执行以下操作，

    wp_register_script（'jquery3.2.1'，'https://code.jquery.com/jquery-3.2.1.min.js' );wp_add_inline_script（'jquery3.2.1'，'var jquery3_2_1=$.noConflict（true）；'）；wp_enqueue_script（'plugin-javascript'，plugins_url（'js.js'，__FILE__），数组（'jquery3.2.1'））；

    这将在浏览器加载jQuery库v3.2.1后立即实例化一个新的jQuery对象`jquery3_2_1`，确保它具有正确的版本引用，然后可以将其作为属性传递给`js.js`脚本，

    （函数（$）{//$现在使用jquery的v3.2.1。//警报jQuery版本。警报（$.fn.jquery）；//此处应显示插件/主题代码。}（jQuery3_2_1））；
  6. 跳到注释12内容
    丁胡
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：-11你必须登录才能对这个便条的帮助进行投票

    用于添加内联脚本

    函数theme_prefix_enqueue_script（）{wp_enqueue_script（'main-js'，'/main.js'，array（），'1.0'）；wp_add_inline_script（'main-js'，'警报（“hello world”）；'）；}add_action（“wp_enqueue_scripts”，“theme_prefix”）；

    对于jQuery-dependent脚本，请使用以下命令：

    函数theme_prefix_enqueue_script（）{if（！wp_script_is（'jquery'，'done'））{wp_enqueue_script（'jquery'）；}wp_add_inline_script（'jquery-migate'，'jquery（document）.ready（function（）{}）；'）；}add_action（'wp_enque_scripts'，'theme_prefix_enquee_script'）；

你必须登录在能够发表注释或反馈之前。