如何优化 WooCommerce 价格显示以减少 DOM 元素数量

本文提供一种安全、兼容 woocommerce 6+ 的方案，通过重写 `wc_price` 过滤器，彻底移除冗余的 `` 标签，在保留货币语义与可访问性的前提下显著降低 dom 节点数，提升 pagespeed insight 评分。

WooCommerce 默认使用嵌套 包裹货币符号（如 $），导致每个价格显示额外增加 1–2 个 DOM 节点。在商品列表页、购物车或结账页中大量复用时，极易触发 Pagespeed Insight 的 “Excessive DOM elements” 警告（通常建议 DOM 节点总数

真正有效的解法是接管 wc_price() 的完整输出逻辑——该函数是 WooCommerce 所有价格渲染（包括 WC()->cart->get_cart_subtotal()、$product->get_price_html() 等）的统一入口。以下代码直接替换默认价格 HTML，将货币符号内联至主 中，不新增任何 DOM 节点，同时完全兼容 WC 6.x 及 PHP 8+：

add_filter('wc_price', 'custom_wc_price', 10, 5);

function custom_wc_price($return, $price, $args, $unformatted_price, $original_price) {
    $args = apply_filters(
        'wc_price_args',
        wp_parse_args(
            $args,
            array(
                'ex_tax_label' => false,
                'currency'     => '',
                'decimal_separator' => wc_get_price_decimal_separator(),
                'thousand_separator' => wc_get_price_thousand_separator(),
                'decimals'     => wc_get_price_decimals(),
                'price_format' => get_woocommerce_price_format(),
            )
        )
    );

    // 安全类型转换，适配 PHP 8 强类型要求
    $price = (float) $price;
    $negative = $price < 0;
    $abs_price = $negative ? $price * -1 : $price;

    // 格式化数字部分（不含符号）
    $formatted_number = number_format(
        $abs_price,
        $args['decimals'],
        $args['decimal_separator'],
        $args['thousand_separator']
    );

    if (apply_filters('woocommerce_price_trim_zeros', false) && $args['decimals'] > 0) {
        $formatted_number = wc_trim_zeros($formatted_number);
    }

    // 关键优化：将货币符号直接拼入 price_format，避免独立 span
    $currency_symbol = get_woocommerce_currency_symbol($args['currency']);
    $formatted_price = ($negative ? '-' : '') . sprintf($args['price_format'], $currency_symbol, $formatted_number);

    // 统一包裹在单个语义化 span + bdi（保障 RTL 文本正确性）
    $return = '' . $formatted_price . '';

    // 保留含税标签（如启用）
    if ($args['ex_tax_label'] && wc_tax_enabled()) {
        $return .= ' ' . WC()->countries->ex_tax_or_vat() . '';
    }

    return $return;
}

✅ 优势说明：

• ✅ 零新增 DOM 节点：货币符号不再包裹在独立 中，而是作为纯文本内联；
• ✅ 完全向后兼容：复用 WC 原生 get_woocommerce_currency_symbol() 和格式化逻辑，支持多货币、RTL、小数精度等全部特性；
• ✅ 性能安全：显式类型转换规避 PHP 8 警告，wp_parse_args 确保参数健壮性；
• ✅ 无障碍友好：保留 标签，确保双向文本正确渲染。

⚠️ 注意事项：

琅琅配音

全能AI配音神器

下载

• 请将代码添加至 子主题的 functions.php 中（避免父主题更新覆盖）；
• 若使用缓存插件（如 WP Rocket、LiteSpeed Cache），修改后需清空所有缓存；
• 修改前建议备份当前 functions.php，并在开发环境测试价格显示（含折扣价、变体价格、购物车总计等场景）；
• 此方案不影响 WooCommerce REST API 或后台价格计算，仅改变前端 HTML 输出结构。

通过此优化，典型 WooCommerce 商品列表页（50+ 商品）可减少 100–300 个冗余 DOM 节点，Pagespeed Insight 的 DOM 深度与节点数指标将显著改善，同时保持代码可维护性与 WC 生态兼容性。