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

如何优化 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 生态兼容性。

https://www.php.cn/faq/2030587.html

发表回复

Your email address will not be published. Required fields are marked *