Spaces:
Running
Running
# `@inquirer/confirm` | |
Simple interactive command line prompt to gather boolean input from users. | |
 | |
# Special Thanks | |
<div align="center" markdown="1"> | |
[](https://graphite.dev/?utm_source=npmjs&utm_medium=repo&utm_campaign=inquirerjs)<br> | |
### [Graphite is the AI developer productivity platform helping teams on GitHub ship higher quality software, faster](https://graphite.dev/?utm_source=npmjs&utm_medium=repo&utm_campaign=inquirerjs) | |
</div> | |
# Installation | |
<table> | |
<tr> | |
<th>npm</th> | |
<th>yarn</th> | |
</tr> | |
<tr> | |
<td> | |
```sh | |
npm install @inquirer/prompts | |
``` | |
</td> | |
<td> | |
```sh | |
yarn add @inquirer/prompts | |
``` | |
</td> | |
</tr> | |
<tr> | |
<td colSpan="2" align="center">Or</td> | |
</tr> | |
<tr> | |
<td> | |
```sh | |
npm install @inquirer/confirm | |
``` | |
</td> | |
<td> | |
```sh | |
yarn add @inquirer/confirm | |
``` | |
</td> | |
</tr> | |
</table> | |
# Usage | |
```js | |
import { confirm } from '@inquirer/prompts'; | |
// Or | |
// import confirm from '@inquirer/confirm'; | |
const answer = await confirm({ message: 'Continue?' }); | |
``` | |
## Options | |
| Property | Type | Required | Description | | |
| ----------- | ----------------------- | -------- | ------------------------------------------------------- | | |
| message | `string` | yes | The question to ask | | |
| default | `boolean` | no | Default answer (true or false) | | |
| transformer | `(boolean) => string` | no | Transform the prompt printed message to a custom string | | |
| theme | [See Theming](#Theming) | no | Customize look of the prompt. | | |
## Theming | |
You can theme a prompt by passing a `theme` object option. The theme object only need to includes the keys you wish to modify, we'll fallback on the defaults for the rest. | |
```ts | |
type Theme = { | |
prefix: string | { idle: string; done: string }; | |
spinner: { | |
interval: number; | |
frames: string[]; | |
}; | |
style: { | |
answer: (text: string) => string; | |
message: (text: string, status: 'idle' | 'done' | 'loading') => string; | |
defaultAnswer: (text: string) => string; | |
}; | |
}; | |
``` | |
# License | |
Copyright (c) 2023 Simon Boudrias (twitter: [@vaxilart](https://twitter.com/Vaxilart))<br/> | |
Licensed under the MIT license. | |