HUSKY - WooCommerce Product Filter Professional

WooCommerce商品フィルターのCSSカスタマイズ:スキン・タイトル・修正

WooCommerce商品フィルターのCSSカスタマイズは、たいてい小さな要望から始まります。チェックボックスをブランドカラーにしたい、タイトルを小さくしたい、ドロップダウンをテーマに合わせたい、あるいはテーマがチェックボックスごとに2つ目のボックスを描画してしまう問題を直したい、といったものです。HUSKYではその一部を設定で変更でき、残りはCSSを数行追加すれば対応できます。どこに書き、どのクラスを対象にすればよいかがわかればすぐです。このガイドでは両方を説明し、最もよく見かけるテーマとの競合の修正方法も紹介します。

まず設定、次にCSS

デザインタブ(WooCommerce → 設定 → Products Filter → デザイン (Design))では、コードなしで見た目を変更できます。

  • ラジオボタンとチェックボックスのスキン (Radio and checkboxes skin):フラット、ミニマル、スクエアの各スキンを10色から選べます。ブラウザー標準のボックスを使う場合は なし (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タグは設定の保存時に削除され、バックスラッシュも確実には保持されません。そのため、\2713 のようなCSSエスケープではなく、記号を直接書いてください(content: "✓")。カスタマイザーのテーマの 追加CSS (Additional CSS) や子テーマのスタイルシートでも同様に機能します。プラグインの css/front.css は編集しないでください。次回の更新で置き換えられます。

デザインタブの末尾にある カスタムフロントCSSスタイルファイルのリンク (Custom front css styles file link) は別の仕組みです。front.css に追加で読み込むのではなく、その代わりに指定したファイルを読み込みます。プラグインのファイルのコピーから始めて全面的に書き換える場合にのみ使用してください。

自分のルールを優先させる

テーマのスタイルシートはプラグインより後に読み込まれ、長いセレクターを使うことが多く、プラグインのルールの一部には !important が付いています。すべてのルールを .woof で始め、それでもテーマが優先される場合は body .woof にしてください。!important を付けるのは、プラグインやテーマがすでに使っている箇所だけにします。1つのフィルターだけをスタイルして他に影響しないようにするには、sid 属性でIDを付けます。[woof sid="sidebar"] は、フォームにクラス woof_sid_sidebar を追加します。IDはスペースを含まない1語にしてください。3つの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>
1つのフィルターブロック.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は、すぐに使える例の宝庫です。

チェックボックスとラジオボタン:色、サイズ、鮮明さ

フラット、ミニマル、スクエアの各スキンは、小さな画像スプライトから各ボックスを描画します。1枚の画像に未チェック、チェック済み、無効の各状態が横に並んでおり、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;
}

これでもボックスがテーマの見た目のままなら、テーマがサイト上のすべてのチェックボックスを再スタイルしています。後述の「テーマとの競合」の項を参照してください。スキンを使い続ける場合でも、スキンのクラス(例:.woof .icheckbox_flat-blue)に background-image ルールを指定して、同じレイアウトで色を変えたスプライトのコピーに置き換えることができます(画像はプラグインの js/icheck/skins/ フォルダーにあります)。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) にしている場合は、ボックスが常に非表示になってしまうため、使用しないでください。

長いラベル、間隔、ラベルボタン

プラグインは各ラベルを、ボックスの隣のインラインブロックとして表示します。カテゴリー名や属性名が行より長いと、ラベル全体がチェックボックスの下に回り込みます。希望する見た目に応じて、次の2つの修正方法のどちらかを使ってください。

/* 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 は、ボックスの幅に合わせて調整してください。間隔については、プラグインは各ブロックに下側5pxのパディングと9pxのマージンを、各ラベルに上下4pxのパディングを設定しています。

/* 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)が適用されるのは、そのマークアップなしでウィジェットが出力される場合のみです。タイトルのスタイルではなくテキストを変更するには、フィルタータイトルの名前を変更する方法を参照してください。

ドロップダウン:Native、Chosen、SelectWoo

テーマのスタイルがドロップダウンと衝突する場合(テキストが切れる、複数選択でタグの位置がずれる、色が正しくないなど)は、CSSを書く前に ドロップダウンのスキン (Drop-down skin) を切り替えてください。各スキンは別のライブラリであり、別のスキンにすると衝突が解消されることがよくあります。woof_use_chosen フィルターを使うスニペットはもう何も変更せず、設定が優先されます。

  • Native:ブラウザー標準の select で、スタイルはテーマに従います。対象は .woof select.woof_select です。
  • Chosen:ボックスは .chosen-container で、単一選択は .chosen-single、複数選択は .chosen-choices を持ちます。開いたリスト .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 の内側でのみそのルールを無効にしてください。

  • 項目ごとに2つのボックスが表示される。テーマがラベルの疑似要素で独自のチェックボックスを描画しています。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サポートフォーラムに投稿してください。含めるべき内容は、FAQ「小さなCSSカスタマイズ」で説明しています。