0.26.1722793934 β€’ Published 1 month ago

@iconify-prerendered/vue-guidance v0.26.1722793934

Weekly downloads
-
License
CC-BY-4.0
Repository
github
Last release
1 month ago

Important

This project is maintained by developer from Ukraine πŸ‡ΊπŸ‡¦

Due to the ongoing war resulting from Russia's full-scale invasion of Ukraine, I currently lack the time for the full development of this open-source project. My primary focus is on ensuring the well-being of myself and my family.

I'll prioritize and review all new contributions as soon as possible.

If you can, please consider supporting Ukraine or me personally.

Thank you for your understanding and support.


Guidance components for Vue

Designed for ease of use and high performance. Each icon in set is a standalone component.

Features

  • Easy to use
    • No plugins required! Compatible with any build tools.
    • Designed for the best compatibility with IDE auto-completion (Demo).
    • Zero dependencies.
    • SSR / SSG friendly.
    • TypeScript support.
  • High performance
    • Does not require any external resources like fonts, css, images.
    • The icon code is embedded in your bundle.
    • Supports tree shaking, so only those icons that you have used will be included in the bundle.
    • Works offline.
  • Powered by iconify.

Usage

<script setup>
// Import components as usual
import {
	IconSmokingArea,
	IconPlayground,
	IconGlass,
	IconPaper,
	IconEscalator,
	IconPrinter,
} from '@iconify-prerendered/vue-guidance'
</script>

<template>
	<!-- And just use it in template -->
  	<IconSmokingArea/>
	<IconPlayground/>
	<IconGlass/>
	<IconPaper/>
	<IconEscalator/>
	<IconPrinter/>
</template>

Only these three icons will be included in your bundle. Your bundler may tree-shake all other icons.

That's all you need. No plugins, extra configs, IDE extensions or something else.

Customizing icon default attributes

By default, all icons have only two attributes: role="img" and aria-hidden="true". While you are free to redefine these attributes or add new ones for each icon, you might want to apply certain attributes, such as class or style, to all icons within a set.

To achieve this, you can re-export icons through a new Proxy and include default attributes

import * as defaultIcons from '@iconify-prerendered/vue-guidance';

// accessing to icon through this Proxy will add additional attributes
export const themedIcons = new Proxy({}, {
  get(_, iconKey) {
    return () =>
      defaultIcons[iconKey]({
        class: 'pre-defined-class',
        // ... any other attributes
      });
  },
});

See full docs or other available icons sets.