Stimulus Starter 项目教程

1. 项目的目录结构及介绍

stimulus-starter/
├── public/
│   └── index.html
├── src/
│   └── controllers/
│       └── application_controller.js
├── .babelrc
├── .gitignore
├── LICENSE.md
├── README.md
├── package.json
├── server.js
├── webpack.config.js
└── yarn.lock

目录结构介绍

• public/: 存放项目的静态文件，如 index.html。
• src/: 存放项目的源代码，包括 Stimulus 控制器文件。
• .babelrc: Babel 配置文件，用于转换 JavaScript 代码。
• .gitignore: Git 忽略文件配置。
• LICENSE.md: 项目许可证文件。
• README.md: 项目说明文件。
• package.json: 项目依赖和脚本配置文件。
• server.js: 本地开发服务器文件。
• webpack.config.js: Webpack 配置文件，用于打包项目。
• yarn.lock: Yarn 包管理器的锁定文件，确保依赖版本一致。

2. 项目的启动文件介绍

server.js

server.js 是项目的本地开发服务器文件，用于在开发环境中启动项目。它使用 Node.js 和 Express 框架来提供静态文件服务。

const express = require('express');
const path = require('path');
const app = express();
const port = process.env.PORT || 9000;

app.use(express.static(path.join(__dirname, 'public')));

app.listen(port, () => {
  console.log(`Stimulus Starter is running at http://localhost:${port}`);
});

启动步骤

1. 确保已经安装了 Node.js 和 Yarn。
2. 在项目根目录下运行 yarn install 安装依赖。
3. 运行 yarn start 启动开发服务器。
4. 打开浏览器访问 http://localhost:9000/。

3. 项目的配置文件介绍

package.json

package.json 是项目的依赖和脚本配置文件，包含了项目的元数据、依赖包和脚本命令。

{
  "name": "stimulus-starter",
  "version": "1.0.0",
  "main": "index.js",
  "license": "MIT",
  "scripts": {
    "start": "node server.js"
  },
  "dependencies": {
    "express": "^4.17.1",
    "stimulus": "^2.0.0"
  }
}

webpack.config.js

webpack.config.js 是 Webpack 的配置文件，用于打包项目的 JavaScript 和 CSS 文件。

const path = require('path');

module.exports = {
  entry: './src/index.js',
  output: {
    filename: 'bundle.js',
    path: path.resolve(__dirname, 'public')
  },
  module: {
    rules: [
      {
        test: /\.js$/,
        exclude: /node_modules/,
        use: {
          loader: 'babel-loader'
        }
      }
    ]
  }
};

.babelrc

.babelrc 是 Babel 的配置文件，用于转换 JavaScript 代码，支持最新的 ECMAScript 特性。

{
  "presets": ["@babel/preset-env"]
}

通过以上配置，项目可以顺利启动并运行，开发者可以在此基础上进行 Stimulus 控制器的开发和调试。