Code Monkey home page Code Monkey logo

electron-prompt's Introduction

electron-prompt

Electron helper to prompt for a value via input or select

Build Status XO code style

Usage

npm install electron-prompt --save
prompt([options, parentBrowserWindow]).then(...).catch(...)

Example

const prompt = require('electron-prompt');

prompt({
    title: 'Prompt example',
    label: 'URL:',
    value: 'http://example.org',
    inputAttrs: {
        type: 'url'
    },
    type: 'input'
})
.then((r) => {
    if(r === null) {
        console.log('user cancelled');
    } else {
        console.log('result', r);
    }
})
.catch(console.error);

Documentation

Primary method:

prompt([options, parentBrowserWindow]).then(...).catch(...)

Options object (optional)

Key Explanation
title (optional, string) The title of the prompt window. Defaults to 'Prompt'.
label (optional, string) The label which appears on the prompt for the input field. Defaults to 'Please input a value:'.
buttonLabels (optional, object) The text for the OK/cancel buttons. Properties are 'ok' and 'cancel'. Defaults to null.
value (optional, string) The default value for the input field. Defaults to null.
type (optional, string) The type of input field, either 'input' for a standard text input field or 'select' for a dropdown type input. Defaults to 'input'.
inputAttrs (optional, object) The attributes of the input field, analagous to the HTML attributes: {type: 'text', required: true} -> <input type="text" required>. Used if the type is 'input'
selectOptions (optional, object) The items for the select dropdown if using the 'select' type in the format 'value': 'display text', where the value is what will be given to the then block and the display text is what the user will see.
useHtmlLabel (optional, boolean) Whether the label should be interpreted as HTML or not. Defaults to false.
width (optional, integer) The width of the prompt window. Defaults to 370.
minWidth (optional, integer) The minimum allowed width for the prompt window. Same default value as width.
height (optional, integer) The height of the prompt window. Defaults to 130.
minHeight (optional, integer) The minimum allowed height for the prompt window. Same default value as height.
resizable (optional, boolean) Whether the prompt window can be resized or not (also sets useContentSize). Defaults to false.
alwaysOnTop (optional, boolean) Whether the window should always stay on top of other windows. Defaults to false
icon (optional, string) The path to an icon image to use in the title bar. Defaults to null and uses electron's icon.
customStylesheet (optional, string) The local path of a CSS file to stylize the prompt window. Defaults to null.
menuBarVisible (optional, boolean) Whether to show the menubar or not. Defaults to false.
skipTaskbar (optional, boolean) Whether to show the prompt window icon in taskbar. Defaults to true.

If not supplied, it uses the defaults listed in the table above.

parentBrowserWindow (optional)

The window in which to display the prompt on. If not supplied, the parent window of the prompt will be null.

electron-prompt's People

Contributors

p-sam avatar alandoyle95 avatar thewizardplusplus avatar dorkalev avatar fraasi avatar andersonmamede avatar kickthedragon avatar ajwfrost avatar julusian avatar kylecorry31 avatar si458 avatar sanappa avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.