_links_add_target()
云策文档标注
概述
_links_add_target() 是一个 WordPress 核心函数，用于在传入的内容中为所有链接添加 target 属性。它作为回调函数处理匹配的链接字符串。
关键要点
- 函数用途：为链接添加 target 属性，通常用于控制链接打开方式（如 _blank）。
- 参数：接受一个字符串参数 $m，代表匹配到的链接。
- 返回值：返回处理后的链接字符串。
- 内部实现：使用正则表达式移除现有 target 属性，并基于全局变量 $_links_add_target 添加新属性。
- 相关函数：与 esc_attr() 配合使用，确保 HTML 属性安全转义。
- 版本历史：自 WordPress 2.7.0 版本引入。
代码示例
function _links_add_target( $m ) {
global $_links_add_target;
$tag = $m[1];
$link = preg_replace( '|( target=(['"]) (.*?)\2)|i', '', $m[2] );
return '';
}注意事项
函数内部依赖全局变量 $_links_add_target，使用时需确保该变量已正确设置；代码示例中返回空字符串，实际实现可能需根据上下文调整。
原文内容
Callback to add a target attribute to all links in passed content.
Parameters
$mstringrequired-
The matched link.
Source
function _links_add_target( $m ) {
global $_links_add_target;
$tag = $m[1];
$link = preg_replace( '|( target=(['"])(.*?)2)|i', '', $m[2] );
return '<' . $tag . $link . ' target="' . esc_attr( $_links_add_target ) . '">';
}
Changelog
| Version | Description |
|---|---|
| 2.7.0 | Introduced. |