Skip to content

Web component function: iconExists

This tutorial is part of Iconify Icon web component tutorial.

The function iconExists() checks if icon data is available for rendering.

Usage

The function has the following parameter:

  • name, string. Icon name.

The function returns boolean value: true if icon is available, false if icon is not available.

Example

jsimport { iconExists, loadIcons } from 'iconify-icon';

function renderLeftArrow() {
   // Check if 'bi:arrow-left' is available
   if (iconExists('bi:arrow-left')) {
       // Return HTML for 'bi:arrow-left'
       return '<iconify-icon icon="bi:arrow-left"></iconify-icon>';
   }

   // Load icon. Bad example because this should use a callback to re-render arrow in a stateful
   // component, but this code example is about iconExists(), not loadIcons()

   // Function loadIcons() is asynchronous, so in this example it will only trigger loading, but
   // icon data will not be available immediately
   loadIcons(['bi:arrow-left']);

   // Return '<'
   return '<span>&lt;</span>';
}

Released under the Apache 2.0 License.