Skip to content

Iconify for React function: iconExists

This tutorial is part of Iconify for React functions 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

jsximport { iconExists, loadIcons, Icon } from '@iconify/react';

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

   // 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.