npm package: @line-copy/vite-plugin
Description: A front-end plugin for locating the code position.
Latest version: 2.0.51

# @line-copy/vite-plugin
A front-end plugin for locating the code position.

When you hold down the Alt key and move the mouse over a component, it will prompt:
* The fileName and line number of the component have been copied. You can then manually open the IDE's search box and paste to open the file.
* Alternatively, you can choose to open the IDE, which will be activated from the background and automatically navigate to the file location.

一个定位代码位置的前端插件，

按住 Alt 键并移动鼠标到组件，会提示:
* 已复制组件所在的 文件名 和 行号 , 之后手工打开ide的搜索文件框 , 黏贴就可打开文件
* 也可以选择 打开ide , 之后ide从后台唤起, 自动导航到文件位置



## ✨ Features 功能特点

- Injects file:line info to specified Vue components (e.g., `<el-button>`)
- 自动向指定的 Vue 组件（如 `<el-button>`）注入 `文件名:行号` 信息
- It provides an @mouseover event binding, allowing you to copy the fileName and line number to the clipboard by holding down the Alt key and hovering over the component, or directly open the IDE.
- 提供 `@mouseover` 事件绑定，实现按住 Alt 悬停即可复制 文件和行号到剪贴板 或者 直接打开IDE
- Useful for debugging and tracing source
- 方便调试和追踪源代码位置

## 📦 Installation 安装

```bash


npm install @line-copy/vite-plugin --save-dev


npm update --force @line-copy/vite-plugin

```

## 🔧 Usage 使用

### In Vite 3 4 5 vite.config.js  在 Vite 3 4 5 vite.config.js中引入插件
```js

import { vitePluginLineCopy , defaultVUEPCOptions} from '@line-copy/vite-plugin';

const options = {
    ...defaultVUEPCOptions,
    printLog: false,
    setEventTagName: '@mouseover.native',// @mouseover @mouseover.native 哪个生效用那个
}

export default {
  plugins: [vitePluginLineCopy(options)],
};

```


### In Vite 2 vite.config.js  在 Vite 2  vite.config.js中引入插件

```js

import {vitePluginLineCopy, defaultVUEPCOptions} from '@line-copy/vite-plugin';

// 插件配置
const vitePluginLineCopyOptions = {...defaultVUEPCOptions, printLog: false}

export default defineConfig(({mode}) => {
    // 获取环境配置文件
    const env = loadEnv(mode, process.cwd())

    const isDev = mode === 'development' // 判断是否为开发环境
    
    return {
        plugins: [
            isDev && vitePluginLineCopy(vitePluginLineCopyOptions)
        ],
    }
})

```

### In main.js  在 main.js 中引用一下js
```js

import {handleShowDebugInfo} from '@line-copy/common/showDebugInfo';

const app = createApp(App)

app.config.globalProperties.handleShowDebugInfo = handleShowDebugInfo

```

## 📋 How it works 工作原理
When Alt is held and your mouse hovers over a target component, it copies a string like:
当按住 Alt 键并鼠标悬停在目标组件上时，会自动复制类似如下格式的字符串：

```
src/components/MyButton.vue:12
```

## 📋 复制文件行号 - 操作说明
### First 第一步  Alt+鼠标 移动到元素上 ,自动复制文件行号
![../../../line_copy_asset/img/1-1.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/1-1.png?v=2)
### Second 第二步  在IDEA中打开文件搜索框 , 复制
![../../../line_copy_asset/img/1-2.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/1-2.png?v=2)
### tips 提示  手工复制
![../../../line_copy_asset/img/1-3.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/1-3.png?v=2)

## 📋 高级 直接打开idea - 操作说明

* 前提在Idea中配置插件 line_copy_idea_plugin

### First 第一步  Alt+鼠标 移动到元素上 , 点击打开IDE
![../../../line_copy_asset/img/2-1.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/2-1.png?v=2)
### Second 第二步  自动打开到文件行号
![../../../line_copy_asset/img/2-2.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/2-2.png?v=2)

## 📋 小程序 复制文件行号  - 操作说明

### First 第一步  长按按钮
![../../../line_copy_asset/img/3-1.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/3-1.png?v=2)
### Second 第二步  选择确定复制文件行号
![../../../line_copy_asset/img/3-2.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/3-2.png?v=2)
### third 第三步   在idea中打开文件搜索框 复制
![../../../line_copy_asset/img/3-3.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/3-3.png?v=2)

## 📋 小程序 直接打开idea - 操作说明

* 前提在Idea中配置插件 line_copy_idea_plugin

### First 第一步  长按按钮
![../../../line_copy_asset/img/4-1.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/4-1.png?v=2)
### Second 第二步  选择打开IDE
![../../../line_copy_asset/img/4-2.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/4-2.png?v=2)
### third 第三步   ide自动打开到文件
![../../../line_copy_asset/img/4-3.png](https://cdn.jsdelivr.net/gh/hnlzwaq/line_copy_asset@master/../line_copy_asset/img/4-3.png?v=2)
 

## 🪪 License
MIT