Web Components

The Rubiq Web Components are a collection of Web Components which can be dropped into an HTML page to provide pre-configured Rubiq API functionality.

Authentication

Rubiq Web Components are authenticated using Rubiq API Public authentication, and therefore require a PublicID, which can be created via the RubiqCloud Cloud Control app.

The PublicID is expected to be included in the page has an HTML META tag with name rbq-api-public-id, in the HTML HEAD section:

The components know where the Rubiq API is, but if the components should run against a different API location, for example the test API, this is also configured using a META tag, named rbq-api-url:

Adding components to a page

Web Components are added to HTML as custom elements which look like regular HTML tags, e.g.:

Any text or HTML inside the tags is rendered as usual, until the component custom elements have been defined, at which point their content is replaced with the correct web component body.

Component elements are defined by adding a single web component package script to the page. This should be added at the bottom of the page, just before the </body> tag, to ensure that the page loads quickly:

Web Components

The web components are unstyled or minimally styled, so they can easily be integrated into a website style. HTML Elements contained in the component bodies are give class names prefixed with rbq-, e.g. class="rbq-autocomplete-items", unless they are extremely generic, e.g. highlighted.

The components can have inputs and outputs, where inputs are HTML attributes, and outputs are events which may be listened for.

Input set on element directly in HTML:

Input set on element dynamically using JavaScript:

Attaching to output events:

Standard Lottery Events

lottery: All Lottery web components except <rbq-lottery-purchase-failure> have a lottery event, which contains an object describing the active Lottery, or (in the case of <rbq-lottery-purchase-success>) the Lottery that has just been purchased. The event contains these properties:

• name: Lottery name

• startDate

• endDate

• drawDate

• quickdrawDeadline

• quickdrawPrize

noActiveLottery: This event is emitted when no active Lottery is available.

<rbq-lottery-countdown>

Fetches the currently active Lottery and displays a self-updating countdown:

Slutter om 56 dage, 11 timer og 30 minutter

When there is no active Lottery available, this message is displayed (in addition to the standard noActiveLottery event being raised):

Der findes ingen aktiv lotteri

Inputs:

loading-message: The message displayed while the active Lottery is being fetched from the API

<rbq-lottery-countdown-upcoming>

Fetches the next Lottery to start (the next future lottery which has not yet begun) and displays a self-updating countdown to the lottery’s start date:

Lotteri <Lottery name> begynder om 56 dage, 11 timer og 30 minutter

When there is no upcoming Lottery available, a custom message can be displayed (in addition to the noUpcomingLottery event being raised). Use an HTML element with the upcomingNone attribute, like this:

Inputs:

loading-message: The message displayed while the active Lottery is being fetched from the API

Outputs:

lottery: The same as the standard lottery event

noUpcomingLottery: Similar to the standard noActiveLottery event

<rbq-lottery-quickdraw>

Fetches the currently active Lottery and if the quickdraw deadline has not passed, displays a message, e.g.:

“Hvis du spiller med inden d. 23/5 deltager du også i Hurtigtrækning om en ekstrapræmie på 1000”

<rbq-lottery-package-numbers>

Requests a “package” of Lottery numbers and displays them. This component also has a button used to refresh the numbers.

The package is reserved for a limited time, and the component displays a running countdown to the reservation expiry.

Inputs:

loading-image: The URL of an image to display while numbers are being fetched from the server. Note that when a loading-image is present, the loading-message is hidden.

loading-message: The message text to display while numbers are being fetched from the server

packageSize: Reservation package size, used to determine which package is being reserved. Setting this value triggers the reservation. Setting it to 0 cancels the current reservation.

reservation: This “input” is actually used to programatically read the reservation details from this component:

Outputs:

expired: Emitted when the reservation expires

numbersReceived: Emitted when a batch of numbers is available

<rbq-lottery-purchase-details>

Presents a form for users to enter their details, in order to complete the purchase. Some of the inputs for this component are required; if any of reservationID, successUrl or failureUrl are missing, an error message will be displayed instead of the form.

Once this component is initialized with a valid reservationID, the reservation expiry time is extended.

Once the form is validated and submitted, the browser will be redirected to a payment portal site. The successUrl and failureUrl properties are used to tell the payment portal where to go on successful/unsuccessful completion of the payment.

Inputs:

confirmLabel: The text displayed on the “submit” button

loading-image: The URL of an image to display while the reservation is being pre-approved. Note that when a loading-image is present, the loading-message is hidden.

loading-message: The message text to display while the reservation is being pre-approved

reservationID: The ID of the reserved package that is being purchased. This should be retrieved from the <rbq-lottery-package-numbers> component.

successUrl: The URL that the user should be redirected to after a successful purchase (should contain an <rbq-lottery-purchase-success> component).

failureUrl: The URL that the user should be redirected to after they cancel a purchase (should contain an <rbq-lottery-purchase-failure> component).

Outputs:

lotteryExpired: Emitted when a user attempts to purchase an expired package reservation.

lotteryPreApproved: Emitted after the reservationID input has been verified and the package has been “pre-approved” for purchase. The form will not be displayed until this event has been emitted.

statusChanges: Emitted when the form validation state changes.

<rbq-lottery-purchase-success>

To be used in a “success” page, the result of a purchase callback. The component reads the purchase order ID from the URL and completes the purchase. It also outputs the lottery and reservation details in events, allowing the details to be displayed.

This component does not display anything.

Outputs:

lottery: Similar to the lottery standard lottery event, this event contains the details of the lottery that has just been purchased. The event contains the following properties:

• name: Lottery name

• drawDate: Lottery draw date

• quickdrawDeadline: Deadline for the Lottery quickdraw

reservation: Emits the details of the purchase reservation, with the following properties:

• size: Number of tickets purchased

• price: Amount paid

<rbq-lottery-purchase-failure>

To be used in a “failure” page, the result of an unsuccessful purchase callback. The component reads the purchase order ID from the URL and cancels the purchase.

This component does not display anything, and has no output events.