Built on WIX Headless

ドキュメント 機能 検索とフィルター

検索とフィルター

CMS for Harmony で、Wix Harmony 上の CMS Table、Repeater、Calendar、Media Gallery、Slideshow コンテンツを訪問者が検索・フィルターできるようにします。

Table、Repeater、Calendar、Chart、Media Gallery、Slideshow は訪問者向けの検索とフィルターに対応し、大きなコレクションもライブサイトで使いやすく保ちます。

フィルター機能

  • フィルターごとのマッチ条件: equals、not equals、contains、starts/ends with、greater/less than、または between
  • 同じフィールドへの複数フィルター
  • 日付と数値の範囲コントロール
  • Show filter と Choose value: 訪問者向けコントロールを表示するか、UI なしで常に固定値を適用するか
  • Reference / Multi-reference フィールド: equals / not equals、または includes / includes all。関連コレクションのオプション付き — オプションラベル用に Display field を選択
  • Color フィールド: Color swatches(および他の選択コントロール)でフィルター
  • サイトフォントを使った検索・フィルター UI のスタイル

Dependent filters

選択フィルターで Dependent filter をオンにすると、検索とこのフィルターより上に並ぶフィルターを適用したあとにまだ存在する値だけに選択肢を絞れます。親フィルターをリストの上側に置き、子フィルターが正しくカスケードするようにします。

This Page slug {#this-page-slug}

Reference / Multi-reference フィールドフィルターで Choose value のとき、固定の関連アイテムの代わりに This Page slug を選べます。ウィジェットは URL から現在のダイナミックページアイテムを解決し(Preview / Editor では Dynamic Page と同じサンプルアイテム)、それをフィルター値に使います。

アイテムページ上の関連リスト/ギャラリー/チャート/カレンダーを、開いているアイテムに紐づく行だけに絞る用途向けです(参照 ID の直書き不要)。

動作詳細
ライブサイト設定した Page path / 照合フィールドの URL からアイテムスラッグを読み取ります
Preview / Editorキャンバスにアイテム URL がないとき、先頭のサンプルアイテムにフォールバック
未解決スラッグ空の一致を適用し、すべてのアイテムを出さないようにします

Table、Repeater、Slideshow、Media Gallery、Calendar、Chart、Dynamic Page(フィールドフィルター)、Harmony Repeater で動作します。Form の Reference / Multi-reference Filter options でも同じ This Page slug を使えます — Form を参照。

相対日付範囲 {#relative-date-ranges}

Choose value モードの DATE / DATETIME フィールドでは、固定日付の代わりに Value type → Relative range を選べます。ライブサイトで範囲が自動適用されます(訪問者向け UI なし)。

範囲内容
Today当日
Next 7 days当日を含む 7 日間
Next 30 days当日を含む 30 日間
This calendar weekWeek starts on で選んだ曜日から 7 日間(日曜〜土曜から選択)
This calendar month当月の 1 日〜末日

ヒント: 金曜始まりのイベント週には Between、Relative range → This calendar week、Week starts on → Friday。

日付の境界(タイムゾーン) {#relative-date-timezone}

Relative range では Date boundaries が「今日」と深夜の基準タイムゾーンを決めます。

オプション動作
Visitor’s device(既定)訪問者ブラウザのカレンダー。
Site timezoneWix Settings → Website settings → Time zone(例 America/Denver)。全訪問者で同じ境界(DST 含む)。
Fixed timezoneIANA ゾーンをドロップダウンから選択(例 GMT-6 — America/Denver)。

範囲・Week starts on・Date boundaries 設定後、パネルにライブプレビューが表示されます。

地域イベント向け: 週次・「今後のみ」フィルターは Site timezone(または都市の Fixed timezone)を推奨 — UTC 深夜での早期切り替えを防ぎます。

条件: 週全体は Between + This calendar week。On or after + Today は当日を含む。After + Today は当日を除外。

Table、Repeater、Calendar、Chart、Media Gallery、Slideshow で Wix CMS と外部データベースに対応。Add as URL query params オン時、相対 Choose value フィルターは URL に含まれません。

Add as URL query params

Add as URL query params をオンにすると、検索とフィルターをページ URL に保持し、訪問者がフィルター済みビューを共有またはブックマークできます。Wix CMS と外部データベース(Google Sheets、Airtable、Notion)で動作します。

Filters display

Filters display を Top(コンテンツの上)または Side(左サイドバー;狭いレイアウトでは上部にフォールバック)に設定します。

注意

  • Calendar では、検索は Title と Details フィールドを見ます。
  • Slideshow では、マッピングされている場合 Title / Text / Button label フィールドを検索に使います。
  • 表示に出ていないフィールドでもフィルターできます。
  • 検索、並べ替え、Dependent filters、Add as URL query params は Wix CMS と外部データベース接続で動作します。
  • v6.0 で Table と Repeater の検索・フィルターの保存方法が変わりました。メジャー更新後は、既存ウィジェットのフィルター設定を再確認してください。
  • Dynamic Page は関連する書式オプション(値式など)を共有しますが、訪問者向けの検索/フィルターは含みません。

コレクション接続後、各ウィジェットパネルでフィルターを設定してください — Search & filters(Show search bar、Show filters button、Filters display、Add as URL query params、フィルターごとの Dependent filter を含む)を探してください。

FAQ

Which widgets support search and filters?

Table, Repeater, Calendar, Chart, Media Gallery, and Slideshow (plus Harmony Repeater).

What is This Page slug?

A Choose value option on Reference / Multi-reference filters that tracks the current dynamic-page item — see This Page slug.

Do filters work with Google Sheets?

Yes on supported display widgets connected to an external database.