Package Exports
- material-file-icons
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (material-file-icons) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
material-file-icons
Beautiful material style file type icons packaged in a single JavaScript file.
Source of icons is the Material Icon Theme for VS Code. All credit for icon design should go there. This is also the place for placing requests for adding new icons.
Version 1.x of this library was React specific, since 2.0 this library is made to be framework agnostic.
Features
- Zero dependencies.
- Contains 339 unique icons.
- Can automatically select icon based on file name.
- Uses SVG images that can scale to any dimensions.
- All icons a bundled in a single file of about 438 kB minified.
- Although primarily focused on file types used in software development, other common file types are also included.
Install
npm install --save material-file-icons
Usage Examples
React:
import { getIcon } from 'material-file-icons';
function FileIcon({ filename, style, className }) {
return <div
style={style}
className={className}
dangerouslySetInnerHTML={{ __html: getIcon(filename).svg }}
/>;
}
export default FileIcon;
Vue:
<template>
<div v-html="svg"></div>
</template>
<script>
import { getIcon } from 'material-file-icons';
export default {
name: "FileIcon",
props: ["filename"],
computed: {
svg: function () {
return getIcon(this.filename).svg;
}
}
};
</script>
Svelte:
<script>
import { getIcon } from 'material-file-icons';
export let filename;
$: selectedIcon = getIcon(filename);
</script>
<div class={$$props.class} style={$$props.style}>
{@html selectedIcon.svg}
</div>
API
Icon
The Icon type definition
{
name: string, // The name of the icon e.g. 'javascript'.
svg: string, // The actual SVG content '<svg ...'.
extensions: Array<string>?, // List of extensions this Icon should be applied to.
files: Array<string>? // List of complete filenames this icon should be applied to.
}
defaultIcon: Icon
The default file
icon.
getIcon(filename: string): Icon
Returns an icon based on filename input.
getAllIcons(): Array<Icon>
Returns an array of all available icons.