云策 WordPress 开发者社区

函数文档

link_target_meta_box()

查看官方原文 ↗
💡 云策文档标注

概述

link_target_meta_box() 函数用于在 WordPress 后台显示一个元框，允许用户编辑链接的目标属性。它生成一个表单，包含多个单选按钮选项，用于设置链接打开方式。

关键要点

  • 函数接受一个参数 $link，表示当前链接对象，用于预填充表单状态。
  • 表单提供三个目标选项：_blank（新窗口或标签页）、_top（当前窗口或标签页，无框架）和 _none（相同窗口或标签页）。
  • 函数通过检查 $link->link_target 属性来设置默认选中的单选按钮。
  • 此函数自 WordPress 2.6.0 版本引入，位于 wp-admin/includes/meta-boxes.php 文件中。

代码示例

function link_target_meta_box( $link ) {
    ?>
    <input type="radio" name="link_target" value="_blank" <?php checked( isset( $link->link_target ) && ( '_blank' === $link->link_target ) ); ?> />
    <label>_blank — new window or tab.</label>
    <input type="radio" name="link_target" value="_top" <?php checked( isset( $link->link_target ) && ( '_top' === $link->link_target ) ); ?> />
    <label>_top — current window or tab, with no frames.</label>
    <input type="radio" name="link_target" value="" <?php checked( isset( $link->link_target ) && ( '' === $link->link_target ) ); ?> />
    <label>_none — same window or tab.</label>
    <?php
}
📄 原文内容

Displays form fields for changing link target.

Parameters

$linkobjectrequired
Current link object.

Source

function link_target_meta_box( $link ) {

	?>
<fieldset><legend class="screen-reader-text"><span></span></legend>
<p><label for="link_target_blank" class="selectit">
<input id="link_target_blank" type="radio" name="link_target" value="_blank" <?php echo ( isset( $link->link_target ) && ( '_blank' === $link->link_target ) ? 'checked="checked"' : '' ); ?> />
	_blank — new window or tab.' ); ?>

View all references View on Trac View on GitHub

Uses Description
_e()wp-includes/l10n.php

Displays translated text.

Changelog

Version Description
2.6.0 Introduced.