sanitize_html_class() 函数是 WordPress 提供的一个用于清理 HTML 类名(class)的函数。它可以确保 HTML 类名只包含合法的字符,并且符合 HTML 的规范。

函数原型:

sanitize_html_class( $class, $fallback = '' )

参数:
- $class:要清理的 HTML 类名,通常是通过变量传递进来的。
- $fallback:可选参数,指定一个替代值,如果清理后的类名为空会返回此值,默认为空字符串。

返回值:
函数返回清理后的 HTML 类名。

函数使用示例:

$class = 'my-class@#'; // 要清理的类名
$sanitized_class = sanitize_html_class( $class ); // 清理后的类名
echo $sanitized_class; // 输出:my-class

从示例中可以看出,sanitize_html_class() 函数将清理掉类名中的特殊字符 @ 和 #,并且返回了清理后的类名 my-class。

此外,sanitize_html_class() 函数还有一些其他特性:
1. 会移除类名中间的连字符(-)和下划线(_),并将它们替换为一个空格。
2. 如果类名以数字开头,则会在开头添加一个字符(通常是字母 x)。
3. 如果清理后的类名为空,则会返回 $fallback 参数指定的值。

总之,sanitize_html_class() 函数是一个非常方便的工具,可以确保 HTML 类名的合法性和规范性。在开发 WordPress 主题或插件时,使用这个函数可以避免因为不合法的类名导致的一些问题。