0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-05 17:24:20 +01:00
Bootstrap/site/content/docs/5.2/extend/icons.md

41 lines
1.7 KiB
Markdown
Raw Normal View History

2014-12-06 09:18:44 +01:00
---
layout: docs
2017-02-05 06:14:41 +01:00
title: Icons
2017-05-28 20:25:59 +02:00
description: Guidance and suggestions for using external icon libraries with Bootstrap.
2017-02-05 06:14:41 +01:00
group: extend
2014-12-06 09:18:44 +01:00
---
While Bootstrap doesn't include an icon set by default, we do have our own comprehensive icon library called Bootstrap Icons. Feel free to use them or any other icon set in your project. We've included details for Bootstrap Icons and other preferred icon sets below.
2017-02-05 06:14:41 +01:00
While most icon sets include multiple file formats, we prefer SVG implementations for their improved accessibility and vector support.
2017-09-26 13:50:35 +02:00
## Bootstrap Icons
Bootstrap Icons is a growing library of SVG icons that are designed by [@mdo](https://github.com/mdo) and maintained by [the Bootstrap Team](https://github.com/orgs/twbs/people). The beginnings of this icon set come from Bootstrap's very own components—our forms, carousels, and more. Bootstrap has very few icon needs out of the box, so we didn't need much. However, once we got going, we couldn't stop making more.
Oh, and did we mention they're completely open source? Licensed under MIT, just like Bootstrap, our icon set is available to everyone.
2020-06-28 20:05:52 +02:00
[Learn more about Bootstrap Icons]({{< param icons >}}), including how to install them and recommended usage.
## Alternatives
We've tested and used these icon sets ourselves as preferred alternatives to Bootstrap Icons.
2017-02-05 06:14:41 +01:00
2019-07-23 08:41:14 +02:00
{{< markdown >}}
{{< icons.inline >}}
{{- $type := .Get "type" | default "preferred" -}}
{{- range (index .Site.Data.icons $type) }}
- [{{ .name }}]({{ .website }})
{{- end }}
{{< /icons.inline >}}
{{< /markdown >}}
2017-02-05 06:14:41 +01:00
## More options
2017-09-26 13:50:35 +02:00
While we haven't tried these out ourselves, they do look promising and provide multiple formats, including SVG.
2017-02-05 06:14:41 +01:00
2019-07-23 08:41:14 +02:00
{{< markdown >}}
{{< icons.inline type="more" />}}
{{< /markdown >}}