Skip to main content
⚠️ 重要なお知らせ これらのセレクターは、Upcart カートモジュールのバージョン 2(V2)のみに適用されます。**バージョン 1(V1)**を使用している場合、これらのセレクターは機能しません。 V1 のカートについては、レガシーのモジュール構造とセレクターを扱う **バージョン 1 CSS セレクターのドキュメント**を参照してください。 使用中のバージョンを確認するには、カートエディターを開き、左側メニューの上部を確認します。カート内のすべてのモジュールが V2 になると、そこに Cart version ドロップダウンが表示されます。表示されない場合、カートにはまだ V1 モジュールが含まれています。V1 から V2 への移行の詳細については、V2.0 移行ガイドを参照してください。

概要

価格の非表示、テキストサイズの調整、ボタンの再配置など、カートの外観を変更したい場合は、ここから始めましょう。この CSS セレクターライブラリは、独自のカスタムコードでこうした変更を行うために必要なツールを提供します。 この記事では、利用可能なすべての CSS セレクターをグループごとにまとめ、スタイルの作成とテストに役立つリソースへのリンクも掲載しています。

このライブラリは便宜のために提供していますが、Upcart サポートチームは**カスタムコードの作成や修正のお手伝いはできません。**これは当社のカスタマイズポリシーの一部です。 カスタムコードのソリューションについては、Shopify エキスパートへの相談をおすすめします。 Shopify エキスパートを見る

Upcart CSS セレクターの使い方

この記事は、Upcart のカートドロワーのスタイリングやカスタマイズに使える CSS セレクターのライブラリです。各セレクターは、ヘッダー、商品行、アップセル、リワードモジュールなど、カートの特定の部分を対象としています。 これらのセレクターを使用して、次のことができます:
  • 要素の非表示や再スタイリング
  • 余白、フォント、色の変更
  • ストアのブランディングに合わせたレイアウトの調整
CSS を適用するには、カートエディターを開き、Settings に移動して Custom CSS タブを選択し、エディターにスタイルを貼り付けます。

CSS を追加する前に知っておくべきこと

カスタムスタイルの作成に取りかかる前に、スムーズに進めるためのヒントをいくつか紹介します。これらを参考にすると、変更のテストが容易になり、予期しない事態を避け、カートを壊すことなく望みどおりの見た目を実現できます。

CSS カスタマイズのチェックリスト:

  • 安全な環境でテストする: 本番公開する前に、可能であればプレビューまたは未公開のテーマを使用してください。
  • 小さく始める: 一度に 1 つの変更を行うことで、何がうまくいったか(あるいはいかなかったか)を追跡しやすくなります。
  • 正しい場所にスタイルを貼り付ける: コードの追加には Upcart Editor > Settings > Custom CSS フィールドを使用してください。
  • 検証ツールを使う: ブラウザで要素を右クリックして検証を選択し、セレクターをその場で見つけてテストします。
  • 思い込みを避ける: すべての要素がすべてのカートに表示されるわけではありません。さまざまなカート(リワードあり/なし、アップセルあり/なしなど)でテストしてください。
以下のセレクターは、Upcart カートモジュールのバージョン 2 で機能します。V2 では、publicinternal のクラスプレフィックスによる構造化された命名システムが導入されています。

V2 セレクターに関する重要なガイドライン

⚠️ カスタマイズには public セレクターのみを使用してください
  • Public セレクター(プレフィックスが upcart-public-)は安定した API の一部であり、カスタムスタイリングに安全に使用できます
  • Internal セレクター(プレフィックスが upcart-internal-)は内部使用のために予約されており、予告なく変更される可能性があります
推奨: スタイリングには public クラス名を使用する
非推奨: internal クラス名の上書きや、深い階層のセレクターの使用

CSS セレクター

汎用コンポーネント

ヘッダーモジュール

アナウンスメントモジュール

レコメンデーションおよびアップセルモジュール

メモモジュール

ディスカウントコードモジュール

トラストバッジモジュール

階層型リワードモジュール

カートアイテムモジュール

アドオンモジュール

エクスプレス決済モジュール

カートサマリーモジュール

はじめるのに役立つリソース: