概述

wp_kses_uri_attributes() 函数返回一个包含 URL 值的 HTML 属性名称数组，基于 HTML 规范定义。此列表包括 KSES 允许和禁止的 URI 属性，并可通过过滤器进行自定义。

关键要点

• 函数返回一个字符串数组，表示必须包含 URL 的 HTML 属性名称。
• 内置属性列表包括 action、href、src 等常见 URI 属性。
• 支持通过 wp_kses_uri_attributes 过滤器添加或修改属性列表，例如用于自定义 data- 属性。
• 函数在 WordPress 5.0.1 版本中引入，用于增强 HTML 安全验证。

代码示例

function wp_kses_uri_attributes() {
	$uri_attributes = array(
		'action',
		'archive',
		'background',
		'cite',
		'classid',
		'codebase',
		'data',
		'formaction',
		'href',
		'icon',
		'longdesc',
		'manifest',
		'poster',
		'profile',
		'src',
		'usemap',
		'xmlns',
	);

	/**
	 * Filters the list of attributes that are required to contain a URL.
	 *
	 * Use this filter to add any `data-` attributes that are required to be
	 * validated as a URL.
	 *
	 * @since 5.0.1
	 *
	 * @param string[] $uri_attributes HTML attribute names whose value contains a URL.
	 */
	$uri_attributes = apply_filters( 'wp_kses_uri_attributes', $uri_attributes );

	return $uri_attributes;
}

注意事项

• 此函数主要用于 KSES 相关函数（如 wp_kses_one_attr()）中验证 URL 属性，确保 HTML 安全性。
• 开发者可以通过过滤器扩展属性列表，以适应自定义需求，但需谨慎处理以避免安全漏洞。