Client library that wraps common patterns when interacting with the VirusTotal Augment widget.
npm i @virustotal/vt-augment --save
VT Augment is bundled using the UMD format (@dist/vt-augment.min.js
).
<!--- "VTAugment" will be attached to the global window object. -->
<script src="./node_modules/@virustotal/vt-augment/dist/vt-augment.min.js"></script>
<div id="vt-augment-container"></div>
const container = document.querySelector('#vt-augment-container');
const vtaugment = new VTAugment(container, options)
vtaugment.load("[url]").openDrawer()
This is the default mode, VT Augment will be shown in a right side panel when the openDrawer
method is called.
This mode allows you to integrate the widget as a non-animated div in your page. See Options.
Creates a new object with a html element and a set of options. An iframe is dynamically created inside the container to host the VT API response.
Methods can be chained and can be called in whatever order.
load | openDrawer | closeDrawer | loading |
---|
Loads the VT API url into the iframe.
vtaugment.load("...")
// Additionally, if the mode is `drawer` can be used along with the method `openDrawer`
vtaugment.load("...").openDrawer()
Open a drawer panel from the right side. (Only works in drawer mode)
vtaugment.openDrawer()
Close the drawer panel. (Only works in drawer mode)
vtaugment.closeDrawer()
The loading state is managed internally by the library but in the case of need the api provides this method to control loading manually. (Active loading hide the content)
vtaugment.loading(true)
{
// Background color for loading states. Default ''.
background: '#fff',
// Force to closing the widget only with the X button. Default true.
closingFromOutside: true | false,
// Select the widget mode. Default drawer.
mode: 'drawer' | 'standalone',
}