https://github.com/shpingalet007/element-selector

Simple web element selector inspired by Chrome DevTools
https://github.com/shpingalet007/element-selector

chrome-extension chrome-extension-development chrome-extensions dev-tools developer-tool developer-tools devtools

Last synced: 12 days ago
JSON representation

Simple web element selector inspired by Chrome DevTools

• Host: GitHub
• URL: https://github.com/shpingalet007/element-selector
• Owner: shpingalet007
• License: gpl-3.0
• Created: 2023-05-07T11:18:54.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-07-04T15:36:41.000Z (almost 2 years ago)
• Last Synced: 2025-05-09T14:46:04.529Z (15 days ago)
• Topics: chrome-extension, chrome-extension-development, chrome-extensions, dev-tools, developer-tool, developer-tools, devtools
• Language: JavaScript
• Homepage:
• Size: 499 KB
• Stars: 14
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Simple web element selector

Did you ever think about the ability to make your custom ⌘ ⇧ C (inspect element) in your extension or tool? Yeah, we did too. And, of course, browsers doesn't provide any API to use it. Fortunately, we were looking for the same solution and finally wrote a small library.

### The benefits

- 🛠 Compatible with `` and `import()` usage

- 🪶 Zero-dependent library, only native code

- ☄️ We use HTML5 Canvas to draw the selection, so it's fast

- 🍩 We use modern JavaScript, yummy

- 💫 It's asynchronous, no callbacks needed

## Installation

### Use it with NPM

```

npm i element-selector

```

### Use it with CDN

```

<script src="//cdn.jsdelivr.net/npm/[email protected]/dist/main.js">

```

## How to use

There are only 2 public methods

```js

let elementSelector = new ElementSelector();

/**

 * Toggle element selector interface

 * - use async/await

 * - use then callback

 */

let selectedElement = await elementSelector.togglePrompt();

/**

 * After you don't need it you can

 * destroy canvas and styles objects

 */

elementSelector.destroy();

```