SVG Pan Zoom 项目使用教程

2026-01-16 09:48:22作者：裘旻烁

目录结构及介绍

SVG Pan Zoom 项目的目录结构如下：

svg-pan-zoom/
├── demo/
│   ├── index.html
│   ├── require.html
│   └── ...
├── dist/
│   ├── svg-pan-zoom.js
│   └── svg-pan-zoom.min.js
├── src/
│   ├── svg-pan-zoom.js
│   └── ...
├── .gitignore
├── LICENSE
├── package.json
├── README.md
└── ...

目录介绍

demo/: 包含项目的示例文件，如 index.html 和 require.html。
dist/: 包含编译后的 JavaScript 文件，如 svg-pan-zoom.js 和 svg-pan-zoom.min.js。
src/: 包含项目的源代码文件，如 svg-pan-zoom.js。
.gitignore: Git 忽略文件。
LICENSE: 项目许可证。
package.json: 项目的 npm 配置文件。
README.md: 项目的说明文档。

项目的启动文件介绍

项目的启动文件主要是 demo/index.html，它包含了 SVG Pan Zoom 的基本使用示例。以下是 index.html 的部分代码：

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>SVG Pan Zoom Demo</title>
  <script src="../dist/svg-pan-zoom.js"></script>
</head>
<body>
  <svg id="demo-tiger">
    <!-- SVG content -->
  </svg>
  <script>
    var panZoomTiger = svgPanZoom('#demo-tiger', {
      zoomEnabled: true,
      controlIconsEnabled: true
    });
  </script>
</body>
</html>

启动文件介绍

<script src="../dist/svg-pan-zoom.js"></script>: 引入编译后的 SVG Pan Zoom 库。
<svg id="demo-tiger">: 定义一个 SVG 元素。
var panZoomTiger = svgPanZoom('#demo-tiger', {...});: 初始化 SVG Pan Zoom 实例，并启用缩放和控制图标。

项目的配置文件介绍

项目的配置文件主要是 package.json，它包含了项目的依赖、脚本和其他配置信息。以下是 package.json 的部分内容：

{
  "name": "svg-pan-zoom",
  "version": "3.6.1",
  "description": "JavaScript library for panning and zooming SVG things",
  "main": "dist/svg-pan-zoom.js",
  "scripts": {
    "build": "grunt build",
    "test": "grunt test"
  },
  "repository": {
    "type": "git",
    "url": "git+https://github.com/bumbu/svg-pan-zoom.git"
  },
  "keywords": [
    "svg",
    "pan",
    "zoom",
    "javascript"
  ],
  "author": "bumbu",
  "license": "MIT",
  "bugs": {
    "url": "https://github.com/bumbu/svg-pan-zoom/issues"
  },
  "homepage": "https://github.com/bumbu/svg-pan-zoom#readme",
  "devDependencies": {
    "grunt": "^1.0.1",
    "grunt-contrib-concat": "^1.0.1",
    "grunt-contrib-uglify": "^2.0.0",
    "grunt-contrib-watch": "^1.0.0",
    "grunt-eslint": "^19.0.0",
    "grunt-karma": "^2.0.0",
    "karma": "^1.3.0",
    "karma-chrome-launcher": "^2.0.0",
    "karma-coverage": "^1.1.1",
    "karma-firefox-launcher": "^1.0.0",
    "karma-qunit": "^1.2.1",
    "qunitjs