1.0.1 • Published 3 years ago

ngx-custom-tooltip v1.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

ngx-custom-tooltip

This library was generated with Angular CLI version 9.1.13.

About

Simple and customizable tooltip/pop-up component for Angular projects.
It can be used as a tooltip (it closes when you click outside of it), or as a pop-up with a close button.
It has a ng-content tag, so you can place all kinds of html elements inside them.

Get Started

Step 1: Install ngx-virtual-scroller

npm install ngx-custom-tooltip

Step 2: Import NgxCustomTooltipModule module into your app.module.ts

....
import { NgxCustomTooltipModule } from 'ngx-custom-tooltip';
....
@NgModule({
    ...
    imports: [
        ....
        NgxCustomTooltipModule
    ],
    ....
})
export class AppModule { }

Step 3: Wrap ngx-custom-tooltip tag around your elements in the app.component.html file

<button #target>Open</button>
<ngx-custom-tooltip [target]="target" 
                    (closeEmitter)="handleClose($event)">
    <p>This is a tooltip message!</p>
</ngx-custom-tooltip>

Options

AttributeTypeDefault valueDescription
bgColorstring'#ffffff'background-color property for the tooltip.
borderColorstring'#d3d3d3'border-color property for the tooltip.
borderRadiusstring'4px'border-radious property for the tooltip. Accepts css syntax.
closeButtonbooleanfalseIndicates if the tooltip has a close button. If false, it closes when you click outside of it.
closeButtonImagestringundefinedImage path for close button.
closeButtonMarginstring'20px'Separation of the close button from the border. By default it is placed in the upper right corner. Accepts css syntax.
closeButtonSizestring'20px'height and widht properties for the close button. Accepts css syntax.
displacementnumber0Arbitrary offset of the tooltip from its target. It is ignored if a center type position is chosen. Example: topCenter.
floatingSizenumber3Move the tooltip away from its target.
maxHeightstring'max-content'Maximum height, after that, a vertical scroll appears. Accepts css syntax.
maxWidthstring'max-content'Maximum width, after that, a horizontal scroll appears. Accepts css syntax.
minHeightstring'auto'Minimun height for the tooltip. Accepts css syntax.
minWidthstring'auto'Minimun width for the tooltip. Accepts css syntax.
paddingstring'8px'padding property for the tooltip. Accepts css syntax.
popUpPositionstring'topCenter'The position of the tooltip. Valid values: ['topStart', 'topCenter', 'topEnd', 'bottomStart', 'bottomCenter', 'bottomEnd', 'leftStart', 'leftCenter', 'leftEnd', 'rightStart', 'rightCenter', 'rightEnd'].
targetHTMLElementundefinedThe HTMLEelement that activates the tooltip. If closeButton is false the target is excluded for the clickout event that close the button.
triangleBgColorstringundefinedbackground-color property for the triangle. If not provided, bgColor is used.
(closeEmitter)booleanEmit false when tooltip is closed.