Skip to main content
이 페이지는 @whop/elements@1.10.0 및 @whop/elements-react@1.10.0을 다룹니다.
v1.0.0부터 지원.
Wallet 안에 마운트됩니다. accountId와 accessToken은 그곳에서 가져옵니다. props와 콜백은 생성 옵션 또는 React props로 전달합니다. refresh()와 setDateRange()를 호출하려면 생성된 핸들 또는 React ref를 보관하세요.
뷰 계층 구조의 어디에나 마운트됩니다. accountId를 받아 자체 데이터를 로드하며, 클로저도 전달하면 뷰어가 탭한 행을 받을 수 있습니다.

예시 데이터입니다. Playground 열기.

Props

string
이 통화의 활동만 표시합니다. 지정하지 않으면 모든 통화의 활동이 표시됩니다.
string
읽기에 사용하는 범위 지정 토큰입니다. 계정에는 company:balance:read가, 사용자에게는 user:balance:read가 필요합니다. 서버에서 POST /api/v1/access_tokens로 발급하세요. 없으면 읽기에 뷰어 자신의 세션이 사용되며, 이는 동일 출처에서만 작동합니다.
number
최근 활동 미리보기를 위해 최대 이 개수만큼의 행만 표시하고 페이지 로딩을 멈춥니다. 목록에 See all activity 컨트롤이 추가되며, 이 컨트롤은 페이지를 이동하는 대신 seeAllRequested를 보고합니다.
boolean
끄면 카드 거래 행이 activitySelected를 발생시키지 않고 비활성 상태(클릭 및 호버 없음)로 렌더링됩니다. 뷰어가 해당 세부 정보를 볼 권한이 없다는 것을 알고 있을 때 사용하세요. 기본값은 true입니다.
string[]
엘리먼트가 마운트되거나 계정이 바뀔 때 선택되는 활동 유형입니다. 뷰어는 기본 제공 필터로 이를 변경할 수 있습니다. 기본값은 []입니다.
boolean
뷰어가 필터링하지 않는 간결한 목록을 위해 필터 칩을 숨깁니다. 기본값은 false입니다.

이벤트

생성 옵션 또는 React props로 콜백을 전달합니다.

onActivitySelected

행이 클릭되었습니다. 해당 행에 대한 자체 상세 화면이나 경로를 여세요. 엘리먼트는 절대 페이지를 이동하지 않습니다.
object

onActivityHovered

포인터가 행에 들어오거나 행에서 벗어났습니다(null). 잔액 차트에서 해당 행을 표시하는 것처럼, 같은 시점을 자체 UI에서도 가리키세요.
object | null

onSeeAllRequested

뷰어가 maxItems 목록에서 See all activity를 눌렀습니다. 자체 전체 활동 화면을 여세요. 엘리먼트는 절대 페이지를 이동하지 않습니다.

onDateRangeChanged

뷰어가 setDateRange가 아닌 필터 칩을 통해 날짜 필터를 변경했습니다. 차트 브러시처럼 더 이상 일치하지 않는 자체 범위 선택을 지우세요.
object

onLoaderStart

로딩 스켈레톤이 처음 그려진 후, onReady 전에 실행됩니다.

onReady

엘리먼트가 처음으로 완전히 그려진 후 실행됩니다.

onError

엘리먼트가 로드에 실패하거나 충돌할 때 실행됩니다. 대체 화면은 계속 표시됩니다. 프로그래밍 방식으로 처리하려면 code를 사용하세요. sourceKey는 실패한 호스트 상태 소스를 식별합니다.
object

메서드

create가 반환한 핸들에서, 또는 React ref를 통해 호출합니다.

refresh

계정의 활동을 첫 페이지부터 다시 가져옵니다. 다른 곳에서 변경(입금, 송금)이 일어난 후 호출하면 캐시가 만료될 때까지 기다리지 않고 목록에 반영됩니다.반환값 Promise<void>

setDateRange

엘리먼트 외부에서 날짜 필터를 설정합니다. 예를 들어 차트 브러시 선택을 목록에 연결할 수 있습니다. 지우려면 null을 전달하세요.매개변수
ActivityDateRangeOverride | null
필수
반환값 Promise<void>

mount

target에 엘리먼트를 마운트하고 로딩을 시작합니다. React 컴포넌트는 자동으로 마운트됩니다.매개변수
string | HTMLElement
필수

destroy

엘리먼트를 제거하고 프레임과 구독을 해제합니다. 여러 번 호출해도 됩니다. React는 엘리먼트를 자동으로 제거합니다.

update

마운트된 엘리먼트에 새 props를 병합합니다. React에서는 대신 컴포넌트 props를 변경하세요.매개변수
Partial<ActivityElementProps>
필수

스타일링

appearance.classes를 통해 다음 부분의 스타일을 지정합니다. 속성 이름은 카멜 케이스 또는 케밥 케이스를 사용하고 단위를 포함하세요. 페이지 스타일시트는 엘리먼트의 프레임에 적용되지 않습니다. 프레임워크는 각 선언을 삽입하기 전에 유효성을 검사합니다.
React에서는 appearance를 <Wallet>에 전달합니다. 전역으로 설정하려면 WhopElements({ appearance })를 사용하세요.

매개변수

String
필수
목록을 표시할 원장의 소유자입니다. biz_ 접두사가 붙은 계정 ID 또는 user_ 접두사가 붙은 사용자 ID를 사용하세요. 피드는 원장을 먼저 확인하지 않고 ID를 읽으므로 둘 다 바로 작동합니다.
Bool
기본 제공 “Activity” 제목을 표시합니다. 기본값은 true입니다. 화면에 이미 제목이 있다면 끄세요.
((WalletActivity) -> Void)?
뷰어가 탭한 행과 함께 호출됩니다. 뷰는 절대 페이지를 이동하지 않으므로 자체 상세 화면으로 라우팅하세요.

WalletActivity

선택 시 반환되는 값:
  • id: String: 행마다 안정적인 값
  • title: String / subtitle: String: 행의 두 줄
  • amount: Decimal: 부호 있는 값이며, 나가는 돈은 음수
  • currencyCode: String
  • postedAt: Date
  • isIncoming: Bool

상태

첫 페이지가 로드되는 동안 스켈레톤 목록을, 원장에 거래가 없으면 No activity found를, 읽기에 실패하면 실패 메시지와 Try again 버튼을 표시합니다. 이후 페이지 로드에 실패하면 이미 로드된 행은 화면에 남고 하단에 Try again이 표시됩니다.

알아두면 좋은 점

  • 스크롤 컨테이너 안에 두세요. 피드는 LazyVStack이며 마지막 행이 나타날 때 다음 페이지를 불러오므로, ScrollView 밖에서는 첫 페이지만 렌더링하고 다른 페이지를 로드하지 않습니다.
  • biz_… 및 user_… 태그를 직접 받으므로, 다른 지갑 뷰와 달리 원장을 먼저 확인할 필요가 없습니다.
앱 실행 시 WhopSDK.configure(tokenProvider:)를 한 번 호출하세요. 뷰는 토큰을 기다립니다. 시작하기를 참고하세요. 테마는 .whopTheme(_:)로 적용합니다.