You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
140 lines
4.6 KiB
140 lines
4.6 KiB
4 years ago
|
# figures [![Build Status](https://travis-ci.org/sindresorhus/figures.svg?branch=master)](https://travis-ci.org/sindresorhus/figures)
|
||
|
|
||
|
> Unicode symbols with Windows CMD fallbacks
|
||
|
|
||
|
[![](screenshot.png)](index.js)
|
||
|
|
||
|
[*and more...*](index.js)
|
||
|
|
||
|
Windows CMD only supports a [limited character set](http://en.wikipedia.org/wiki/Code_page_437).
|
||
|
|
||
|
## Install
|
||
|
|
||
|
```
|
||
|
$ npm install figures
|
||
|
```
|
||
|
|
||
|
## Usage
|
||
|
|
||
|
See the [source](index.js) for supported symbols.
|
||
|
|
||
|
```js
|
||
|
const figures = require('figures');
|
||
|
|
||
|
console.log(figures('✔︎ check'));
|
||
|
// On non-Windows OSes: ✔︎ check
|
||
|
// On Windows: √ check
|
||
|
|
||
|
console.log(figures.tick);
|
||
|
// On non-Windows OSes: ✔︎
|
||
|
// On Windows: √
|
||
|
|
||
|
console.log(figures.main.tick);
|
||
|
// On all OSes: ✔︎
|
||
|
|
||
|
console.log(figures.windows.tick);
|
||
|
// On all OSes: √
|
||
|
```
|
||
|
|
||
|
## API
|
||
|
|
||
|
### figures(string)
|
||
|
|
||
|
Returns the input with replaced fallback Unicode symbols on Windows.
|
||
|
|
||
|
All the below [figures](#figures) are attached to the main export as shown in the example above.
|
||
|
|
||
|
#### string
|
||
|
|
||
|
Type: `string`
|
||
|
|
||
|
String where the Unicode symbols will be replaced with fallback symbols depending on the OS.
|
||
|
|
||
|
### figures.main
|
||
|
|
||
|
Symbols to use when not running on Windows.
|
||
|
|
||
|
### figures.windows
|
||
|
|
||
|
Symbols to use when running on Windows.
|
||
|
|
||
|
|
||
|
## Figures
|
||
|
|
||
|
| Name | Non-Windows | Windows |
|
||
|
| ------------------ | :---------: | :-----: |
|
||
|
| tick | ✔ | √ |
|
||
|
| cross | ✖ | × |
|
||
|
| star | ★ | * |
|
||
|
| square | ▇ | █ |
|
||
|
| squareSmall | ◻ | [ ] |
|
||
|
| squareSmallFilled | ◼ | [█] |
|
||
|
| play | ▶ | ► |
|
||
|
| circle | ◯ | ( ) |
|
||
|
| circleFilled | ◉ | (*) |
|
||
|
| circleDotted | ◌ | ( ) |
|
||
|
| circleDouble | ◎ | ( ) |
|
||
|
| circleCircle | ⓞ | (○) |
|
||
|
| circleCross | ⓧ | (×) |
|
||
|
| circlePipe | Ⓘ | (│) |
|
||
|
| circleQuestionMark | ?⃝ | (?) |
|
||
|
| bullet | ● | * |
|
||
|
| dot | ․ | . |
|
||
|
| line | ─ | ─ |
|
||
|
| ellipsis | … | ... |
|
||
|
| pointer | ❯ | > |
|
||
|
| pointerSmall | › | » |
|
||
|
| info | ℹ | i |
|
||
|
| warning | ⚠ | ‼ |
|
||
|
| hamburger | ☰ | ≡ |
|
||
|
| smiley | ㋡ | ☺ |
|
||
|
| mustache | ෴ | ┌─┐ |
|
||
|
| heart | ♥ | ♥ |
|
||
|
| nodejs | ⬢ | ♦ |
|
||
|
| arrowUp | ↑ | ↑ |
|
||
|
| arrowDown | ↓ | ↓ |
|
||
|
| arrowLeft | ← | ← |
|
||
|
| arrowRight | → | → |
|
||
|
| radioOn | ◉ | (*) |
|
||
|
| radioOff | ◯ | ( ) |
|
||
|
| checkboxOn | ☒ | [×] |
|
||
|
| checkboxOff | ☐ | [ ] |
|
||
|
| checkboxCircleOn | ⓧ | (×) |
|
||
|
| checkboxCircleOff | Ⓘ | ( ) |
|
||
|
| questionMarkPrefix | ?⃝ | ? |
|
||
|
| oneHalf | ½ | 1/2 |
|
||
|
| oneThird | ⅓ | 1/3 |
|
||
|
| oneQuarter | ¼ | 1/4 |
|
||
|
| oneFifth | ⅕ | 1/5 |
|
||
|
| oneSixth | ⅙ | 1/6 |
|
||
|
| oneSeventh | ⅐ | 1/7 |
|
||
|
| oneEighth | ⅛ | 1/8 |
|
||
|
| oneNinth | ⅑ | 1/9 |
|
||
|
| oneTenth | ⅒ | 1/10 |
|
||
|
| twoThirds | ⅔ | 2/3 |
|
||
|
| twoFifths | ⅖ | 2/5 |
|
||
|
| threeQuarters | ¾ | 3/4 |
|
||
|
| threeFifths | ⅗ | 3/5 |
|
||
|
| threeEighths | ⅜ | 3/8 |
|
||
|
| fourFifths | ⅘ | 4/5 |
|
||
|
| fiveSixths | ⅚ | 5/6 |
|
||
|
| fiveEighths | ⅝ | 5/8 |
|
||
|
| sevenEighths | ⅞ | 7/8 |
|
||
|
|
||
|
|
||
|
## Related
|
||
|
|
||
|
- [log-symbols](https://github.com/sindresorhus/log-symbols) - Colored symbols for various log levels
|
||
|
|
||
|
---
|
||
|
|
||
|
<div align="center">
|
||
|
<b>
|
||
|
<a href="https://tidelift.com/subscription/pkg/npm-figures?utm_source=npm-figures&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
|
||
|
</b>
|
||
|
<br>
|
||
|
<sub>
|
||
|
Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
|
||
|
</sub>
|
||
|
</div>
|