1.2.2 • Published 4 years ago
@coveops/back-to-top v1.2.2
BackToTop
Disclaimer: This component was built by the community at large and is not an official Coveo JSUI Component. Use this component at your own risk.
Getting Started
- Install the component into your project.
npm i @coveops/back-to-top- Use the Component or extend it
Typescript:
import { BackToTop, IBackToTopOptions } from '@coveops/back-to-top';Javascript
const BackToTop = require('@coveops/back-to-top').BackToTop;- You can also expose the component alongside other components being built in your project.
export * from '@coveops/back-to-top'- Or for quick testing, you can add the script from unpkg
<script src="https://unpkg.com/@coveops/back-to-top@latest/dist/index.min.js"></script>Disclaimer: Unpkg should be used for testing but not for production.
- Include the component in your template as follows:
Place the component in your markup:
<div class="CoveoBackToTop"></div>Options
The following options can be configured:
| Option | Required | Type | Default | Notes |
|---|---|---|---|---|
titleCaption | No | string | Back to Top | Specifies value for the element's title attribute. |
textCaption | No | string | Back to Top | Specifies the text value of the button. |
scrollBehavior | No | string | auto | Specifies the scroll behavior. Can be auto or smooth. |
shouldBeLocalized | No | boolean | false | Specifies whether to translate the button value. |
Extending
Extending the component can be done as follows:
import { BackToTop, IBackToTopOptions } from "@coveops/back-to-top";
export interface IExtendedBackToTopOptions extends IBackToTopOptions {}
export class ExtendedBackToTop extends BackToTop {}Contribute
- Clone the project
- Copy
.env.distto.envand update the COVEO_ORG_ID and COVEO_TOKEN fields in the.envfile to use your Coveo credentials and SERVER_PORT to configure the port of the sandbox - it will use 8080 by default. - Build the code base:
npm run build - Serve the sandbox for live development
npm run serve