Built on WIX Headless

Repeater 위젯

Wix Harmony에서 CMS 컬렉션 항목을 카드, 목록 또는 그리드로 표시합니다. Repeater 패널에서 모든 설정을 찾아보세요.

Repeater 위젯은 제품, 사람, 프로젝트, 목록 등의 항목 컬렉션을 반복 카드로 표시합니다. 각 카드에는 이미지, 제목, 설명, 태그 및 기타 필드가 표시될 수 있습니다. 방문자는 검색, 필터링, 빠른 보기 열기, 항목 페이지로 이동 또는 결제가 활성화된 경우 결제할 수 있습니다.

CMS for Harmony에서 ‘카드’는 별도의 위젯이 아닌 Repeater 레이아웃을 의미합니다. 앱은 데이터를 기본 Harmony 텍스트, 이미지 또는 버튼 요소가 아닌 이 위젯(및 다른 CMS for Harmony 디스플레이)에 바인딩합니다.

비디오 튜토리얼

<아이프레임 src="https://www.youtube.com/embed/gT7FegMAcTI" title="CMS for Harmony에 Repeater 위젯 추가 및 구성" allow="가속도계; 자동 재생; 클립보드 쓰기; 암호화된 미디어; 자이로스코프; PIP(picture-in-picture); 웹 공유" 전체 화면 허용 >

YouTube에서 시청하세요⟧

사용 사례 예

  • Products 카탈로그 — 이미지, 이름, 가격, 카테고리와 함께 제품을 표시합니다. 방문자는 카테고리 또는 가용성별로 필터링하고 Quick view를 열고 Add to cart / Buy now를 사용합니다.
  • 팀 디렉터리 — 사진, 역할, 부서, 연락처 필드가 포함된 검색 가능한 사람 그리드입니다.
  • 부동산 목록 — 사진, 위치, 가격 및 세부정보가 포함된 Pro퍼티 카드. 유형, 지역 또는 가격대별로 필터링하세요. 각 카드를 Dynamic Page에 연결하세요.
  • 포트폴리오 또는 사례 연구 — Pro표지 이미지, 태그, 전체 항목 페이지를 여는 짧은 요약이 포함된 카드를 선택합니다.

Repeater 구성

AI로 구축: 모든 것을 수동으로 구성하는 대신 패널 상단에서 AI setup를 열고 원하는 내용을 설명하세요. 예를 들어 “사진, 이름, 역할, 부서 필터가 포함된 3열 그리드에 팀 구성원을 표시합니다.” 그런 다음 Manual에서 구체화합니다. 세부정보: AI setup.

  1. 추가 → Elements → Installed Apps → CMS for Harmony에서 Repeater를 추가합니다(한 번 이상 추가 가능).
  2. 위젯을 선택 → 열기 Settings.
  3. 컨텐트에서 데이터 소스를 연결하고 필드를 선택합니다.
  4. 선택적으로 검색 및 필터, Quick view, 동적 페이지, 액세스 (Pro), 결제, Formatting, 레이아웃, 디자인 및 모바일.
  5. 사이트를 게시합니다.

내용

위치: Manual 개요 → 콘텐츠 드릴 행

어디: Settings → 콘텐츠

중계기를 데이터에 연결하고 각 카드에 표시되는 내용을 선택하세요.

  1. 데이터 소스를 Wix CMS 또는 External Database(Google Sheets, Airtable 또는 Notion - External databases 참조)로 설정합니다.
  2. 컬렉션(Wix CMS) 또는 외부 연결을 선택합니다.
  3. 표시할 필드에서 각 카드에 표시되어야 하는 필드를 선택합니다. 주문 및 표시 옵션은 Formatting 아래에 있습니다.
  4. 로드할 항목(1~50)을 설정합니다. 컬렉션에 더 많은 항목이 있으면 페이지 매김이 자동으로 나타납니다.
  5. 선택적으로 페이지 변경 시 위로 스크롤을 켜면 이전/다음이 위젯의 ​​상단을 계속 표시합니다.
  6. 정렬 기준 및 정렬 순서(유형 인식: A→Z, 최신 항목순 등)를 선택합니다.

일부 옵션은 데이터 원본에 따라 다릅니다. Quick view, 동적 페이지 링크 및 카탈로그 결제에는 Wix CMS 컬렉션이 필요합니다.

Form아팅

위치: Manual 개요 → Formatting 드릴 행 → 표시 이름으로 필드 확장

위치: Settings → Formatting → 표시 이름으로 필드 확장

콘텐츠에서 선택한 필드가 필요합니다. 전체 참조: 필드 형식.

공유 필드 스타일 (v19+)

Style 또는 Link style로 Text, Number, URL / link, Image 등 서식을 한 번 저장해 여러 필드에서 재사용합니다. This field only는 해당 필드만 인라인으로 유지합니다.

액세스

위치: Settings → 접속 (Pro)

라이브 사이트에서 로그인한 회원이나 선택된 요금제 보유자에게만 카드를 표시하거나 고정 항목 규칙으로 개별 카드를 보호하세요. 차단된 메시지와 선택적 로그인 버튼의 스타일을 지정하세요. 콘텐츠 액세스를 참조하세요.

검색 및 필터

위치: Manual 개요 → 검색, 필터 및 정렬 드릴 행(한 곳에서 검색, 필터 및 방문자 정렬)

위치: Settings → 검색 및 필터

전체 참조: 검색 및 필터.

Quick view

위치: Settings → Quick view (Wix CMS 전용)

전체 참조: Quick view.

동적 페이지

위치: Settings → 동적 페이지 (Wix CMS 전용)

방문자를 카드에서 Dynamic Page 템플릿의 해당 항목 URL로 보냅니다. 개요: 동적 페이지.

  1. 컬렉션이 아직 동적이 아닌 경우 컬렉션을 동적으로 만들기를 사용하세요.
  2. 항목 페이지 링크를 켭니다.
  3. 링크 스타일을 전체 카드 또는 버튼으로 설정합니다.
  4. 페이지 경로 및 페이지 링크 필드를 Dynamic Page 설정에 일치시킵니다.
  5. 열기: 동일 탭 또는 새 탭을 선택합니다.

링크는 편집기 샌드박스에서 다르게 동작합니다. 라이브 사이트에서 Open in을 팔로우합니다.

결제

위치: Settings → 결제 (Pro)

컬렉션에 카탈로그 결제가 활성화된 경우 각 카드에 결제 작업을 표시합니다.

  1. 콘텐츠에서 Wix CMS 컬렉션을 연결합니다.
  2. 필요한 경우 Enable payments을 사용하여 컬렉션을 카탈로그로 전환하세요.
  3. 결제 작업 표시를 켭니다.
  4. 작업에서 Add to cart 및/또는 Buy now을 활성화합니다.

Pro가 없으면 섹션에 업그레이드 프롬프트가 표시됩니다. External databases는 카탈로그 결제를 지원하지 않습니다.

데이터 새로고침

위치: Settings → 데이터 새로고침

전체 참조: 데이터 새로고침.

레이아웃

위치: Settings → 레이아웃

  1. 카드 레이아웃 설정:
    • 표준 — 필드는 기본 카드 순서로 스택됩니다.
    • 맞춤 — 필드 정렬을 클릭하고 각 카드 내부의 그리드에 필드를 배치합니다.
  2. Repeater 레이아웃 설정:
    • 그리드 — 그런 다음 열 설정
    • 목록 — 그런 다음 목록 방향(왼쪽에서 오른쪽 또는 위에서 아래)을 설정합니다.
    • 행 — 수평 카드 스트립
  3. 카드 너비(늘이기 또는 고정), 정렬, 항목 사이의 간격, 각 카드 내부의 카드 간격을 조정합니다.

디자인

장소: Settings → 디자인

  1. 위젯 배경을 설정하세요.
  2. 카드 배경 설정:
    • 단색 — 모든 카드에 하나의 색상이 적용됩니다.
    • 필드의 이미지 — 각 카드는 이미지 또는 비디오 필드를 사용합니다. 이미지가 없는 항목에 대해 맞춤(덮기, 포함 또는 늘이기), 초점 및 대체 색상을 설정하세요.
  3. 검색, 필터, 페이지 매기기 및 유사한 크롬(사이트 글꼴)에 대한 스타일 UI 텍스트.
  4. 테두리(색상, 너비, 반경), 카드 패딩 및 그림자(없음/부드러움/중간/강함)를 조정합니다.

모바일

장소: Settings → 모바일

  1. 작은 화면에서 설정:
    • 목록으로 스택
    • 가로 스크롤(스냅 및 컨트롤 포함)
    • 데스크탑 레이아웃 유지
  2. 모바일 레이아웃이 시작되는 중단점(320~1200픽셀)을 설정합니다.

FAQ

‘카드’는 별도의 위젯인가요?

아니요. 카드는 Repeater 레이아웃을 의미합니다.

각 카드에 이미지나 동영상 배경을 사용할 수 있나요?

예. 컬렉션 이미지 또는 동영상 필드에서 카드 배경을 설정하세요.

Repeater는 Quick view 및 결제를 지원하나요?

Wix CMS에서는 가능 — Quick view 및 Pro 카탈로그 결제.