Socket
Socket
Sign inDemoInstall

@aristotle-metadata-enterprises/aristotle_tooltip

Package Overview
Dependencies
4
Maintainers
3
Versions
11
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    @aristotle-metadata-enterprises/aristotle_tooltip

Aristotle Tooltip: add Aristotle functionality to any website!


Version published
Maintainers
3
Install size
4.00 MB
Created

Readme

Source

Javascript Tests Publish to NPM

Aristotle Cloud Services Australia

Aristotle Tooltip

A highly customisable and easy to use way to insert Aristotle powered definitions to your website!

Features

  • :heavy_check_mark: Adaptable: use any Aristotle Metadata Registry!
  • :globe_with_meridians: IE11+ Support * : compatible with 99% of desktop and 98% of mobile users.
  • :mouse: Light: weighs just 60kb, including image assets.
  • :dog: Dogfooded: This library is used in our production Aristotle Registries. Updates guaranteed!

Example

Image

Quick Start

Package Manager

Install the aristotle-tooltip package:

frankie@aristotle:~$ npm i @aristotle-metadata-enterprises/aristotle_tooltip

In your application, import the aristotle_tooltip module, and the core css:

import aristotleTooltip from '@aristotle-metadata-enterprises/aristotle_tooltip'
import 'aristotle_tooltip/dist/tooltip.css'

This assumes you're using a module bundler like Webpack, Rollup or Parcel.

CDN

<script src="https://cdn.jsdelivr.net/npm/@aristotle-metadata-enterprises/aristotle_tooltip@latest/dist/aristotletooltip.min.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@aristotle-metadata-enterprises/aristotle_tooltip@latest/dist/tooltip.css">

Place the script at the very bottom of the <body>. It must be placed before your own scripts, because of how the underlying Tippy.js library adds the tooltips.

Usage

To add a tooltip for a piece of content on your webpage:

A <a href="#" data-aristotle-concept-id="498427">person</a> is known by the company they keep

Custom styling for Aristotle links can set by applying CSS rules that target attribute decorators:

a[data-aristotle-concept-id] {
  border-bottom: 1px dotted #155799;
}
a[data-aristotle-concept-id]:hover {
  text-decoration: none;
  border-bottom: 1px solid #155799;
}

Setup

let options = {
  'url': 'https://registry.aristotlemetadata.com',
  'definitionWords': 50,
  'longDefinitionWords': 75,
};
aristotleTooltip(options);

Options

OptionDefaultExplanation
urlregistry.aristotlemetadata.comThe URL of an Aristotle Metadata Registry
definitionWords50The number of words to display in the initial popup
longDefinitionWords75The number of words to display when 'see more..' is pressed
placementbottomThe positioning of the tooltip
triggermouseenter focusEvents used to trigger the tooltip
externalLinkVisibletrueWhether to display an external link icon next to the name of the metadata item
selectordocument.bodyElement or css selector for creating tooltips under, tooltips not under this element will be ignored
interactivetrueWhether interactive content such as links should be displayed

Setting up a Development Environment

We're an open source project that welcomes any new contributions. To setup a development environment, simply fork the repo, clone it locally, and from within the aristotle-tooltip project, run:

oscar@aristotle:~$ npm install
oscar@aristotle:~$ npm run build:dev

IE11 Compatibility

A Promise polyfill is required for IE11 compatibility.aristotle-tooltip has been tested to work with ES6 Promise

ES6 Promise with a CDN

<script src="https://cdn.jsdelivr.net/npm/es6-promise@4/dist/es6-promise.auto.js"></script> 

Keywords

FAQs

Last updated on 25 Nov 2022

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc