Movatterモバイル変換

webfansplz/vite-plugin-vue-inspectorPublic

NotificationsYou must be signed in to change notification settings
Fork81
Star756

jump to editor source code while click the element of browser automatically.

License

MIT license

756 stars 81 forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 214 Commits
.changeset		.changeset
.github		.github
packages		packages
public		public
.eslintignore		.eslintignore
.eslintrc		.eslintrc
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
logo.svg		logo.svg
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
tsconfig.json		tsconfig.json

Repository files navigation

📖 Introduction

A vite plugin which provides the ability that to jump to the local IDE when you click the element of browser automatically. It supports Vue2 & 3 & SSR.

📦 Installation

# vite-plugin-vue-inspectorpnpm install vite-plugin-vue-inspector -D# unplugin-vue-inspectorpnpm install unplugin-vue-inspector -D

🦄 Usage

Configuration Vite

// for Vue2import{defineConfig,}from'vite'import{createVuePlugin,}from'vite-plugin-vue2'importInspectorfrom'unplugin-vue-inspector/vite'// OR vite-plugin-vue-inspectorexportdefaultdefineConfig({plugins:[createVuePlugin(),Inspector({vue:2}),],})

// for Vue3import{defineConfig}from'vite'importVuefrom'@vitejs/plugin-vue'importInspectorfrom'unplugin-vue-inspector/vite'// OR vite-plugin-vue-inspectorexportdefaultdefineConfig({plugins:[Vue(),Inspector()],})

// for Nuxt3// nuxt.config.tsimport{defineNuxtConfig}from'nuxt/config'importInspectorfrom'vite-plugin-vue-inspector'exportdefaultdefineNuxtConfig({modules:[['unplugin-vue-inspector/nuxt',{enabled:true,toggleButtonVisibility:'always',}],],})

Options

interfaceVitePluginInspectorOptions{/**   * Vue version   *@default 3   */vue?:2|3/**   * Default enable state   *@default false   */enabled?:boolean/**   * Define a combo key to toggle inspector   *@default 'control-shift' on windows, 'meta-shift' on other os   *   * any number of modifiers `control` `shift` `alt` `meta` followed by zero or one regular key, separated by -   * examples: control-shift, control-o, control-alt-s  meta-x control-meta   * Some keys have native behavior (e.g. alt-s opens history menu on firefox).   * To avoid conflicts or accidentally typing into inputs, modifier only combinations are recommended.   * You can also disable it by setting `false`.   */toggleComboKey?:string|false/**   * Toggle button visibility   *@default 'active'   */toggleButtonVisibility?:'always'|'active'|'never'/**   * Toggle button display position   *@default top-right   */toggleButtonPos?:'top-right'|'top-left'|'bottom-right'|'bottom-left'/**   * append an import to the module id ending with `appendTo` instead of adding a script into body   * useful for frameworks that do not support transformIndexHtml hook (e.g. Nuxt3)   *   * WARNING: only set this if you know exactly what it does.   */appendTo?:string|RegExp/**   * Customize openInEditor host (e.g. http://localhost:3000)   *@default false   *@deprecated This option is deprecated and removed in 5.0. The plugin now automatically detects the correct host.   */openInEditorHost?:string|false/**   * lazy load inspector times (ms)   *@default false   */lazyLoad?:number|false/**   * disable inspector on editor open   *@default false   */disableInspectorOnEditorOpen?:boolean/**   * Hide information in VNode and produce clean html in DevTools   *   * Currently, it only works for Vue 3   *   *@default true   */cleanHtml?:boolean/**   * Target editor when open in editor (v5.1.0+)   *   *@default code (Visual Studio Code)   */launchEditor?:'appcode'|'atom'|'atom-beta'|'brackets'|'clion'|'code'|'code-insiders'|'codium'|'emacs'|'idea'|'notepad++'|'pycharm'|'phpstorm'|'rubymine'|'sublime'|'vim'|'visualstudio'|'webstorm'|'cursor'}

Example

Supported editors

Value	Editor	Linux	Windows	OSX
`appcode`	AppCode			✓
`atom`	Atom	✓	✓	✓
`atom-beta`	Atom Beta			✓
`brackets`	Brackets	✓	✓	✓
`clion`	Clion		✓	✓
`code`	Visual Studio Code	✓	✓	✓
`code-insiders`	Visual Studio Code Insiders	✓	✓	✓
`codium`	VSCodium	✓	✓	✓
`emacs`	Emacs	✓
`idea`	IDEA	✓	✓	✓
`notepad++`	Notepad++		✓
`pycharm`	PyCharm	✓	✓	✓
`phpstorm`	PhpStorm	✓	✓	✓
`rubymine`	RubyMine	✓	✓	✓
`sublime`	Sublime Text	✓	✓	✓
`vim`	Vim	✓
`visualstudio`	Visual Studio			✓
`webstorm`	WebStorm	✓	✓	✓
`cursor`	Cursor	✓	✓	✓

🔌 Configuration IDE / Editor

Starting from v5.1.0, We recommend using thelaunchEditor option configuration to specify the IDE (Please ensure that the editor's environment variables are correctly configured beforehand.)

It uses anenvironment variable namedLAUNCH_EDITOR to specify an IDE application, but if you do not set this variable, it will try to open a common IDE that you have open or installed once it is certified.

For example, if you want it always open VS Code when inspection clicked, setexport LAUNCH_EDITOR=code in your shell.

VS Code

install VS Code command line tools,see the official docs
set env to shell, like.bashrc or.zshrc
```
export LAUNCH_EDITOR=code
```

VS Code with WSL (Windows)

add the configuration in thesettings.json
restart the VS Code (All Windows should be closed to take effect)

{// other config..."terminal.integrated.env.linux": {"EDITOR":"code"  }}

WebStorm

just set env with an absolute path to shell, like.bashrc or.zshrc (only MacOS)
```
export LAUNCH_EDITOR='/Applications/WebStorm.app/Contents/MacOS/webstorm'
```

install WebStorm command line tools
then set env to shell, like.bashrc or.zshrc
```
export LAUNCH_EDITOR=webstorm
```

PhpStorm

just set env with an absolute path to shell, like.bashrc or.zshrc (only MacOS)
```
export LAUNCH_EDITOR='/Applications/PhpStorm.app/Contents/MacOS/phpstorm'
```

install PhpStorm command line tools
then set env to shell, like.bashrc or.zshrc
```
export LAUNCH_EDITOR=phpstorm
```

Vim

Yes! you can also use vim if you want, just set env to shell

export LAUNCH_EDITOR=vim

💡 Notice

[BREAKING CHANGE] From v1.0,enabled option default value changed fromtrue tofalse .
It only work in develop mode .
It does not currently supportTemplate Engine (e.g. pug) .

👨‍💻 Programmatic Usage

You can also use control inspector programmatically, by accessing the__VUE_INSPECTOR__ global variable.

importtype{VueInspectorClient}from'vite-plugin-vue-inspector'constinspector:VueInspectorClient=window.__VUE_INSPECTOR__if(inspector){// enable inspectorinspector.enable()// orinspector.disable()}