diff --git a/docs/api/config/booking-cardshape.md b/docs/api/config/booking-cardshape.md index 63dbd74..828b821 100644 --- a/docs/api/config/booking-cardshape.md +++ b/docs/api/config/booking-cardshape.md @@ -8,7 +8,7 @@ description: You can learn about the cardShape config in the documentation of th ### Description -@short: Optional. An object with settings for managing information displayed on the left side of cards +@short: Optional. An object with settings for managing information displayed on the left side of each card ### Usage @@ -26,7 +26,7 @@ cardShape?: { ### Parameters -To configure the card appearance, in the **cardShape** object you can specify the following parameters (fields): +In the **cardShape** object you can specify the following parameters (fields): - `category` - (optional) shows/hides a card's name - `details` - (optional) shows/hides details @@ -65,6 +65,15 @@ new booking.Booking("#root", { }); ~~~ -The snippet below demonstrates how to configure what to display on the left side of cards: +The snippet below demonstrates how to configure what fields to display on the left side of cards: + +:::info +You can also configure the appearance of a card using the [`cardTemplate`](/api/config/booking-cardtemplate) property. If both `cardTemplate` and `cardShape` are applied, `cardTemplate` will override the `cardShape` settings. +::: + +**Related articles:** + +- [Defining the structure of cards](/guides/configuration/#defining-the-structure-of-cards) +- [`cardTemplate`](/api/config/booking-cardtemplate) \ No newline at end of file diff --git a/docs/api/config/booking-cardtemplate.md b/docs/api/config/booking-cardtemplate.md new file mode 100644 index 0000000..69c33e9 --- /dev/null +++ b/docs/api/config/booking-cardtemplate.md @@ -0,0 +1,91 @@ +--- +sidebar_label: cardTemplate +title: cardTemplate +description: You can learn about the cardTemplate config in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking. +--- + +# cardTemplate + +### Description + +@short: Optional. Allows applying a template to a card's left block + +The property specifies the HTML structure and layout of each card's block (the left side of each card). It means you can manage which fields are displayed, how they are arranged, and how they look. + +:::info +You can also specify which fields to display using the [`cardShape`](/api/config/booking-cardshape) property +::: + +### Usage + +~~~jsx {} +cardTemplate?: ({item: obj}) => string; +~~~ + +### Parameters + +`cardTemplate` expects a function that takes a `card` object as input and returns a string of HTML that defines how the card should look. + +### Example + +In the example below we create a function that takes the `card` object and returns HTML for a card that includes a preview image (card.preview), category (card.category), title (card.title), and price (card.price). You need to create your own HTML template to be applied to a card and import the **template** helper. Then pass the function into the Booking configuration by assigning the function to the `cardTemplate` property. + +~~~html {} + + + +~~~ + + +The snippet below demonstrates how to apply a template to the left block of a card: + + + +**Related articles:** + +- [Defining the structure of cards](/guides/configuration/#defining-the-structure-of-cards) +- [`cardShape`](/api/config/booking-cardshape) + diff --git a/docs/api/config/booking-infoshape.md b/docs/api/config/booking-infoshape.md index 3f56400..96a2def 100644 --- a/docs/api/config/booking-infoshape.md +++ b/docs/api/config/booking-infoshape.md @@ -62,3 +62,12 @@ new booking.Booking("#root", { The snippet below shows how to configure what to display on the left side of the Booking dialog: + +:::info +You can also control which fields to display in the information block of the Booking dialog using the [`infoTemplate`](/api/config/booking-infotemplate) property. But if both properties are applied, `infoTemplate` will override the `infoShape` settings. +::: + +**Related articles:** + +- [Configuring the Booking dialog](/guides/configuration/#configuring-the-booking-dialog) +- [`infoTemplate`](/api/config/booking-infotemplate) \ No newline at end of file diff --git a/docs/api/config/booking-infotemplate.md b/docs/api/config/booking-infotemplate.md new file mode 100644 index 0000000..19da9fc --- /dev/null +++ b/docs/api/config/booking-infotemplate.md @@ -0,0 +1,92 @@ +--- +sidebar_label: infoTemplate +title: infoTemplate +description: You can learn about the infoTemplate config in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking. +--- + +# infoTemplate + +### Description + +@short: Optional. Allows applying a template to the information block in the Booking dialog + +### Usage + +~~~jsx {} +infoTemplate?: ({item: obj, slot: number}) => string; +~~~ + +### Parameters + +`infoTemplate` takes the `card` item object and selected `slot` timestamp as input and returns a string of HTML. + + +### Example + +In the example below, we define the `cardInfoTemplate` function that will generate the custom HTML for the information block. This function will receive the `item` (card object) and `slot` (slot timestamp) as input parameters. The function returns div containers representing the information block for a selected booking item, including an image, category, title, and formatted date. You should also import the **template** helper and assign your custom function to `infoTemplate`. + +~~~html + + + +~~~ + +The snippet below shows how to apply a template to the information block of the Booking dialog that appears when a user clicks the time slot button: + + + +:::info +You can also control which fields to display in the information block of the Booking dialog using the [`infoShape`](/api/config/booking-infoshape) property. But if both properties are applied, `infoTemplate` will override the `infoShape` settings. +::: + +**Related articles:** + +- [Configuring the Booking dialog](/guides/configuration/#configuring-the-booking-dialog) +- [`infoShape`](/api/config/booking-infoshape) \ No newline at end of file diff --git a/docs/api/config/booking-rendertype.md b/docs/api/config/booking-rendertype.md new file mode 100644 index 0000000..9c89065 --- /dev/null +++ b/docs/api/config/booking-rendertype.md @@ -0,0 +1,38 @@ +--- +sidebar_label: renderType +title: renderType +description: You can learn about renderType in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking. +--- + +# renderType + +### Description + +@short: Optional. Defines how cards are rendered + +The property helps optimize performance when working with a large number of cards. + +### Usage + +~~~jsx {} +renderType?: "default" | "lazy"; +~~~ + +### Parameters + +- `default` - renders all cards loaded to the widget (set by default) +- `lazy` - renders only visible cards + +### Example + +~~~jsx {} +new booking.Booking("#root", { + data, + renderType: "lazy", + // other parameters +}); +~~~ + +The snippet below shows how to handle rendering large data sets: + + diff --git a/docs/api/overview/booking-api-overview.md b/docs/api/overview/booking-api-overview.md index 3e17434..0facd06 100644 --- a/docs/api/overview/booking-api-overview.md +++ b/docs/api/overview/booking-api-overview.md @@ -64,10 +64,13 @@ new booking.Booking("#root", { | [](../config/booking-data.md) | @getshort(../config/booking-data.md) | | [](../config/booking-end.md) | @getshort(../config/booking-end.md) | | [](../config/booking-cardshape.md) | @getshort(../config/booking-cardshape.md) | +| [](../config/booking-cardtemplate.md) | @getshort(../config/booking-cardtemplate.md) | | [](../config/booking-filtershape.md) | @getshort(../config/booking-filtershape.md) | | [](../config/booking-formshape.md) | @getshort(../config/booking-formshape.md) | | [](../config/booking-infoshape.md) | @getshort(../config/booking-infoshape.md) | +| [](../config/booking-infotemplate.md) | @getshort(../config/booking-infotemplate.md) | | [](../config/booking-locale.md) | @getshort(../config/booking-locale.md) | +| [](../config/booking-rendertype.md) | @getshort(../config/booking-rendertype.md) | | [](../config/booking-slotgap.md) | @getshort(../config/booking-slotgap.md) | | [](../config/booking-slotsize.md) | @getshort(../config/booking-slotsize.md) | | [](../config/booking-start.md) | @getshort(../config/booking-start.md) | diff --git a/docs/api/overview/booking-properties-overview.md b/docs/api/overview/booking-properties-overview.md index 15b709b..1c27854 100644 --- a/docs/api/overview/booking-properties-overview.md +++ b/docs/api/overview/booking-properties-overview.md @@ -11,10 +11,13 @@ description: You can have properties overview of JavaScript Booking in the docum | [](../config/booking-data.md) | @getshort(../config/booking-data.md) | | [](../config/booking-end.md) | @getshort(../config/booking-end.md) | | [](../config/booking-cardshape.md) | @getshort(../config/booking-cardshape.md) | +| [](../config/booking-cardtemplate.md) | @getshort(../config/booking-cardtemplate.md) | | [](../config/booking-filtershape.md) | @getshort(../config/booking-filtershape.md) | | [](../config/booking-formshape.md) | @getshort(../config/booking-formshape.md) | | [](../config/booking-infoshape.md) | @getshort(../config/booking-infoshape.md) | +| [](../config/booking-infotemplate.md) | @getshort(../config/booking-infotemplate.md) | | [](../config/booking-locale.md) | @getshort(../config/booking-locale.md) | +| [](../config/booking-rendertype.md) | @getshort(../config/booking-rendertype.md) | | [](../config/booking-slotgap.md) | @getshort(../config/booking-slotgap.md) | | [](../config/booking-slotsize.md) | @getshort(../config/booking-slotsize.md) | | [](../config/booking-start.md) | @getshort(../config/booking-start.md) | diff --git a/docs/assets/trial-booking.png b/docs/assets/trial-booking.png new file mode 100644 index 0000000..907c153 Binary files /dev/null and b/docs/assets/trial-booking.png differ diff --git a/docs/guides/configuration.md b/docs/guides/configuration.md index 692e427..fc17a37 100644 --- a/docs/guides/configuration.md +++ b/docs/guides/configuration.md @@ -10,11 +10,17 @@ description: You can learn about the configuration in the documentation of the D To load data, add data to the [`data`](/api/config/booking-data) array. See all instructions here: [`Loading data`](/guides/loading-data). -## Defining the structure of cards +## Defining the structure of cards -You can configure what information all cards will display on their left side using the [`cardShape`](/api/config/booking-cardshape) property. +You can configure what information all cards will display on their left side using the [`cardShape`](/api/config/booking-cardshape) property or the [`cardTemplate`](/api/config/booking-cardtemplate) property, which also allows customizing the appearance of each card's block. -On the left side of a card the following data fields are displayed by default: +:::info +`cardTemplate` helps completely customize the appearance of a card by providing your own custom HTML. It gives full control over the card's layout, design and content. +`cardShape` allows you only to modify the default template by hiding/showing fields. +If both are applied, `cardTemplate` will override the `cardShape` settings. +::: + +On the left side of each card the following data fields are displayed by default: - preview: card image - review: rating information with the number of rating stars (out of five) and the number of reviews - category: the subtitle of a card @@ -65,6 +71,69 @@ new booking.Booking("#root", { Please, see an example in the [snippet tool](https://snippet.dhtmlx.com/6mxd7918) ::: +To apply a template to each card (the left-hand block), use the [`cardTemplate`](/api/config/booking-cardtemplate) property. + +First, create a function that takes a card object and returns a string of HTML. To define a template, arrange card item properties into any HTML blocks with custom styles. In the example, `cardPreviewTemplate` returns HTML for a card that includes a preview image (card.preview), category (card.category), title (card.title), and price (card.price). + +~~~html {} + + + +~~~ + +Then you also need to import the **template** helper and assign the`cardTemplate` property to your custom template function. + +~~~jsx +const { Booking, template } = booking; + +const widget = new Booking("#root", { + data, + cardTemplate: template(card => cardPreviewTemplate(card)), + // other parameters +}); +~~~ + +:::info +Please, see an example in the [snippet tool](https://snippet.dhtmlx.com/k2v01vng) +::: + ## Filling cards with slots A slot is a time unit available for booking. Available slots for cards are displayed for the next five days starting from the current day or from the start date from the filter. @@ -364,6 +433,75 @@ new booking.Booking("#root", { Please, see an example in the [snippet tool](https://snippet.dhtmlx.com/pd6wp1xc) ::: +To fully customize the appearance and content of the information block, apply your own template using the [`infoTemplate`](/api/config/booking-infotemplate) property (`infoShape` can be used only to hide/show fields provided by the default template). If both properties are applied, `infoTemplate` will override the `infoShape` settings. + +To apply a template, you need to define the function that will generate the custom HTML for the information block. This function will receive the card and slot objects as input parameters, which are `item` (card object) and `slot` (slot timestamp) as in the example below. You should also define your custom template by arranging card item properties into any HTML blocks with custom styles. + +~~~html + + + +~~~ + +Then you also need to import the **template** helper and pass the `infoTemplate` function into the Booking configuration as follows: + +~~~jsx +const { Booking, template } = booking; + +const widget = new Booking("#root", { + data, + infoTemplate: template(item => cardInfoTemplate(item)), + // other parameters +}); +~~~ + +:::info +Please, see an example in the [snippet tool](https://snippet.dhtmlx.com/byb94ipu) +::: + + ## Configuring the filter You can configure filter settings via the [`filterShape`](/api/config/booking-filtershape) property. Default configuration is the following: diff --git a/docs/guides/integration-with-angular.md b/docs/guides/integration-with-angular.md new file mode 100644 index 0000000..1393402 --- /dev/null +++ b/docs/guides/integration-with-angular.md @@ -0,0 +1,326 @@ +--- +sidebar_label: Integration with Angular +title: Integration with Angular +description: You can learn about the integration with Angular in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking. +--- + +# Integration with Angular + +:::tip +You should be familiar with basic concepts and patterns of **Angular** before reading this documentation. To refresh your knowledge, please refer to the [**Angular documentation**](https://angular.io/docs). +::: + +DHTMLX Booking is compatible with **Angular**. We have prepared code examples on how to use DHTMLX Booking with **Angular**. For more information, refer to the corresponding [**Example on GitHub**](https://github.com/DHTMLX/angular-booking-demo). + +## Creating a project + +:::info +Before you start to create a new project, install [**Angular CLI**](https://angular.io/cli) and [**Node.js**](https://nodejs.org/en/). +::: + +Create a new **my-angular-booking-app** project using Angular CLI. Run the following command for this purpose: + +~~~json +ng new my-angular-booking-app +~~~ + +:::note +If you want to follow this guide, disable Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering) when creating new Angular app! +::: + +The command above installs all the necessary tools, so you don't need to run any additional commands. + +### Installation of dependencies + +Go to the new created app directory: + +~~~json +cd my-angular-booking-app +~~~ + +Install dependencies and start the dev server. For this, use the [**yarn**](https://yarnpkg.com/) package manager: + +~~~json +yarn +yarn start +~~~ + +The app should run on a localhost (for instance `http://localhost:3000`). + +## Creating Booking + +Now you should get the DHTMLX Booking source code. First of all, stop the app and proceed with installing the Booking package. + +### Step 1. Package installation + +Download the [**trial Booking package**](/how-to-start/#installing-trial-booking-via-npm-and-yarn) and follow steps mentioned in the README file. Note that trial Booking is available 30 days only. + +### Step 2. Component creation + +Now you need to create an Angular component, to add Booking into the application. Create the ***booking*** folder in the ***src/app/*** directory, add a new file into it and name it ***booking.component.ts***. Then complete the steps described below. + +#### Import source files + +Open the file and import Booking source files. Note that: + +- if you use PRO version and install the Booking package from a local folder, the imported path looks like this: + +~~~jsx +import { Booking } from 'dhx-booking-package'; +~~~ + +- if you use the trial version of Booking, specify the following path: + +~~~jsx +import { Booking } from '@dhx/trial-booking'; +~~~ + +:::info +In this tutorial you can see how to configure the **trial** version of Booking. +::: + +#### Set the container and initialize Booking + +To display Booking on the page, you need to set the container to render the component inside and initialize Booking using the corresponding constructor: + +~~~jsx {1,8,12-13,18-19} title="booking.component.ts" +import { Booking } from '@dhx/trial-booking'; +import { Component, ElementRef, OnInit, ViewChild, OnDestroy, ViewEncapsulation } from '@angular/core'; + +@Component({ + encapsulation: ViewEncapsulation.None, + selector: "booking", // a template name used in the "app.component.ts" file as + styleUrls: ["./booking.component.css"], // include a css file + template: `
`, +}) + +export class BookingComponent implements OnInit, OnDestroy { + // initialize container for Booking + @ViewChild('container', { static: true }) booking_container!: ElementRef; + + private _booking!: Booking; + + ngOnInit() { + // initialize the Booking component + this._booking = new Booking(this.booking_container.nativeElement, {}); + } + + ngOnDestroy(): void { + this._booking.destructor(); // destruct Booking + } +} +~~~ + +#### Adding styles + +To display Booking correctly, you need to provide the corresponding styles. For this purpose, you can create the ***booking.component.css*** file in the **src/app/booking/** directory and specify important styles for Booking and its container: + +~~~css title="booking.component.css" +/* import Booking styles */ +@import "@dhx/trial-booking/dist/booking.css"; + +/* specify styles for initial page */ +html, +body { + margin: 0; + padding: 0; + height: 100%; +} + +/* specify styles for the Booking container */ +.widget { + height: 100%; +} +~~~ + +#### Loading data + +To add data into Booking, you need to provide a data set. You can create the ***data.ts*** file in the ***src/app/booking/*** directory and add some data into it: + +~~~jsx title="data.ts" +export function getData() : any { + function getDate(addDays : any, hoursValue = 0, minutesValue = 0) { + const date = new Date(); + const secondsValue = 0; // round to minutes + const msValue = 0; + + date.setDate(date.getDate() + addDays); + date.setHours(hoursValue, minutesValue, secondsValue, msValue); + + return date.getTime(); + } + + return [ + { + id: "ee828b5d-a034-420c-889b-978840015d6a", + title: "Natalie Tyson", + category: "Therapist", + subtitle: "2 years of experiece", + details: "Cleveland Clinic\n9500 Euclid Ave", + preview: "https://snippet.dhtmlx.com/codebase/data/booking/01/img/01.jpg", + price: "$35", + review: { + stars: 4, + count: 120 + }, + slots: [ + { + from: 9, + to: 20, + days: [1, 2, 3, 4, 5] + }, + { + from: 10, + to: 18, + days: [6, 0] + } + ] + }, + { + id: "9b037564-77be-429f-b719-eebbe499027a", + title: "Emma Johnson", + category: "Cardiologist", + subtitle: "2 years of experience", + details: "Stanford Health Care\n1468 Madison Ave", + preview: "https://snippet.dhtmlx.com/codebase/data/booking/01/img/03.jpg", + price: "$25", + review: { + stars: 5, + count: 10 + }, + slots: [ + { + from: 14, + to: 17, + size: 30, + gap: 10 + }, + { + from: 12, + to: 19, + size: 50, + gap: 20, + days: [2], + dates: [getDate(0)] + }, + { + from: "18:30", + to: 20, + size: 20, + gap: 20, + days: [3, 4, 5] + }, + ], + usedSlots: [getDate(0, 12), getDate(0, 18)] + }, + // ... + ]; +} +~~~ + +Then open the ***booking.component.ts*** file. Import the file with data and specify the corresponding data properties to the configuration object of Booking within the `ngOnInit()` method, as shown below. + +~~~jsx {2,18,20} title="booking.component.ts" +import { Booking } from '@dhx/trial-booking'; +import { getData } from "./data"; // import data +import { Component, ElementRef, OnInit, ViewChild, OnDestroy, ViewEncapsulation } from '@angular/core'; + +@Component({ + encapsulation: ViewEncapsulation.None, + selector: "booking", + styleUrls: ["./booking.component.css"], + template: `
`, +}) + +export class BookingComponent implements OnInit, OnDestroy { + @ViewChild('container', { static: true }) booking_container!: ElementRef; + + private _booking!: Booking; + + ngOnInit() { + const data = getData(); // initialize data property + this._booking = new Booking(this.booking_container.nativeElement, { + data + }); + } + + ngOnDestroy(): void { + this._booking.destructor(); + } +} +~~~ + +Now the Booking component is ready to use. When the element will be added to the page, it will initialize the Booking with data. You can provide necessary configuration settings as well. Visit our [Booking API docs](/api/overview/booking-properties-overview/) to check the full list of available properties. + +#### Handling events + +When a user makes some action in the Booking, it invokes an event. You can use these events to detect the action and run the desired code for it. See the [full list of events](/api/overview/booking-events-overview/). + +Open the ***booking.component.ts*** file and complete the `ngOnInit()` method as in: + +~~~jsx {7-10} title="booking.component.ts" +// ... +ngOnInit() { + this._booking = new Booking(this.booking_container.nativeElement, { + date: new Date(2024, 5, 10), + }); + + // output the id of the selected slot + this._booking.api.on("select-slot", (obj) => { + console.log(obj.id); + }); +} + +ngOnDestroy(): void { + this._booking.destructor(); +} +~~~ + +### Step 3. Adding Booking into the app + +To add the ***BookingComponent*** component into the app, open the ***src/app/app.component.ts*** file and replace the default code with the following one: + +~~~jsx {5} title="app.component.ts" +import { Component } from "@angular/core"; + +@Component({ + selector: "app-root", + template: `` // a template created in the "booking.component.ts" file +}) +export class AppComponent { + name = ""; +} +~~~ + +Then create the ***app.module.ts*** file in the ***src/app/*** directory and specify the *BookingComponent* as shown below: + +~~~jsx {4-5,8} title="app.module.ts" +import { NgModule } from "@angular/core"; +import { BrowserModule } from "@angular/platform-browser"; + +import { AppComponent } from "./app.component"; +import { BookingComponent } from "./booking/booking.component"; + +@NgModule({ + declarations: [AppComponent, BookingComponent], + imports: [BrowserModule], + bootstrap: [AppComponent] +}) +export class AppModule {} +~~~ + +The last step is to open the ***src/main.ts*** file and replace the existing code with the following one: + +~~~jsx title="main.ts" +import { platformBrowserDynamic } from "@angular/platform-browser-dynamic"; +import { AppModule } from "./app/app.module"; +platformBrowserDynamic() + .bootstrapModule(AppModule) + .catch((err) => console.error(err)); +~~~ + +After that, you can start the app to see Booking loaded with data on a page. + +![Booking initialization](../assets/trial-booking.png) + +Now you know how to integrate DHTMLX Booking with Angular. You can customize the code according to your specific requirements. The final example you can find on [**GitHub**](https://github.com/DHTMLX/angular-booking-demo). diff --git a/docs/guides/integration-with-react.md b/docs/guides/integration-with-react.md new file mode 100644 index 0000000..247a47b --- /dev/null +++ b/docs/guides/integration-with-react.md @@ -0,0 +1,287 @@ +--- +sidebar_label: Integration with React +title: Integration with React +description: You can learn about the integration with React in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking. +--- + +# Integration with React + +:::tip +You should be familiar with the basic concepts and patterns of [**React**](https://react.dev) before reading this documentation. To refresh your knowledge, please refer to the [**React documentation**](https://reactjs.org/docs/getting-started.html). +::: + +DHTMLX Booking is compatible with **React**. We have prepared code examples on how to use DHTMLX Booking with **React**. For more information, refer to the corresponding [**Example on GitHub**](https://github.com/DHTMLX/react-booking-demo). + +## Creating a project + +:::info +Before you start to create a new project, install [**Vite**](https://vite.dev/) (optional) and [**Node.js**](https://nodejs.org/en/). +::: + +You can create a basic **React** project or use **React with Vite**. Let's name the project as **my-react-booking-app**: + +~~~json +npx create-react-app my-react-booking-app +~~~ + +### Installation of dependencies + +Go to the new created app directory: + +~~~json +cd my-react-booking-app +~~~ + +Install dependencies and start the dev server. For this, use a package manager: + +- if you use [**yarn**](https://yarnpkg.com/), run the following commands: + +~~~json +yarn +yarn start +~~~ + +- if you use [**npm**](https://www.npmjs.com/), run the following commands: + +~~~json +npm install +npm run dev +~~~ + +The app should run on a localhost (for instance `http://localhost:3000`). + +## Creating Booking + +Now you should get the DHTMLX Booking source code. First of all, stop the app and proceed with installing the Booking package. + +### Step 1. Package installation + +Download the [**trial Booking package**](/how-to-start/#installing-trial-booking-via-npm-and-yarn) and follow steps mentioned in the README file. Note that trial Booking is available 30 days only. + +### Step 2. Component creation + +Now you need to create a React component, to add an Booking into the application. Create a new file in the ***src/*** directory and name it ***Booking.jsx***. + +#### Import source files + +Open the ***Booking.jsx*** file and import Booking source files. Note that: + +- if you use PRO version and install the Booking package from a local folder, the import paths look like this: + +~~~jsx title="Booking.jsx" +import { Booking } from 'dhx-booking-package'; +import 'dhx-booking-package/dist/booking.css'; +~~~ + +Note that depending on the used package, the source files can be minified. In this case make sure that you are importing the CSS file as ***booking.min.css***. + +- if you use the trial version of Booking, specify the following paths: + +~~~jsx title="Booking.jsx" +import { Booking } from '@dhx/trial-booking'; +import "@dhx/trial-booking/dist/booking.css"; +~~~ + +:::info +In this tutorial you can see how to configure the **trial** version of Booking. +::: + +#### Setting the container and adding Booking + +To display Booking on the page, you need to create the container for Booking, and initialize this component using the corresponding constructor: + +~~~jsx {2,6,9-10,17} title="Booking.jsx" +import { useEffect, useRef } from "react"; +import { Booking } from "@dhx/trial-booking"; +import "@dhx/trial-booking/dist/booking.css"; // include Booking styles + +export default function BookingComponent(props) { + let container = useRef(); // initialize container for Booking + + useEffect(() => { + // initialize the Booking component + const booking = new Booking(container.current, {}); + + return () => { + booking.destructor(); // destruct Booking + }; + }, []); + + return
; +} +~~~ + +#### Adding styles + +To display Booking correctly, you need to specify important styles for Booking and its container in the main css file of the project: + +~~~css title="index.css" +/* specify styles for initial page */ +html, +body, +#root { + height: 100%; + padding: 0; + margin: 0; +} + +/* specify styles for the Booking container */ +.widget { + height: 100%; +} +~~~ + +#### Loading data + +To add data into the Booking, you need to provide a data set. You can create the ***data.js*** file in the ***src/*** directory and add some data into it: + +~~~jsx title="data.js" +export function getData() { + function getDate(addDays, hoursValue = 0, minutesValue = 0) { + const date = new Date(); + const secondsValue = 0; // round to minutes + const msValue = 0; + + date.setDate(date.getDate() + addDays); + date.setHours(hoursValue, minutesValue, secondsValue, msValue); + + return date.getTime(); + } + + return [ + { + id: "ee828b5d-a034-420c-889b-978840015d6a", + title: "Natalie Tyson", + category: "Therapist", + subtitle: "2 years of experiece", + details: "Cleveland Clinic\n9500 Euclid Ave", + preview: "https://snippet.dhtmlx.com/codebase/data/booking/01/img/01.jpg", + price: "$35", + review: { + stars: 4, + count: 120 + }, + slots: [ + { + from: 9, + to: 20, + days: [1, 2, 3, 4, 5] + }, + { + from: 10, + to: 18, + days: [6, 0] + } + ] + }, + { + id: "9b037564-77be-429f-b719-eebbe499027a", + title: "Emma Johnson", + category: "Cardiologist", + subtitle: "2 years of experience", + details: "Stanford Health Care\n1468 Madison Ave", + preview: "https://snippet.dhtmlx.com/codebase/data/booking/01/img/03.jpg", + price: "$25", + review: { + stars: 5, + count: 10 + }, + slots: [ + { + from: 14, + to: 17, + size: 30, + gap: 10 + }, + { + from: 12, + to: 19, + size: 50, + gap: 20, + days: [2], + dates: [getDate(0)] + }, + { + from: "18:30", + to: 20, + size: 20, + gap: 20, + days: [3, 4, 5] + } + ], + usedSlots: [getDate(0, 12), getDate(0, 18)] + }, + // ... + ]; +} +~~~ + +Then open the ***App.js*** file and import data. After this you can pass data into the new created `` components as **props**: + +~~~jsx {2,5-6} title="App.js" +import Booking from "./Booking"; +import { getData } from "./data"; + +function App() { + const dataset = getData(); + return ; +} + +export default App; +~~~ + +Go to the ***Booking.jsx*** file and apply the passed **props** to the Booking configuration object: + +~~~jsx {5,10} title="Booking.jsx" +import { useEffect, useRef } from "react"; +import { Booking } from "@dhx/trial-booking"; +import "@dhx/trial-booking/dist/booking.css"; + +export default function BookingComponent(props) { + let container = useRef(); + + useEffect(() => { + const booking = new Booking(container.current, { + data: props.data + // other configuration properties + }); + + return () => { + booking.destructor(); + } + }, []); + + return
; +} +~~~ + +Now the Booking component is ready to use. When the element will be added to the page, it will initialize the Booking with data. You can provide necessary configuration settings as well. Visit our [Booking API docs](/api/overview/booking-properties-overview/) to check the full list of available properties. + +#### Handling events + +When a user makes some action in the Booking, it invokes an event. You can use these events to detect the action and run the desired code for it. See the [full list of events](/api/overview/booking-events-overview/). + +Open ***Booking.jsx*** and complete the `useEffect()` method in the following way: + +~~~jsx {5-8} title="Booking.jsx" +// ... +useEffect(() => { + const booking = new Booking(container.current, {}); + + // output the id of the selected slot + booking.api.on("select-slot", (obj) => { + console.log(obj.id); + }); + + return () => { + booking.destructor(); + } +}, []); +// ... +~~~ + +After that, you can start the app to see Booking loaded with data on a page. + +![Booking initialization](../assets/trial-booking.png) + +Now you know how to integrate DHTMLX Booking with React. You can customize the code according to your specific requirements. The final example you can find on [**GitHub**](https://github.com/DHTMLX/react-booking-demo). diff --git a/docs/guides/integration-with-svelte.md b/docs/guides/integration-with-svelte.md new file mode 100644 index 0000000..dfb77a2 --- /dev/null +++ b/docs/guides/integration-with-svelte.md @@ -0,0 +1,300 @@ +--- +sidebar_label: Integration with Svelte +title: Integration with Svelte +description: You can learn about the integration with Svelte in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking. +--- + +# Integration with Svelte + +:::tip +You should be familiar with the basic concepts and patterns of **Svelte** before reading this documentation. To refresh your knowledge, please refer to the [**Svelte documentation**](https://svelte.dev/). +::: + +DHTMLX Booking is compatible with **Svelte**. We have prepared code examples on how to use DHTMLX Booking with **Svelte**. For more information, refer to the corresponding [**Example on GitHub**](https://github.com/DHTMLX/svelte-booking-demo). + +## Creating a project + +:::info +Before you start to create a new project, install [**Vite**](https://vite.dev/) (optional) and [**Node.js**](https://nodejs.org/en/). +::: + +To create a **Svelte** JS project, run the following command: + +~~~json +npm create vite@latest +~~~ + +Let's name the project as **my-svelte-booking-app**. + +### Installation of dependencies + +Go to the app directory: + +~~~json +cd my-svelte-booking-app +~~~ + +Install dependencies and start the dev server. For this, use a package manager: + +- if you use [**yarn**](https://yarnpkg.com/), run the following commands: + +~~~jsx +yarn +yarn start // or yarn dev +~~~ + +- if you use [**npm**](https://www.npmjs.com/), run the following commands: + +~~~json +npm install +npm run dev +~~~ + +The app should run on a localhost (for instance `http://localhost:3000`). + +## Creating Booking + +Now you should get the DHTMLX Booking source code. First of all, stop the app and proceed with installing the Booking package. + +### Step 1. Package installation + +Download the [**trial Booking package**](/how-to-start/#installing-trial-booking-via-npm-and-yarn) and follow steps mentioned in the README file. Note that trial Booking is available 30 days only. + +### Step 2. Component creation + +Now you need to create a Svelte component, to add Booking into the application. Let's create a new file in the ***src/*** directory and name it ***Booking.svelte***. + +#### Import source files + +Open the ***Booking.svelte*** file and import Booking source files. Note that: + +- if you use PRO version and install the Booking package from a local folder, the import paths look like this: + +~~~html title="Booking.svelte" + +~~~ + +Note that depending on the used package, the source files can be minified. In this case make sure that you are importing the CSS file as ***booking.min.css***. + +- if you use the trial version of Booking, specify the following paths: + +~~~html title="Booking.svelte" + +~~~ + +:::info +In this tutorial you can see how to configure the **trial** version of Booking. +::: + +#### Setting the container and adding Booking + +To display Booking on the page, you need to create the container for Booking, and initialize this component using the corresponding constructor: + +~~~html {3,6,10-11,19} title="Booking.svelte" + + +
+~~~ + +#### Adding styles + +To display Booking correctly, you need to specify important styles for Booking and its container in the main css file of the project: + +~~~css title="main.css" +/* specify styles for initial page */ +html, +body, +#app { /* make sure that you use the #app root container */ + height: 100%; + padding: 0; + margin: 0; +} + +/* specify styles for the Booking container */ +.widget { + height: 100%; +} +~~~ + +#### Loading data + +To add data into the Booking, we need to provide a data set. You can create the ***data.js*** file in the ***src/*** directory and add some data into it: + +~~~jsx title="data.js" +export function getData() { + function getDate(addDays, hoursValue = 0, minutesValue = 0) { + const date = new Date(); + const secondsValue = 0; // round to minutes + const msValue = 0; + + date.setDate(date.getDate() + addDays); + date.setHours(hoursValue, minutesValue, secondsValue, msValue); + + return date.getTime(); + } + + return [ + { + id: "ee828b5d-a034-420c-889b-978840015d6a", + title: "Natalie Tyson", + category: "Therapist", + subtitle: "2 years of experiece", + details: "Cleveland Clinic\n9500 Euclid Ave", + preview: "https://snippet.dhtmlx.com/codebase/data/booking/01/img/01.jpg", + price: "$35", + review: { + stars: 4, + count: 120 + }, + slots: [ + { + from: 9, + to: 20, + days: [1, 2, 3, 4, 5] + }, + { + from: 10, + to: 18, + days: [6, 0] + } + ] + }, + { + id: "9b037564-77be-429f-b719-eebbe499027a", + title: "Emma Johnson", + category: "Cardiologist", + subtitle: "2 years of experience", + details: "Stanford Health Care\n1468 Madison Ave", + preview: "https://snippet.dhtmlx.com/codebase/data/booking/01/img/03.jpg", + price: "$25", + review: { + stars: 5, + count: 10 + }, + slots: [ + { + from: 14, + to: 17, + size: 30, + gap: 10 + }, + { + from: 12, + to: 19, + size: 50, + gap: 20, + days: [2], + dates: [getDate(0)] + }, + { + from: "18:30", + to: 20, + size: 20, + gap: 20, + days: [3, 4, 5] + } + ], + usedSlots: [getDate(0, 12), getDate(0, 18)] + }, + // ... + ]; +} +~~~ + +Then open the ***App.svelte*** file, import data, and pass it into the new created `` components as **props**: + +~~~html {3,5,8} title="App.svelte" + + + +~~~ + +Go to the ***Booking.svelte*** file and apply the passed **props** to the Booking configuration object: + +~~~html {6,13} title="Booking.svelte" + + +
+~~~ + +Now the Booking component is ready to use. When the element will be added to the page, it will initialize the Booking with data. You can provide necessary configuration settings as well. Visit our [Booking API docs](/api/overview/booking-properties-overview/) to check the full list of available properties. + +#### Handling events + +When a user makes some action in the Booking, it invokes an event. You can use these events to detect the action and run the desired code for it. See the [full list of events](/api/overview/booking-events-overview/). + +Open ***Booking.svelte*** and complete the `onMount()` method in the following way: + +~~~html {8-11} title="Booking.svelte" + + +// ... +~~~ + +After that, you can start the app to see Booking loaded with data on a page. + +![Booking initialization](../assets/trial-booking.png) + +Now you know how to integrate DHTMLX Booking with Svelte. You can customize the code according to your specific requirements. The final example you can find on [**GitHub**](https://github.com/DHTMLX/svelte-booking-demo). diff --git a/docs/guides/integration-with-vue.md b/docs/guides/integration-with-vue.md new file mode 100644 index 0000000..6000775 --- /dev/null +++ b/docs/guides/integration-with-vue.md @@ -0,0 +1,309 @@ +--- +sidebar_label: Integration with Vue +title: Integration with Vue +description: You can learn about the integration with Vue in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking. +--- + +# Integration with Vue + +:::tip +You should be familiar with the basic concepts and patterns of [**Vue**](https://vuejs.org/) before reading this documentation. To refresh your knowledge, please refer to the [**Vue 3 documentation**](https://vuejs.org/guide/introduction.html#getting-started). +::: + +DHTMLX Booking is compatible with **Vue**. We have prepared code examples on how to use DHTMLX Booking with **Vue 3**. For more information, refer to the corresponding [**Example on GitHub**](https://github.com/DHTMLX/vue-booking-demo). + +## Creating a project + +:::info +Before you start to create a new project, install [**Node.js**](https://nodejs.org/en/). +::: + +To create a **Vue** project, run the following command: + +~~~json +npm create vue@latest +~~~ + +This command installs and executes `create-vue`, the official **Vue** project scaffolding tool. Check the details in the [Vue.js Quick Start](https://vuejs.org/guide/quick-start.html#creating-a-vue-application). + +Let's name the project as **my-vue-booking-app**. + +### Installation of dependencies + +Go to the app directory: + +~~~json +cd my-vue-booking-app +~~~ + +Install dependencies and start the dev server. For this, use a package manager: + +- if you use [**yarn**](https://yarnpkg.com/), run the following commands: + +~~~jsx +yarn +yarn start // or yarn dev +~~~ + +- if you use [**npm**](https://www.npmjs.com/), run the following commands: + +~~~json +npm install +npm run dev +~~~ + +The app should run on a localhost (for instance `http://localhost:3000`). + +## Creating Booking + +Now you should get the DHTMLX Booking source code. First of all, stop the app and proceed with installing the Booking package. + +### Step 1. Package installation + +Download the [**trial Booking package**](/how-to-start/#installing-trial-booking-via-npm-and-yarn) and follow steps mentioned in the README file. Note that trial Booking is available 30 days only. + +### Step 2. Component creation + +Now you need to create a Vue component, to add Booking into the application. Create a new file in the ***src/components/*** directory and name it ***Booking.vue***. + +#### Import source files + +Open the ***Booking.vue*** file and import Booking source files. Note that: + +- if you use PRO version and install the Booking package from a local folder, the import paths look like this: + +~~~html title="Booking.vue" + +~~~ + +Note that depending on the used package, the source files can be minified. In this case make sure that you are importing the CSS file as ***booking.min.css***. + +- if you use the trial version of Booking, specify the following paths: + +~~~html title="Booking.vue" + + + +~~~ + +#### Adding styles + +To display Booking correctly, you need to specify important styles for Booking and its container in the main css file of the project: + +~~~css title="main.css" +/* specify styles for initial page */ +html, +body, +#app { /* make sure that you use the #app root container */ + height: 100%; + padding: 0; + margin: 0; +} + +/* specify styles for the Booking container */ +.widget { + height: 100%; +} +~~~ + +#### Loading data + +To add data into the Booking, you need to provide a data set. You can create the ***data.js*** file in the ***src/*** directory and add some data into it: + +~~~jsx title="data.js" +export function getData() { + function getDate(addDays, hoursValue = 0, minutesValue = 0) { + const date = new Date(); + const secondsValue = 0; // round to minutes + const msValue = 0; + + date.setDate(date.getDate() + addDays); + date.setHours(hoursValue, minutesValue, secondsValue, msValue); + + return date.getTime(); + } + + return [ + { + id: "ee828b5d-a034-420c-889b-978840015d6a", + title: "Natalie Tyson", + category: "Therapist", + subtitle: "2 years of experiece", + details: "Cleveland Clinic\n9500 Euclid Ave", + preview: "https://snippet.dhtmlx.com/codebase/data/booking/01/img/01.jpg", + price: "$35", + review: { + stars: 4, + count: 120 + }, + slots: [ + { + from: 9, + to: 20, + days: [1, 2, 3, 4, 5] + }, + { + from: 10, + to: 18, + days: [6, 0] + } + ] + }, + { + id: "9b037564-77be-429f-b719-eebbe499027a", + title: "Emma Johnson", + category: "Cardiologist", + subtitle: "2 years of experience", + details: "Stanford Health Care\n1468 Madison Ave", + preview: "https://snippet.dhtmlx.com/codebase/data/booking/01/img/03.jpg", + price: "$25", + review: { + stars: 5, + count: 10 + }, + slots: [ + { + from: 14, + to: 17, + size: 30, + gap: 10 + }, + { + from: 12, + to: 19, + size: 50, + gap: 20, + days: [2], + dates: [getDate(0)] + }, + { + from: "18:30", + to: 20, + size: 20, + gap: 20, + days: [3, 4, 5] + } + ], + usedSlots: [getDate(0, 12), getDate(0, 18)] + }, + // ... + ]; +} +~~~ + +Then open the ***App.vue*** file, import data, and initialize it via the inner `data()` method. After this you can pass data into the new created `` component as **props**: + +~~~html {3,7-10,15} title="App.vue" + + + +~~~ + +Go to the ***Booking.vue*** file and apply the passed **props** to the Booking configuration object: + +~~~html {6,10} title="Booking.vue" + + + +~~~ + +Now the Booking component is ready to use. When the element will be added to the page, it will initialize the Booking with data. You can provide necessary configuration settings as well. Visit our [Booking API docs](/api/overview/booking-properties-overview/) to check the full list of available properties. + +#### Handling events + +When a user makes some action in the Booking, it invokes an event. You can use these events to detect the action and run the desired code for it. See the [full list of events](/api/overview/booking-events-overview/). + +Open ***Booking.vue*** and complete the `mounted()` method: + +~~~html {8-11} title="Booking.vue" + + + +~~~ + +After that, you can start the app to see Booking loaded with data on a page. + +![Booking initialization](../assets/trial-booking.png) + +Now you know how to integrate DHTMLX Booking with Vue. You can customize the code according to your specific requirements. The final example you can find on [**GitHub**](https://github.com/DHTMLX/vue-booking-demo). diff --git a/docs/guides/integration-with-widgets.md b/docs/guides/integration-with-widgets.md new file mode 100644 index 0000000..0376c53 --- /dev/null +++ b/docs/guides/integration-with-widgets.md @@ -0,0 +1,17 @@ +--- +sidebar_label: Integration with DHTMLX widgets +title: Integration with DHTMLX widgets +description: You can learn about the integration with DHTMLX widgets in the documentation of the DHTMLX JavaScript Booking library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Booking. +--- + +# Integration with DHTMLX widgets + +You can integrate DHTMLX Booking with such DHTMLX widgets as [Scheduler](https://docs.dhtmlx.com/scheduler/) and [Event Calendar](https://docs.dhtmlx.com/eventcalendar/). Check the examples below. + +## Integration with DHTMLX Scheduler + + + +## Integration with DHTMLX Event Calendar + + diff --git a/docs/guides/loading-data.md b/docs/guides/loading-data.md index fc1a797..80ebb29 100644 --- a/docs/guides/loading-data.md +++ b/docs/guides/loading-data.md @@ -167,4 +167,5 @@ About loading data from the server, refer to [Working with server](/guides/savin - [confirm-slot](/api/events/booking-confirmslot-event) event - [setConfig()](/api/methods/booking-setconfig-method) method - [setConfirmHandler()](/api/methods/booking-setconfirmhandler-method) method +- [renderType](/api/config/booking-rendertype) property - [Saving slots reservations to the server](/guides/saving-reservations) diff --git a/docs/index.md b/docs/index.md index 2fb61c3..817e831 100644 --- a/docs/index.md +++ b/docs/index.md @@ -41,7 +41,7 @@ To open the view of a single card, click inside the left area of a card. The sin ### Booking dialog -The booking dialog allows booking a slot of the selected card: +The booking dialog allows booking a slot of the selected card. To open it, click the time slot button. ![booking](assets/bookingd.png) @@ -59,7 +59,7 @@ It's possible to configure the filter settings via API: [Configuring the filter] ## Making an appointment -To schedule an appointment, click a slot for the required card, and in the **Booking** dialog, fill in the fields, and then click **Make an appointment**. +To schedule an appointment, click the time slot button for the required card, and in the **Booking** dialog, fill in the fields, and then click **Make an appointment**. You can also make an appointment via the single card view: diff --git a/docs/news/whats_new.md b/docs/news/whats_new.md index 205fc5a..7723f5a 100644 --- a/docs/news/whats_new.md +++ b/docs/news/whats_new.md @@ -6,6 +6,15 @@ description: SEO data # What's new +## Version 1.1 + +Released on March 12, 2025 + +### New functionality + +- Lazy rendering of cards via the [`renderType`](/api/config/booking-rendertype) property +- Ability to embed templates via the [`cardTemplate`](/api/config/booking-cardtemplate) and [`infoTemplate`](/api/config/booking-infotemplate) properties + ## Version 1.0.1 Released on November 29, 2024 diff --git a/sidebars.js b/sidebars.js index 0dc7003..de60bd4 100644 --- a/sidebars.js +++ b/sidebars.js @@ -31,12 +31,12 @@ module.exports = { link: { type: "doc", id: "api/overview/booking-methods-overview" - }, + }, items: [ "api/methods/booking-serialize-method", "api/methods/booking-setconfig-method", "api/methods/booking-setconfirmhandler-method", - "api/methods/booking-setlocale-method", + "api/methods/booking-setlocale-method" ] }, // Booking internal methods @@ -61,7 +61,7 @@ module.exports = { "api/internal/booking-exec", "api/internal/booking-intercept", "api/internal/booking-on", - "api/internal/booking-setnext", + "api/internal/booking-setnext" ] }, { @@ -76,9 +76,9 @@ module.exports = { items: [ // "api/internal/booking_innermethodname_method", "api/internal/booking-getreactivestate", - "api/internal/booking-getstate", + "api/internal/booking-getstate" ] - }, + } ] }, { @@ -97,7 +97,7 @@ module.exports = { "api/events/booking-filterdata-event", "api/events/booking-selectslot-event", "api/events/booking-selectitem-event", - "api/events/booking-selectitemdate-event", + "api/events/booking-selectitemdate-event" ] }, { @@ -112,19 +112,42 @@ module.exports = { items: [ // Booking properties "api/config/booking-cardshape", + "api/config/booking-cardtemplate", "api/config/booking-data", "api/config/booking-end", "api/config/booking-filtershape", "api/config/booking-formshape", "api/config/booking-infoshape", + "api/config/booking-infotemplate", "api/config/booking-locale", + "api/config/booking-rendertype", "api/config/booking-slotgap", "api/config/booking-slotsize", - "api/config/booking-start", + "api/config/booking-start" ] } ] }, + //start Backend and frameworks integration + { + type: "category", + label: "Backend and frameworks integration", + link: { + type: 'generated-index', + title: "Backend and frameworks integration", + keywords: ['backend and frameworks integration'], + image: '/img/docusaurus.png' + }, + items: [ + "guides/saving-reservations", + "guides/integration-with-angular", + "guides/integration-with-react", + "guides/integration-with-vue", + "guides/integration-with-svelte", + "guides/integration-with-widgets", + ] + }, + // end Backend and frameworks integration { type: "category", label: "Guides", @@ -134,16 +157,15 @@ module.exports = { type: 'generated-index', title: 'Guides', keywords: ['guides'], - image: '/img/docusaurus.png', + image: '/img/docusaurus.png' }, items: [ "guides/initialization", "guides/loading-data", "guides/configuration", "guides/localization", - "guides/saving-reservations", - "guides/styling", - ], - }, + "guides/styling" + ] + } ] }; diff --git a/yarn.lock b/yarn.lock index 9c02efa..ed041c6 100644 --- a/yarn.lock +++ b/yarn.lock @@ -8741,18 +8741,7 @@ react-helmet-async@*: react-fast-compare "^3.2.2" shallowequal "^1.1.0" -react-helmet-async@^1.3.0: - version "1.3.0" - resolved "https://registry.yarnpkg.com/react-helmet-async/-/react-helmet-async-1.3.0.tgz#7bd5bf8c5c69ea9f02f6083f14ce33ef545c222e" - integrity sha512-9jZ57/dAn9t3q6hneQS0wukqC2ENOBgMNVEhb/ZG9ZSxUetzVIw4iAmEU38IaVg3QGYauQPhSeUTuIUtFglWpg== - dependencies: - "@babel/runtime" "^7.12.5" - invariant "^2.2.4" - prop-types "^15.7.2" - react-fast-compare "^3.2.0" - shallowequal "^1.1.0" - -"react-helmet-async@npm:@slorber/react-helmet-async@*", "react-helmet-async@npm:@slorber/react-helmet-async@1.3.0": +react-helmet-async@^1.3.0, "react-helmet-async@npm:@slorber/react-helmet-async@*", "react-helmet-async@npm:@slorber/react-helmet-async@1.3.0": version "1.3.0" resolved "https://registry.yarnpkg.com/@slorber/react-helmet-async/-/react-helmet-async-1.3.0.tgz#11fbc6094605cf60aa04a28c17e0aab894b4ecff" integrity sha512-e9/OK8VhwUSc67diWI8Rb3I0YgI9/SBQtnhe9aEuK6MhZm7ntZZimXgwXnd8W96YTmSOb9M4d8LwhRZyhWr/1A==