Props - Svelte Awesome Icons v2
Props #
All icons are extended SVGAttributes from svelte/elements.
- size = ctx.size || '24'
- role = ctx.role || 'img'
- color = ctx.color || 'currentColor'
- title = {}
- desc = {}
- ariaLabel = <icon file name>
- class, id, name, role, and all other props from SVGAttributes
Types #
import type { SVGAttributes } from 'svelte/elements';
type TitleType = {
id?: string;
title?: string;
};
type DescType = {
id?: string;
desc?: string;
};
interface BaseProps extends SVGAttributes<SVGElement> {
size?: string;
role?: string;
color?: string;
}
export interface CtxType extends BaseProps {}
export interface Props extends BaseProps {
title?: TitleType;
desc?: DescType;
ariaLabel?: string;
}
Size #
To change the size of an icon, use the size
prop and specify the desired size. For example:
<CalendarCheckRegular size="40" />
You can add a custom size using Tailwind CSS by including the desired classes in the class
prop. For example:
<CalendarCheckRegular class="h-24 w-24 text-blue-700 mr-4" />
CSS HEX Colors #
Use the color attribute to change colors with HEX color code:
<CalendarCheckRegular color="#ff0000" />
CSS framework #
You can apply CSS framework color and other attributes directly to the icon component or its
parent tag using the class
prop.
Tailwind CSS #
<CalendarCheckRegular size="30" class="text-red-700 dark:text-green-300 inline m-1" />
<div class="text-red-700 dark:text-green-300 inline m-1">
<CalendarCheckRegular size="30" />
</div>
Bootstrap #
<CalendarCheckRegular class="position-absolute top-0 px-1" />
Dark mode #
If you are using the dark mode on your website with Tailwind CSS, add your dark mode class to the class
prop.
<CalendarCheckRegular class="text-blue-700 dark:text-red-500" />
A11y #
All icons have aria-label. For example AddressBookSolid
has aria-label="addressbook solid"
. Use ariaLabel
prop to modify the aria-label
value.
<CalendarCheckRegular ariaLabel="address card outline" />
Use title
, desc
, and ariaLabel
props to make your icons accessible.
<BellRegular
title={{ id: 'my-title', title: 'Red bell' }}
desc={{ id: 'my-descrip', desc: 'The shape of a red bell' }}
ariaLabel="red bell"
color="red"
/>
Passing down other attributes #
As default all icons are extend SVGAttributes SVGElement. You can add all the events and other props described in the type.
<BellRegular
id="my-svg"
transform="rotate(45)"
class="hover:cursor-pointer dark:text-white"
onclick={() => alert('hello')}
/>