passchn/silverstripe-vite

安装: 244

依赖: 0

建议者: 0

安全: 0

星星: 1

观察者: 3

分支: 2

开放问题: 2

类型:silverstripe-vendormodule

v0.2.5 2022-11-08 22:07 UTC

This package is auto-updated.

Last update: 2024-09-20 23:54:11 UTC


README

Silverstripe 版本支持

  • ^0.x 支持 Silverstripe 4.x
  • dev-master 支持 Silverstripe 5.x. 注意:尚未提供稳定版本,请参阅 #3

安装

composer require passchn/silverstripe-vite

在您的 mysite.yml

Page:
  extensions:
    - ViteHelper\Vite\ViteDataExtension

配置

您可以在 mysite.yml 中覆盖默认配置

ViteHelper\Vite\ViteHelper:
  forceProductionMode: false
  devHostNeedle: '.test'
  devPort: 3000
  jsSrcDirectory: 'public_src/'
  mainJS: 'main.js'
  manifestDir: '/public/manifest.json'

ViteHelper 配置设置选项

  • 如果您将 forceProductionMode 设置为 true,则将在运行 vite build 后提供构建文件。
  • devHostNeedle 设置为区分您的实时网站和本地环境,例如 localhost:8080mysite.test127.0.0.1
    • 注意: Vite 开发服务器也必须正在运行。
  • devPort 设置为 Vite 开发服务器的端口号,例如 3000 – 在运行开发服务器时,Vite 端口将在终端中显示。为了设置固定端口号(推荐),请记住在 vite config 下的 server 中设置它。两个配置中的端口号必须始终匹配。
  • 定义 mainJS 入口点,即您的应用程序脚本文件所在位置。
    • 例如,如果您使用 TypeScript,请将 mainJs 属性更改为 "main.ts"
  • 定义 manifestDir 以确定清单文件的位置。

用法

在您的主模板中插入 JS / CSS 标签,例如,Page.ss

<head>
    ...
    $Vite.HeaderTags.RAW
</head>
<body>
    ...
    $Vite.BodyTags.RAW
</body>

Vite 配置

配置必须与 vite.config.js 匹配。您需要在修改 yml 配置后执行 ?flush

有关更多信息,请参阅 ViteHelper.php

您的 vite.config.js 或 vite.config.ts 中的配置必须与此插件的 ViteHelper 配置匹配。

请参阅此 example vite.config.ts 以获取默认配置。

注意:当使用 Vite 版本低于 2.9.0 时,服务器配置将不同。请参阅此配置