Référence du thème par défaut
Cette entrée contient la documentation de tous les composants de notre thème par défaut.
Liens rapides
- address-fields
- address-formatted
- authentication-view
- base-button
- base-layout-sidebar
- billing
- billing-completed
- button-danger
- button-icon
- button-link
- button-primary
- button-secondary
- card-icon
- card-product
- cart
- cart-header
- cart-summary
- cart-summary-expanded-item
- cart-summary-item
- cart-summary-items-list
- change-password-form
- checkout
- checkout-step
- close-cart-action
- close-side-cart-action
- customer-account-link
- customer-details
- customer-details-group
- customer-notification
- customer-notifications-list
- dashboard
- dashboard-home
- disabled-checkout-step
- discount-box
- edit-customer-address-form
- edit-shipping-address-button
- empty-cart
- error-message
- fancy-select
- featured-payment-methods
- flash-message
- forgot-password-form
- guest-checkout
- icon
- item-custom-fields
- item-description
- item-image
- item-line
- item-list
- item-quantity
- layout
- loading-component
- loading-overlay
- loading-screen
- media
- open-side-cart-action
- order
- order-payment-details
- orders-list
- paginated-list
- payment
- payment-completed
- payment-details
- payment-form
- payment-info
- payment-methods-list
- payment-methods-list-item
- rectify-cart-action
- register-form
- reset-password-form
- shipping
- shipping-address
- shipping-completed
- shipping-method
- shipping-rates-list
- shipping-rates-list-item
- show-cart-action
- show-detailed-cart-action
- sign-in-action
- sign-out-action
- signin-form
- snipcart-address-autocomplete
- snipcart-checkbox
- snipcart-field-error
- snipcart-form
- snipcart-form-error
- snipcart-hidden-autofill
- snipcart-input
- snipcart-label
- snipcart-password
- snipcart-radio
- snipcart-select
- snipcart-submit
- snipcart-textarea
- snipcart-typeahead
- spinner
- subscription
- subscriptions-list
- summary-fees
- tab
- tabs
- textbox
- tool-tip
address-fields
Displays a form to edit an address.
Usage of address-fields
<address-fields type="<>" initialAddress="<Address>"> </address-fields>
type:
initialAddress: Address
Default Template
address-formatted
Usage of address-formatted
<address-formatted address="<Address>"> </address-formatted>
address: Address
Default Template
authentication-view
Usage of authentication-view
<authentication-view> </authentication-view>
Default Template
base-button
Usage of base-button
<base-button icon="<string>" label="<string>" labelLoading="<string>" labelError="<string>" labelSuccess="<string>" type="<ButtonTypes>" state="<BaseButtonStates>" hasIconLeft="<boolean>" isFitContent="<boolean>"> </base-button>
icon: string
label: string
labelLoading: string
labelError: string
labelSuccess: string
type: ButtonTypes
state: BaseButtonStates
hasIconLeft: boolean
isFitContent: boolean
Default Template
base-layout-sidebar
Usage of base-layout-sidebar
<base-layout-sidebar> </base-layout-sidebar>
Default Template
billing
Component that gathers billing address and customer information
Usage of billing
<billing> </billing>
Default Template
billing-completed
Usage of billing-completed
<billing-completed context="<string>"> </billing-completed>
context: string – Context in which this component is rendered
Default Template
button-danger
Usage of button-danger
<button-danger icon="<string>" label="<string>" labelLoading="<string>" labelError="<string>" labelSuccess="<string>" type="<ButtonTypes>" state="<BaseButtonStates>" hasIconLeft="<boolean>" isFitContent="<boolean>"> </button-danger>
icon: string
label: string
labelLoading: string
labelError: string
labelSuccess: string
type: ButtonTypes
state: BaseButtonStates
hasIconLeft: boolean
isFitContent: boolean
Default Template
button-icon
Usage of button-icon
<button-icon url="<string>" icon="<string>" label="<string>" styling="<BaseButtonStyles>" state="<BaseButtonStates>" isSmall="<boolean>"> </button-icon>
url: string
icon: string
label: string
styling: BaseButtonStyles
state: BaseButtonStates
isSmall: boolean
Default Template
button-link
Usage of button-link
<button-link label="<string>" type="<ButtonTypes>"> </button-link>
label: string
type: ButtonTypes
Default Template
button-primary
Usage of button-primary
<button-primary icon="<string>" label="<string>" labelLoading="<string>" labelError="<string>" labelSuccess="<string>" type="<ButtonTypes>" state="<BaseButtonStates>" hasIconLeft="<boolean>" isFitContent="<boolean>"> </button-primary>
icon: string
label: string
labelLoading: string
labelError: string
labelSuccess: string
type: ButtonTypes
state: BaseButtonStates
hasIconLeft: boolean
isFitContent: boolean
Default Template
button-secondary
Usage of button-secondary
<button-secondary icon="<string>" label="<string>" labelLoading="<string>" labelError="<string>" labelSuccess="<string>" type="<ButtonTypes>" state="<BaseButtonStates>" hasIconLeft="<boolean>" isFitContent="<boolean>"> </button-secondary>
icon: string
label: string
labelLoading: string
labelError: string
labelSuccess: string
type: ButtonTypes
state: BaseButtonStates
hasIconLeft: boolean
isFitContent: boolean
Default Template
card-icon
Usage of card-icon
<card-icon> </card-icon>
card-product
Usage of card-product
<card-product itemKey="<string>" name="<string>" image="<string>" quantity="<number>" price="<number>" currency="<string>" fileGuid="<string>" url="<string>"> </card-product>
itemKey: string
name: string
image: string
quantity: number
price: number
currency: string
fileGuid: string
url: string
Default Template
cart
Usage of cart
<cart isSideCart="<boolean>" editingCart="<boolean>"> </cart>
isSideCart: boolean
editingCart: boolean – Indicates if the cart is currently opened as a side-panel over the checkout screen.
Default Template
cart-header
Component that shows the number of items in the cart and a way to close the cart.
Usage of cart-header
<cart-header title="<string>" showItemsCount="<boolean>" showAccountMenu="<boolean>" showSummary="<boolean>" showAccountLink="<boolean>" backButtonTitle="<string>"> </cart-header>
title: string
showItemsCount: boolean
showAccountMenu: boolean
showSummary: boolean
showAccountLink: boolean
backButtonTitle: string
Default Template
cart-summary
Usage of cart-summary
<cart-summary isSideCart="<boolean>"> </cart-summary>
isSideCart: boolean
Default Template
cart-summary-expanded-item
Usage of cart-summary-expanded-item
<cart-summary-expanded-item item="<CartItem>"> </cart-summary-expanded-item>
item: CartItem
Default Template
cart-summary-item
Component that renders an item from `CartSummaryItemsList` component.
Usage of cart-summary-item
<cart-summary-item item="<CartItem>"> </cart-summary-item>
item: CartItem – The item associated to the component instance.
Default Template
cart-summary-items-list
This component renders the list of items in the cart for the summary visible during checkout process.
Usage of cart-summary-items-list
<cart-summary-items-list tag="<string>" itemTemplate="<string>"> </cart-summary-items-list>
change-password-form
Usage of change-password-form
<change-password-form> </change-password-form>
Default Template
checkout
Usage of checkout
<checkout> </checkout>
Default Template
checkout-step
Usage of checkout-step
<checkout-step number="<string>" name="<string>" title="<string>"> </checkout-step>
close-cart-action
Usage of close-cart-action
<close-cart-action> </close-cart-action>
close-side-cart-action
Usage of close-side-cart-action
<close-side-cart-action> </close-side-cart-action>
customer-account-link
Usage of customer-account-link
<customer-account-link> </customer-account-link>
customer-details
Usage of customer-details
<customer-details> </customer-details>
Default Template
customer-details-group
Usage of customer-details-group
<customer-details-group iconName="<string>" title="<string>" action="<CustomerDetailsAction>" handleActionClick="<any>"> </customer-details-group>
iconName: string
title: string
action: CustomerDetailsAction
handleActionClick: any
Default Template
customer-notification
Usage of customer-notification
<customer-notification notification="<CustomerNotificationDto>"> </customer-notification>
notification: CustomerNotificationDto
customer-notifications-list
Usage of customer-notifications-list
<customer-notifications-list notifications="<>"> </customer-notifications-list>
notifications:
dashboard
Usage of dashboard
<dashboard> </dashboard>
Default Template
dashboard-home
Usage of dashboard-home
<dashboard-home> </dashboard-home>
Default Template
disabled-checkout-step
Usage of disabled-checkout-step
<disabled-checkout-step error="<>"> </disabled-checkout-step>
error:
discount-box
Usage of discount-box
<discount-box> </discount-box>
edit-customer-address-form
Usage of edit-customer-address-form
<edit-customer-address-form addressType="<>"> </edit-customer-address-form>
addressType:
Default Template
edit-shipping-address-button
Usage of edit-shipping-address-button
<edit-shipping-address-button> </edit-shipping-address-button>
empty-cart
Usage of empty-cart
<empty-cart> </empty-cart>
Default Template
error-message
Usage of error-message
<error-message title="<string>" description="<string>" technicalDetail="<string>" actionRequired="<boolean>" showTechnicalDetail="<boolean>"> </error-message>
title: string
description: string
technicalDetail: string
actionRequired: boolean
showTechnicalDetail: boolean
Default Template
fancy-select
Usage of fancy-select
<fancy-select searchProvider="<>" options="<>" id="<string>" name="<string>" enableAutofill="<boolean>" value="<>" styleAutofilled="<{}>" persistSearchResults="<boolean>" useSoftSuggestions="<boolean>" label="<string>" isValid="<boolean>"> </fancy-select>
featured-payment-methods
Component that shows the list of accepted payment methods. You must override this component if you want to change this list.
Usage of featured-payment-methods
<featured-payment-methods> </featured-payment-methods>
Default Template
flash-message
Component that displays error messages
Usage of flash-message
<flash-message title="<string>" type="<string>" description="<string>" icon="<string>"> </flash-message>
title: string – Title of the error
type: string – One of 'success', 'error', 'info'
description: string – Description of the error
icon: string – Icon of the error
Default Template
forgot-password-form
Usage of forgot-password-form
<forgot-password-form> </forgot-password-form>
Default Template
guest-checkout
Usage of guest-checkout
<guest-checkout> </guest-checkout>
Default Template
icon
Display one of the built-in icons
Usage of icon
<icon name="<string>" custom="<boolean>" tooltip="<string>" width="<number>" height="<number>" alt="<string>"> </icon>
name: string – Name of the icon to show
Can be one of:
alert
,back-arrow
,box
,cart
,checkmark
,chevron-down
,chevron-up
,continue-arrow
,green-check
,location
,lock
,mastercard
,minus
,password
,pin
,plus
,trash
,user
,visa
,spinner
,spinner-white
,question-mark
,front
,console
,sign-out
,discount
,cross
,card-amex
,card-dinersclub
,card-discover
,card-elo
,card-hipercard
,card-jcb
,card-maestro
,card-mastercard
,card-mir
,card-unionpay
,card-unknown
,card-visa
,card-alipay
,card-verve
,card-paypal
,card-dankort
,card-uatp
,method-apple_pay
,method-bancontact
,method-belfius
,method-card
,method-eps
,method-giropay
,method-ideal
,method-ing_home_pay
,method-kbc
,method-klarna_pay_later
,method-klarna_slice_it
,method-p24
,method-paypal
,method-bank_transfer
,method-sofort
,method-paypal_express_checkout
,method-bank_transfer
,alert
,back-arrow
,box
,cart
,checkmark
,chevron-down
,chevron-up
,continue-arrow
,green-check
,location
,lock
,mastercard
,minus
,password
,pin
,plus
,trash
,user
,visa
,spinner
,spinner-white
,question-mark
,front
,console
,sign-out
,discount
,cross
,card-amex
,card-dinersclub
,card-discover
,card-elo
,card-hipercard
,card-jcb
,card-maestro
,card-mastercard
,card-mir
,card-unionpay
,card-unknown
,card-visa
,card-alipay
,card-verve
,card-paypal
,card-dankort
,card-uatp
,method-apple_pay
,method-bancontact
,method-belfius
,method-card
,method-eps
,method-giropay
,method-ideal
,method-ing_home_pay
,method-kbc
,method-klarna_pay_later
,method-klarna_slice_it
,method-p24
,method-paypal
,method-bank_transfer
,method-sofort
,method-paypal_express_checkout
ormethod-bank_transfer
custom: boolean
tooltip: string – the title
width: number – Width of the icon in number of pixels
height: number – Height of the icon in number of pixels
alt: string – Alt text to use for accessibility
item-custom-fields
Usage of item-custom-fields
<item-custom-fields> </item-custom-fields>
item-description
Usage of item-description
<item-description> </item-description>
item-image
Usage of item-image
<item-image alt="<string>"> </item-image>
alt: string
item-line
Component that shows the details of an item in the cart. Child of `item-list`.
Usage of item-line
<item-line tag="<string>" item="<CartItem>" showDescription="<boolean>"> </item-line>
Default Template
item-list
Component that shows the cart items list.
Usage of item-list
<item-list tag="<string>" itemTemplate="<string>" showDescription="<boolean>"> </item-list>
item-quantity
Usage of item-quantity
<item-quantity disabled="<boolean>"> </item-quantity>
disabled: boolean
layout
Usage of layout
<layout headerTitle="<string>" contentCssClass="<any>" headerCssClass="<any>"> </layout>
headerTitle: string
contentCssClass: any
headerCssClass: any
loading-component
Component that renders a loading screen while an async operation is in progress.
Usage of loading-component
<loading-component message="<string>" isLoading="<boolean>"> </loading-component>
Default Template
loading-overlay
An overlay to show on top of content that is being loaded / updated.
Usage of loading-overlay
<loading-overlay icon="<string>" message="<string>" showIcon="<boolean>" opaque="<boolean>"> </loading-overlay>
loading-screen
Component that renders a loading screen while an async operation is in progress.
Usage of loading-screen
<loading-screen message="<string>" delay="<number>" tag="<string>"> </loading-screen>
message: string – The loading message
delay: number – Delay before displaying loading
tag: string – Sets the root element tag.
Default Template
media
Usage of media
<media> </media>
open-side-cart-action
Usage of open-side-cart-action
<open-side-cart-action> </open-side-cart-action>
order
Usage of order
<order date="<string>" total="<number>" currency="<string>" token="<string>" items="<>" invoiceUrl="<string>" invoiceNumber="<string>" status="<string>" hasActiveSubscription="<boolean>"> </order>
date: string
total: number
currency: string
token: string
items:
invoiceUrl: string
invoiceNumber: string
status: string
hasActiveSubscription: boolean
Default Template
order-payment-details
Usage of order-payment-details
<order-payment-details> </order-payment-details>
Default Template
orders-list
Usage of orders-list
<orders-list> </orders-list>
Default Template
paginated-list
Usage of paginated-list
<paginated-list onFetchNextPage="<(limit: number, offset: number) => Promise<PagedResponse<CustomerOrderResponse | CustomerSubscriptionsResponse>>>" messageLoading="<string>" messageNoResult="<string>" labelShowMore="<string>" itemComponent="<>" itemPropName="<string>" propsProvider="<Constructable>"> </paginated-list>
onFetchNextPage: (limit: number, offset: number) => Promise<PagedResponse<CustomerOrderResponse | CustomerSubscriptionsResponse>>
messageLoading: string
messageNoResult: string
labelShowMore: string
itemComponent:
itemPropName: string
propsProvider: Constructable
Default Template
payment
Usage of payment
<payment> </payment>
Default Template
payment-completed
Component that renders when the payment is completed.
Usage of payment-completed
<payment-completed> </payment-completed>
payment-details
Usage of payment-details
<payment-details paymentDetailsData="<PaymentDetailsProvider>" updatable="<boolean>"> </payment-details>
paymentDetailsData: PaymentDetailsProvider
updatable: boolean
Default Template
payment-form
Component that renders a credit card form.
Usage of payment-form
<payment-form disabled="<boolean>" paymentMethod="<PaymentMethodIds>" paymentCurrentlyProccessing="<boolean>"> </payment-form>
disabled: boolean
paymentMethod: PaymentMethodIds
paymentCurrentlyProccessing: boolean
payment-info
Usage of payment-info
<payment-info customerDetails="<>"> </payment-info>
customerDetails:
Default Template
payment-methods-list
Component that shows the list of available payment methods on the current payment session
Usage of payment-methods-list
<payment-methods-list disabled="<boolean>"> </payment-methods-list>
disabled: boolean
Default Template
payment-methods-list-item
Component that shows a clickable payment method selection element
Usage of payment-methods-list-item
<payment-methods-list-item paymentMethod="<PaymentMethod>"> </payment-methods-list-item>
paymentMethod: PaymentMethod
Default Template
rectify-cart-action
Usage of rectify-cart-action
<rectify-cart-action> </rectify-cart-action>
register-form
Usage of register-form
<register-form> </register-form>
Default Template
reset-password-form
Usage of reset-password-form
<reset-password-form> </reset-password-form>
Default Template
shipping
Component that renders the shipping box, it shows the shipping address form or shipping method picker depending on its state.
Usage of shipping
<shipping> </shipping>
shipping-address
Component that allows a customer to change / define its shipping address.
Usage of shipping-address
<shipping-address> </shipping-address>
Default Template
shipping-completed
Usage of shipping-completed
<shipping-completed context="<string>"> </shipping-completed>
context: string – Context in which this component is rendered
Default Template
shipping-method
This component renders the shipping method picker.
Usage of shipping-method
<shipping-method> </shipping-method>
Default Template
shipping-rates-list
Component that renders the list of available shipping methods.
Usage of shipping-rates-list
<shipping-rates-list tag="<string>"> </shipping-rates-list>
tag: string – Sets the root element tag, default is `ul`.
Default Template
shipping-rates-list-item
Usage of shipping-rates-list-item
<shipping-rates-list-item rate="<ShippingRate>"> </shipping-rates-list-item>
rate: ShippingRate – The shipping rate associated to the component instance.
Default Template
show-cart-action
Usage of show-cart-action
<show-cart-action> </show-cart-action>
show-detailed-cart-action
Usage of show-detailed-cart-action
<show-detailed-cart-action> </show-detailed-cart-action>
sign-in-action
Usage of sign-in-action
<sign-in-action> </sign-in-action>
sign-out-action
Usage of sign-out-action
<sign-out-action> </sign-out-action>
signin-form
Usage of signin-form
<signin-form> </signin-form>
Default Template
snipcart-address-autocomplete
Dropdown with autocomplete for addresses.
Usage of snipcart-address-autocomplete
<snipcart-address-autocomplete label="<string>"> </snipcart-address-autocomplete>
label: string – Input label
snipcart-checkbox
Checkbox form element.
Usage of snipcart-checkbox
<snipcart-checkbox name="<string>"> </snipcart-checkbox>
name: string
snipcart-field-error
Displays the error message associated with the form field.
Usage of snipcart-field-error
<snipcart-field-error name="<string>"> </snipcart-field-error>
name: string
Default Template
snipcart-form
Wrap form fields inside a form element and provide support for doing HTML5 validation even when we don't "submit" the form using a submit button.
Usage of snipcart-form
<snipcart-form> </snipcart-form>
snipcart-form-error
Usage of snipcart-form-error
<snipcart-form-error fallback="<string>"> </snipcart-form-error>
fallback: string
Default Template
snipcart-hidden-autofill
Usage of snipcart-hidden-autofill
<snipcart-hidden-autofill> </snipcart-hidden-autofill>
snipcart-input
Standard input (textbox) form element.
Usage of snipcart-input
<snipcart-input type="<string>" name="<string>" placeholder="<string>" icon="<string>"> </snipcart-input>
snipcart-label
Label for a form field.
Usage of snipcart-label
<snipcart-label for="<string>"> </snipcart-label>
for: string – The form field this label is linked to. Used by @UseField to retrieve form field.
snipcart-password
Usage of snipcart-password
<snipcart-password name="<string>" placeholder="<string>" icon="<string>"> </snipcart-password>
snipcart-radio
Radio button form element.
Usage of snipcart-radio
<snipcart-radio name="<string>" value="<string>" id="<string>"> </snipcart-radio>
snipcart-select
Usage of snipcart-select
<snipcart-select name="<string>"> </snipcart-select>
name: string
snipcart-submit
Usage of snipcart-submit
<snipcart-submit preventLoading="<boolean>" icon="<string>" label="<string>" labelLoading="<string>" labelError="<string>" labelSuccess="<string>" type="<ButtonTypes>" state="<BaseButtonStates>" hasIconLeft="<boolean>" isFitContent="<boolean>"> </snipcart-submit>
preventLoading: boolean
icon: string
label: string
labelLoading: string
labelError: string
labelSuccess: string
type: ButtonTypes
state: BaseButtonStates
hasIconLeft: boolean
isFitContent: boolean
Default Template
snipcart-textarea
Usage of snipcart-textarea
<snipcart-textarea name="<string>"> </snipcart-textarea>
name: string
snipcart-typeahead
Typeahead (autocomplete) form element.
Usage of snipcart-typeahead
<snipcart-typeahead type="<string>" name="<string>" autocomplete="<string>"> </snipcart-typeahead>
spinner
Usage of spinner
<spinner> </spinner>
Default Template
subscription
Usage of subscription
<subscription date="<string>" total="<number>" currency="<string>" token="<string>" items="<>" detailsUrl="<string>" invoiceNumber="<string>" nextBillingDate="<string>" planInterval="<number>" featureVersion="<>"> </subscription>
date: string
total: number
currency: string
token: string
items:
detailsUrl: string
invoiceNumber: string
nextBillingDate: string
planInterval: number
featureVersion:
Default Template
subscriptions-list
Usage of subscriptions-list
<subscriptions-list> </subscriptions-list>
Default Template
summary-fees
Usage of summary-fees
<summary-fees summaryData="<SummaryFeesProvider>"> </summary-fees>
summaryData: SummaryFeesProvider
Default Template
tabs
Usage of tabs
<tabs> </tabs>
textbox
Usage of textbox
<textbox value="<string>" id="<string>" name="<string>" icon="<string>" inputCssClasses="<any>"> </textbox>
tool-tip
Usage of tool-tip
<tool-tip> </tool-tip>