HUSKY - WooCommerce Product Filter Professional

WooCommerce 产品筛选器 CSS 自定义:皮肤、标题与修复

WooCommerce 产品筛选器 CSS 自定义通常从一个小愿望开始:复选框使用品牌色、标题小一点、让下拉菜单与主题相匹配,或是修复主题在每个复选框旁多画出第二个方框的问题。HUSKY 通过设置覆盖了其中一部分,其余的只需几行 CSS,前提是您知道把它们放在哪里,以及该针对哪些类。本指南同时给出这两方面的内容,还有我们最常遇到的主题冲突的修复方法。

先用设置,再用 CSS

设计 (Design) 选项卡(WooCommerce → 设置 (Settings) → Products Filter → 设计 (Design))无需代码即可改变外观:

  • 单选框和复选框皮肤 (Radio and checkboxes skin):扁平、极简和方形皮肤,各有十种颜色;或选择无 (none),使用浏览器自带的方框。
  • 下拉菜单皮肤 (Drop-down skin):原生 (Native)、Chosen 或 SelectWoo。
  • ion 范围滑块的范围滑块皮肤 (Range-slider skin)、使用工具提示 (Use tooltip) 和工具提示图标 (Tooltip icon)、折叠开关和展开/收起图片,以及加载遮罩。

其他一切都放进高级 (Advanced) → 代码 (Code) → 自定义 CSS 代码 (Custom CSS code)。HUSKY 会在每个加载它的页面上,紧接着自己的样式表之后输出这段代码,并把它保存在自己的设置中,因此插件更新不会改动它。只粘贴纯 CSS 规则:保存设置时,<style> 之类的 HTML 标签会被去掉,反斜杠也不能可靠地保留,所以请直接写出符号(content: "✓"),而不要用 \2713 这样的 CSS 转义。在自定义器中使用主题的额外 CSS (Additional CSS),或子主题样式表,效果同样好。切勿编辑插件的 css/front.css:下次更新就会把它替换掉。

设计选项卡末尾的自定义前端 CSS 样式文件链接 (Custom front css styles file link) 是另一种工具。它加载的是您的文件,用来取代 front.css,而不是在其基础上追加,所以只应在从插件文件副本出发做完整改写时使用。

让您的规则生效

主题样式表经常在插件之后加载,并使用很长的选择器,而插件的少数规则带有 !important。请让每条规则都以 .woof 开头,如果主题仍然占上风,则用 body .woof,并且只在插件或主题已经使用 !important 的地方才添加它。若要只为某一个筛选器设置样式而不影响其他筛选器,请用 sid 属性给它一个 ID:[woof sid="sidebar"] 会给表单添加类 woof_sid_sidebar。ID 请保持为一个不含空格的单词。有三个 ID 在插件的样式表中带有现成样式:flat_grey、flat_dark 和 flat_white。小工具始终使用 woof_sid_widget。产品上方的自动筛选器根据其皮肤设置取得类名:使用默认 (Default) 皮肤时为 woof_sid_auto_shortcode,使用全新安装时默认的扁平灰色皮肤时为 woof_sid_flat_grey 加 woof_auto_2_columns;请检查表单,查看您的站点使用的是哪一个。

类名对照表

元素选择器
整个筛选表单.woof, .woof_sid_<sid>
一个筛选块.woof_container,按类型 .woof_container_checkbox、.woof_container_radio、.woof_container_select;按分类法 .woof_container_product_cat、.woof_container_pa_color
块标题.woof_container_inner h4
列表和列表项.woof_list, .woof_list li;子分类 .woof_childs_list
复选框、标签、计数input.woof_checkbox_term, .woof_checkbox_label, .woof_checkbox_count;已选中 .woof_checkbox_label_selected
单选按钮和标签input.woof_radio_term, .woof_radio_label
标签按钮.woof_list_label .woof_label_term,已选中 .woof_label_term.checked
原生下拉菜单select.woof_select
筛选和重置按钮.woof_submit_search_form_container button, .woof_submit_search_form, .woof_reset_search_form

浏览器的检查器(右键单击元素,选择检查 (Inspect))会显示您的筛选器的确切类名,以及哪条规则生效。演示站点上使用的 CSS 是现成示例的好来源。

复选框和单选按钮:颜色、大小与清晰度

扁平、极简和方形皮肤用一张小的图片精灵来绘制每个方框:一张图片并排包含未选中、已选中和已禁用的状态,由 CSS 显示其中合适的部分。这带来两个后果:CSS 无法给方框重新着色,而且改变它的 width、height 或缩放比例,会露出相邻的状态,或让它变得模糊、出现像素化。请选择最接近您设计的皮肤颜色,或者改用浏览器自带的方框。

若要使用品牌色或更大的方框,请将单选框和复选框皮肤 (Radio and checkboxes skin) 设为无 (none),并为原生输入框设置样式。accent-color 在所有当前的浏览器中都能为它们着色:

/* Skin "none": colour and size of the browser's own boxes */
.woof .woof_list input.woof_checkbox_term,
.woof .woof_list input.woof_radio_term {
    accent-color: #1f7a4d;
    width: 18px;
    height: 18px;
}

如果这样之后方框仍保持主题的外观,说明主题重新设置了站点上所有复选框的样式;请参阅下面的主题冲突部分。如果您保留某种皮肤,仍然可以通过皮肤类上的 background-image 规则,用相同布局、重新着色的副本替换它的精灵图(图片位于插件的 js/icheck/skins/ 文件夹中),例如 .woof .icheckbox_flat-blue。若要不用 CSS 就实现完全自定义的元素,Smart Designer 扩展可以在后台构建复选框、单选按钮和开关的设计;请参阅如何创建您自己的筛选元素。

皮肤出现之前先闪现普通方框

皮肤由 JavaScript 在页面加载之后应用,所以会有片刻能看到浏览器自带的方框。优化插件造成的 JavaScript 延迟会让这一刻变得更长;请参阅 JavaScript 优化与筛选器。对于无 (none) 以外的任何皮肤,请在皮肤把输入框包裹起来之前先将其隐藏:

/* Only with a skin other than "none": hide inputs until the skin wraps them */
.woof .woof_list li > input.woof_checkbox_term,
.woof .woof_list li > input.woof_radio_term {
    visibility: hidden;
}

皮肤会把每个输入框移入它自己的方框元素中,所以皮肤就绪后,这条规则就不再匹配。如果皮肤设为无 (none),它会让方框永久隐藏,因此不要在那里使用它。

长标签、间距和标签按钮

插件把每个标签显示为紧挨着方框的行内块。当分类或属性的名称比一行还长时,整个标签会掉到复选框下面。根据您想要的外观,使用下面两种修复方法之一:

/* A: the text starts next to the box and wraps underneath it */
.woof .woof_list label {
    display: inline !important;
}

/* B: the text stays in its own column next to the box */
.woof .woof_list label {
    max-width: calc(100% - 35px);
    vertical-align: top;
}

请把 35px 调整为您的方框的宽度。至于间距,插件给每个块 5 px 的底部内边距和 9 px 的底部外边距,给每个标签上下各 4 px 的内边距:

/* Tighter filter: less space between blocks and between items */
.woof .woof_container {
    margin-bottom: 4px;
    padding-bottom: 0;
}
.woof .woof_list label {
    padding-top: 2px;
    padding-bottom: 2px;
}
.woof .woof_checkbox_count {
    margin-left: 6px;
    color: #888;
}

对于标签 (label) 类型(把术语显示为按钮),插件设置了浅灰色方框,以及蓝色的悬停和选中状态。设置相等的宽度和您自己的颜色:

.woof .woof_list_label .woof_label_term {
    min-width: 60px;
}
.woof .woof_list_label li .woof_label_term:hover,
.woof .woof_list_label li .woof_label_term.checked {
    background-color: #1f7a4d;
    border-color: #1f7a4d;
}

子分类的缩进和折叠请参阅可折叠的分类树。

标题:字体、大小和标题标签

块标题是 .woof_container_inner 内的 h4 元素,价格筛选器的标题也不例外,因此它们继承主题的 h4 样式:

.woof .woof_container_inner h4 {
    font-family: inherit;
    font-size: 15px;
    font-weight: 600;
    text-transform: none;
    margin-bottom: 6px;
}

如果要换成其他标签,例如为了适应页面的标题大纲,请使用 woof_title_tag 过滤器。如果标题根本不应是标题,请返回 p 或 span:

/*
 * HUSKY: print filter block titles as <h3> instead of <h4>.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_title_tag', function ($tag) {
    return 'h3';
});

为 h4 编写的规则随后将不再适用:插件自带的外边距、内置 flat_grey 和 flat_dark 筛选器 ID 的标题样式,以及您自己的 CSS。请为新标签重写它们,例如 .woof .woof_container_inner h3。

整个小工具上方的标题则不同。在主题的侧边栏中,它使用主题为所有小工具定义的小工具标题标记;woof_widget_title_tag(默认为 h3)只在小工具不带该标记输出时才适用。若要更改标题的文字而不是样式,请参阅如何重命名筛选器标题。

下拉菜单:原生、Chosen 还是 SelectWoo

当主题的样式与下拉菜单冲突时(文字被截断、多选中的标签位置错乱、颜色不对),请先切换下拉菜单皮肤 (Drop-down skin),再去写 CSS。每种皮肤都是不同的库,换一种之后冲突往往就消失了。使用 woof_use_chosen 过滤器的代码片段已不再产生任何效果;以设置为准。

  • 原生 (Native):浏览器的 select,由您的主题设置样式。目标为 .woof select.woof_select。
  • Chosen:方框是带有 .chosen-single(单选)或 .chosen-choices(多选)的 .chosen-container,展开的列表 .chosen-results li 位于筛选器内部,所以用 .woof 就能限定所有范围。
  • SelectWoo:方框是筛选器内的 .select2-container,但展开的列表附加在页面末尾。针对 .select2-dropdown 的规则无法用 .woof 限定范围,还会影响其他 SelectWoo 字段,例如结账页的国家/地区字段。
/* Chosen: closed box and open list */
.woof .chosen-container-single .chosen-single {
    text-align: left;
    background: #fff;
    border-color: #ccc;
    border-radius: 4px;
}
.woof .chosen-container .chosen-results li {
    font-size: 15px;
    color: #222;
}

工具提示

块标题旁的信息图标,点击后会打开该块工具提示 (Tooltip) 选项中的文字。它使用 Tooltipster 库及其 noir 主题:

.tooltipster-sidetip.tooltipster-noir .tooltipster-box {
    background: #fff;
    border: 1px solid #ddd;
    border-radius: 6px;
}
.tooltipster-sidetip.tooltipster-noir .tooltipster-content {
    color: #333;
    font-size: 14px;
}

工具提示框是空的,或站点上其他位置的工具提示变成灰色方块,意味着页面上的另一个脚本使用了相同或相冲突的工具提示库(已在 Flatsome 主题和产品徽章插件中出现过)。请在设计选项卡中将使用工具提示 (Use tooltip) 设为否 (No);信息图标随后会从筛选器中消失。

出现在颜色和图片色板上方的名称是纯 CSS(p.woof_tooltip span.woof_tooltip_data)。如果这样的名称盖住了相邻的色板并截获了它的点击,请让点击穿过它:

.woof p.woof_tooltip span.woof_tooltip_data {
    pointer-events: none;
}

主题冲突:双重方框、井号和对齐

许多主题会为页面上的每个列表、标签和复选框设置样式,筛选器也不例外。请检查那个多余的元素以找到主题规则,然后只在 .woof 内部把它关掉。

  • 每个条目有两个方框。主题用标签上的伪元素绘制了自己的复选框。HUSKY 的列表不使用伪元素,所以在那里移除它们是安全的:
    .woof .woof_list label::before,
    .woof .woof_list label::after {
        display: none !important;
    }
  • 条目前出现井号、箭头或图标。主题针对小工具列表的规则在每个 li 之前添加了内容:
    .woof .woof_list li::before {
        content: none !important;
    }
  • 整个小工具旁出现项目符号。主题把小工具输出为列表项:li.WOOF_Widget { list-style: none; }。
  • 字段居中或被截断。body .woof .woof_redraw_zone { text-align: left; } 可修复主题造成的居中文字;在侧边栏边缘被截断的内容通常来自小工具上的 overflow: hidden,所以请设置 .widget.WOOF_Widget { overflow: visible; }。
  • 看不见的复选框。主题规则隐藏了输入框或皮肤的方框;请先试试另一种皮肤,再到检查器中查找该规则。

关于移动设备上或搜索进行期间的不同样式,请参阅按设备设置 CSS和筛选时为页面设置样式。

检查清单

  • 在编写 CSS 之前,已在设计选项卡中选好皮肤、下拉菜单皮肤和工具提示。
  • CSS 放在自定义 CSS 代码 (Custom CSS code) 或主题中,而不是插件文件夹里;使用纯规则,不用转义。
  • 每条规则都以 .woof 或 .woof_sid_ 类开头。
  • 品牌色使用皮肤无 (none) 加 accent-color;不要调整精灵图皮肤的大小。
  • 更改 woof_title_tag 之后,已重写针对 h4 的规则。
  • 在评判结果之前,已清除缓存和 CSS 优化。

如果有这些规则未涵盖的特定布局,请在 HUSKY 支持论坛上发布页面链接和对目标外观的描述;关于小型 CSS 自定义的常见问题说明了应当附上哪些内容。