Skip to content

candidosales/svelte-shopify-polaris-icons

Repository files navigation

Svelte Shopify Polaris Icons

image

Original icons in Shopify docs. Inspired by Flowbite Svelte Icons.

Installing

If you're seeing this, you've probably already done this step. Congrats!

pnpm i -D svelte-shopify-polaris-icons

Usage

In a svelte file:

<script>
	import { AbandonedCartFilledMajor } from 'svelte-shopify-polaris-icons';
</script>

<AbandonedCartFilledMajor />

Props

Outline

  • size: 'xs' | 'sm' | 'md' | 'lg' | 'xl' = 'md';
  • role: string = 'img';
  • strokeLinecap: 'round' | 'inherit' | 'butt' | 'square' | null | undefined = 'round';
  • strokeLinejoin: 'round' | 'inherit' | 'miter' | 'bevel' | null | undefined = 'round';
  • strokeWidth = '2';
  • ariaLabel = 'icon file name';

Solid

  • size: 'xs' | 'sm' | 'md' | 'lg' | 'xl' = 'md';
  • role: string = 'img';
  • ariaLabel = 'icon file name';

IDE support

If you are using an LSP-compatible editor, such as VSCode, Atom, Sublime Text, or Neovim, hovering over a component name will display a documentation link, features, props, events, and an example.

Size

The following table provides details about the available sizes for icons:

Size CSS Classes
xs 'w-3 h-3'
sm 'w-4 h-4'
md 'w-5 h-6'
lg 'w-6 h-6'
xl 'w-8 h-8'

To change the size of an icon, use the size prop and specify the desired size. For example:

<AbandonedCartFilledMajor size="md" />

If you want to override the preconfigured size, you can add a custom size using Tailwind CSS by including the desired classes in the class prop. For example:

<AbandonedCartFilledMajor class="h-24 w-24 text-blue-700 mr-4" />

Color

You can apply Tailwind CSS color directly to the icon component or its parent tag using the class prop.

<AbandonedCartFilledMajor size="md" class="text-red-700 dark:text-green-300 inline m-1" />

<div class="text-red-700 dark:text-green-300 inline m-1">
	<AbandonedCartFilledMajor size="md" />
</div>

Dark mode

If you are using the dark mode on your website with Tailwind CSS, add your dark mode class to the class prop.

Let's use dark for the dark mode class as an example.

<AbandonedCartFilledMajor class="text-blue-700 dark:text-red-500" />

aria-label

All icons have aria-label. For example BxAbacus has aria-label="bx abacus". Use ariaLabel prop to modify the aria-label value.

<AbandonedCartFilledMajor ariaLabel="address card solid" />

Unfocusable icon

If you want to make an icon unfocusable, add tabindex="-1".

<AbandonedCartFilledMajor tabindex="-1" />

Using svelte:component

<script>
	import { AbandonedCartFilledMajor } from 'svelte-shopify-polaris-icons';
</script>

<svelte:component this="{AbandonedCartFilledMajor}" />

Using onMount

<script>
	import { AbandonedCartFilledMajor } from 'svelte-shopify-polaris-icons';
	import { onMount } from 'svelte';
	const props = {
		size: '50',
		color: '#ff0000'
	};
	onMount(() => {
		const icon = new AbandonedCartFilledMajor({ target: document.body, props });
	});
</script>

👍 Contribute

If you want to say thank you and/or support the active development this project:

  1. Add a GitHub Star to the project.
  2. Write a review or tutorial on Medium, Dev.to or personal blog.
  3. Support the project by donating a cup of coffee.

☕ Supporters

If you want to support Personal Portfolio, you can ☕ buy a coffee here

⚠️ Copyright and license

Code and documentation copyright 2020-2030 the Authors and Code released under the MIT License. Docs released under Creative Commons.