primevue-mirror/pages/icons/index.vue

168 lines
4.7 KiB
Vue
Raw Normal View History

2022-09-09 20:41:18 +00:00
<template>
<div>
2022-12-19 11:57:07 +00:00
<Head>
<Title>Vue Icon Library - PrimeVue</Title>
<Meta name="description" content="PrimeVue components internally use PrimeIcons library." />
</Head>
2022-09-09 20:41:18 +00:00
<div class="content-section documentation">
<h1>Icons</h1>
<p>PrimeVue components internally use <a href="https://github.com/primefaces/primeicons">PrimeIcons</a> library, the official icons suite from <a href="https://www.primetek.com.tr">PrimeTek</a>.</p>
<h5>Download</h5>
<p>PrimeIcons is available at npm, run the following command to download it to your project.</p>
<pre v-code.script><code>
npm install primeicons --save
</code></pre>
<p>Then import the library.</p>
<pre v-code.script><code>
import 'primeicons/primeicons.css';
</code></pre>
<h5>Getting Started</h5>
<p>PrimeIcons use the <strong>pi pi-&#123;icon&#125;</strong> syntax such as <strong>pi pi-check</strong>. A standalone icon can be displayed using an element like <i>i</i> or <i>span</i></p>
<pre v-code><code>
&lt;i class="pi pi-check"&gt;&lt;/i&gt;
&lt;i class="pi pi-times"&gt;&lt;/i&gt;
</code></pre>
<i class="pi pi-check" style="margin-right: 0.5rem"></i>
<i class="pi pi-times"></i>
<h5>Size</h5>
<p>Size of the icons can easily be changed using font-size property.</p>
<pre v-code><code>
&lt;i class="pi pi-check"&gt;&lt;/i&gt;
</code></pre>
<i class="pi pi-check"></i>
<pre v-code><code>
&lt;i class="pi pi-check" style="font-size: 2rem"&gt;&lt;/i&gt;
</code></pre>
<i class="pi pi-check" style="font-size: 2rem"></i>
<h5>Spinning Animation</h5>
<p>Special pi-spin class applies continuous rotation to an icon.</p>
<pre v-code><code>
&lt;i class="pi pi-spin pi-spinner" style="font-size: 2rem"&gt;&lt;/i&gt;
</code></pre>
<i class="pi pi-spin pi-spinner" style="font-size: 2rem"></i>
<h5>Constants</h5>
<p>PrimeIcons constants API is provided to easily choose an icon with typescript e.g. when defining a menu model.</p>
<pre v-code><code>
&lt;Menu :model="items" /&gt;
</code></pre>
<pre v-code.script><code>
import {PrimeIcons} from 'primevue/api';
export default {
data() {
return {
items: [
{
label: 'Update',
icon: PrimeIcons.REFRESH,
to: '/update'
},
{
label: 'Delete',
icon: PrimeIcons.TIMES,
to: '/delete'
}
]
}
}
}
</code></pre>
<h5>List of Icons</h5>
<p>Here is the current list of PrimeIcons, more icons are added periodically. You may also <a href="https://github.com/primefaces/primeicons/issues">request new icons</a> at the issue tracker.</p>
<InputText v-model="filter" class="icon-filter" placeholder="Search an icon" />
<div class="grid icons-list">
2022-12-08 12:26:57 +00:00
<div v-for="icon of filteredIcons" :key="icon.properties.name" class="col-12 md:col-2 icon">
2022-09-09 20:41:18 +00:00
<i :class="'pi pi-' + icon.properties.name"></i>
<div>pi-{{ icon.properties.name }}</div>
</div>
</div>
</div>
</div>
</template>
<script>
export default {
data() {
return {
icons: null,
filter: null
};
},
mounted() {
fetch('demo/data/icons.json', { headers: { 'Cache-Control': 'no-cache' } })
.then((res) => res.json())
.then((d) => {
let icons = d.icons;
let data = icons.filter((value) => {
return value.icon.tags.indexOf('deprecate') === -1;
});
2022-12-08 12:26:57 +00:00
2022-09-09 20:41:18 +00:00
data.sort((icon1, icon2) => {
if (icon1.properties.name < icon2.properties.name) return -1;
2022-12-08 12:26:57 +00:00
// eslint-disable-next-line no-dupe-else-if
2022-09-09 20:41:18 +00:00
else if (icon1.properties.name < icon2.properties.name) return 1;
else return 0;
});
this.icons = data;
});
},
computed: {
filteredIcons() {
if (this.filter) return this.icons.filter((icon) => icon.properties.name.indexOf(this.filter.toLowerCase()) > -1);
else return this.icons;
}
}
};
</script>
<style lang="scss" scoped>
.icon-filter {
width: 100%;
padding: 1rem;
margin: 1rem 0 1.5rem 0;
}
.icons-list {
text-align: center;
i {
font-size: 1.5rem;
color: var(--text-color-secondary);
margin-bottom: 0.5rem;
}
.icon {
padding-bottom: 2rem;
}
}
</style>