@coveops/tooltip
v1.0.0
Published
This is a simple tooltip component meant to display a block of text upon hover.
Downloads
5
Maintainers
Keywords
Readme
Tooltip
This is a simple tooltip component meant to display a block of text upon hover.
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/tooltip
- Use the Component or extend it
Typescript:
import { Tooltip, ITooltipOptions } from '@coveops/tooltip';
Javascript
const Tooltip = require('@coveops/tooltip').Tooltip;
- You can also expose the component alongside other components being built in your project.
export * from '@coveops/tooltip'
- Or for quick testing, you can add the script from unpkg
<script src="https://unpkg.com/@coveops/tooltip@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="CoveoTooltip"></div>
Options
The following options can be configured:
| Option | Required | Type | Default | Notes |
| --- | --- | --- | --- | --- |
| tooltipText
| No | string | Help.
| The tooltip hover text. |
| tooltipContent
| No | string | I am some text in a tooltip.
| The content of the tooltip. Displayed when the user hovers over the tooltip text (described above). |
| position
| No | boolean | top
| Determines the position of the tooltip. Allowed values are top
, bottom
, left
, right
. |
Extending
Extending the component can be done as follows:
import { Tooltip, ITooltipOptions } from "@coveops/tooltip";
export interface IExtendedTooltipOptions extends ITooltipOptions {}
export class ExtendedTooltip extends Tooltip {}
Contribute
- Clone the project
- Copy
.env.dist
to.env
and update the COVEO_ORG_ID and COVEO_TOKEN fields in the.env
file 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