如何优化 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 确保参数健壮性；
✅ 无障碍友好：保留标签，确保双向文本正确渲染。

⚠️ 注意事项：