Card

Abstract base for news feed and Content Cards cards. Use subclasses ClassicCard, CaptionedImage, ImageOnly, and ControlCard.

Hierarchy

Index

Properties

expiresAt

expiresAt: Date | null

When this card expires and should stop being shown to the user.

extras

extras: Record<string, string>

Object of string/string key/value pairs. Defaults to empty object {}.

Optional id

id: undefined | string

The id of the card. This will be reported back to Braze with events for analytics purposes.

isControl

isControl: boolean

Whether this card is a ControlCard.

pinned

pinned: boolean

Whether to pin this card to the top of the view.

updated

updated: Date | null

When this card was last modified.

viewed

viewed: boolean

Whether this card has been shown to the user.

Methods

dismissCard

  • dismissCard(): void
  • Call this method if you wish to programmatically remove the card from the feed and log a dismissal. This method is meant to be used with the Braze UI.

    If you are using your own UI, this method will have no effect. Instead, you should use logCardDismissal to log analytics and then remove the card from the DOM manually.

    Returns void

removeAllSubscriptions

  • removeAllSubscriptions(): void
  • Remove all event subscriptions from this message.

    Returns void

removeSubscription

  • removeSubscription(subscriptionGuid: string): void
  • Remove an event subscription that you previously subscribed to.

    Parameters

    • subscriptionGuid: string

      The identifier of the subscription you wish to remove, returned by the method you initially used to create it.

    Returns void

subscribeToClickedEvent

  • subscribeToClickedEvent(subscriber: () => void): string | null
  • Subscribe to receive click events. The subscriber callback will be called whenever this card is clicked by the user.

    Parameters

    • subscriber: () => void

      The callback function to receive click events. This function will be invoked with no arguments when this card records a click.

        • (): void
        • Returns void

    Returns string | null

    The identifier of the subscription created. This can be passed to Card.removeSubscription to cancel the subscription. Returns null if the subscriber passed is not a function.

subscribeToDismissedEvent

  • subscribeToDismissedEvent(subscriber: () => void): string | null
  • Subscribe to receive dismissed events. The subscriber callback will be called whenever this card is dismissed by the user.

    Parameters

    • subscriber: () => void

      The callback function to receive dismissed events. This function will be invoked with no arguments when this card records a dismissal.

        • (): void
        • Returns void

    Returns string | null

    The identifier of the subscription created. This can be passed to Card.removeSubscription to cancel the subscription. Returns null if the subscriber passed is not a function.

Static fromContentCardsJson

  • fromContentCardsJson(jsonData: Record<string, unknown>): Card | undefined
  • Parameters

    • jsonData: Record<string, unknown>

    Returns Card | undefined