目次
- 環境要件
- Vite + Vue3 ビルドの初期化
- ルーティング ルーターのインストールと構成
- tsx サポートを構成する
- 以下のインストールと使用
- スタイルの統一的な導入
- ElementUIのインストールと使用
- vite 設定パスのエイリアス
- i18n 構成多言語
- システムのレイアウトUIを設計する
- デザインメニューバー + 権限制御
- デザインAPIディレクトリ
- モックを設定する
- 機能ページの書き込み
1. 環境要件
- ノード: Node.js バージョン >= 12.0.0、現在使用されているバージョン: v14.16.0
- パッケージ管理ツール: npm/yarn、現在糸を使用: v1.22.10
- エディタ: VSCode
2. Vite + Vue3 ビルドの初期化
- vite をグローバルにインストールする
yarn global add vite
# 安装vite+vue3.0项目,Vite 需要 Node.js 版本 >= 12.0.0。
D:/
# 基于vite搭建项目,项目名:rbac-manage,前端框架使用vue,开发语言:typescript
yarn create vite
# √ Project name: ... rbac-manage
# √ Select a framework: » vue
# √ Select a variant: » vue-ts
# 切换工作目录到rbac-manage,
cd rbac-manage
# 下载项目运行的前端依赖模块
- vite に基づいてプロジェクトをビルドします。プロジェクト名: rbac-manage、フロントエンド フレームワークは vue3 を使用、開発言語: TypeScript
yarn create vite
# √ Project name: ... rbac-manage
# √ Select a framework: » vue
# √ Select a variant: » vue-ts
- スタートアッププロジェクト
# 切换工作目录到rbac-manage
cd rbac-manage
# 下载项目运行的前端依赖模块
yarn
# 启动测试服务器,运行vue项目
yarn dev
これまでのところ、Vite によってビルドされた Vue3 プロジェクトがビルドされ、TypeScript 構文をサポートしています。
3. ルーターのインストールと設定
- vue-router 4.x をインストールする
yarn add vue-router@next
- ルーティングモジュールを構成する
作成src/router/index.ts
、コード:
import {
createRouter, Router, createWebHistory, RouteRecordRaw} from 'vue-router'
// 路由列表
const routes:Array<RouteRecordRaw> = [
// 省略,见项目src/router/index.ts具体代码
]
const router:Router = createRouter({
// history, 指定路由的模式
history: createWebHistory(),
// 路由列表
routes,
});
export default router
プロジェクトのモジュール分割によると、設計プロジェクトのディレクトリとプロジェクトのルーティングは次のとおりです。
- 以下に示すように、ディレクトリを作成し
src/views
、ログイン ディレクトリ、メンバー ディレクトリ、デバイス ディレクトリ、オペレータ ディレクトリ、ポイントグループ ディレクトリ、シナリオ ディレクトリ、wbs ディレクトリを追加し、Index.vue ファイルを各モジュールのエントリ ファイルとして各ディレクトリに追加します。 src/router/index.ts
次のように、プロジェクト ルーティング内のルーターを更新します。
const routes: Array<RouteRecordRaw> = [
{
name: "index",
path: "/",
redirect: "/member",
},
{
name: "Login",
path: "/login",
component: () => import("../views/login/Index.vue"),
},
{
name: "Member",
path: "/member",
component: () => import("../views/member/Index.vue"),
},
{
name: "Device",
path: "/device",
component: () => import("../views/device/Index.vue"),
},
{
name: "Operator",
path: "/operator",
component: () => import("../views/operator/Index.vue"),
},
{
name: "PointGroup",
path: "/point-group",
component: () => import("../views/point-group/Index.vue"),
},
{
name: "Scenario",
path: "/scenario",
component: () => import("../views/scenario/Index.vue"),
},
{
name: "Wbs",
path: "/wbs",
component: () => import("../views/wbs/Index.vue"),
},
];
- router.ts をプロジェクトに導入します
ファイル内でsrc/main.ts
、ルーターオブジェクトをプロジェクトに登録します
import {
createApp } from "vue";
import App from "./App.vue";
import router from "./router";
createApp(App).use(router).mount("#app");
src/App.vue
コンポーネントに、表示ルートに対応するコンテンツを追加します。
<template>
<router-view />
</template>
<script setup lang="ts"></script>
この時点で、プロジェクト ルーティング スイッチの構築は完了です。
4. tsx サポートを構成する
- プラグインをインストールする
yarn add -D @vitejs/plugin-vue-jsx
- 構成
vite.config.ts
import {
defineConfig } from "vite";
import vue from "@vitejs/plugin-vue";
import vueJsx from "@vitejs/plugin-vue-jsx";
// https://vitejs.dev/config/
export default defineConfig({
plugins: [vue(), vueJsx({
})],
});
- tsconfig.jsonを構成する
{
"compilerOptions": {
"jsx": "preserve",
"jsxFactory": "h",
"jsxFragmentFactory": "Fragment"
},
"include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"]
}
- テストvue3 + tsx
コンポーネント ディレクトリに TestDemo.tsx ファイルを作成し、ページ内でそれを参照して、tsx ファイルが正常に解析されるかどうかをテストします。
import {
FunctionalComponent as FC, defineComponent, reactive, onMounted } from 'vue';
// 无状态组件
const FcNode: FC<{
data: number }> = ({
data }) => {
return (
<>
<hr />
<div>子组件:
{
data < 10 ? <span>{
data}</span> : <h1>{
data}</h1>}
</div>
</>
)
};
// 状态组件需要使用 defineComponent
export default defineComponent({
name: 'TsxDemo',
setup() {
const data = reactive({
count: 0 });
onMounted(() => {
data.count = 5;
});
const clickHandler = () => data.count++
return () => (
<>
<span style={
{
marginRight: '10px' }}>{
data.count }</span>
<button onClick={
clickHandler}>+</button>
<FcNode data={
data.count}/>
</>
)
}
})
ここまででtsxの設定は完了です。
5.lessのインストールと使用
- インストール
yarn add less
Vite は、.scss、.sass、.less、.styl、.stylus ファイルのサポートを組み込みで提供します。これらのファイルに特定の vite プラグインをインストールする必要はありません。プリプロセッサの依存関係自体をインストールするだけで、プロジェクト内で直接使用できます。
- Less が機能するかどうかと CSS モジュールをテストする
Vue 開発では、コンポーネント間のスタイル汚染を防ぐために、通常、コンポーネントに対してローカルで有効なスタイルを設定する必要があります。
- .vue 単一ファイルでは次を使用します。
<style scoped lang="less">
.header {
font-size: 36px;
font-weight: bold;
}
</style>
- .tsx ファイルで使用する: スタイル ファイルの接尾辞の前に .module (index.module.less) を追加し、スタイルを tsx にインポートして使用します。
import classes from "./tsx.module.less"
const FcNode: FC<{ data: number }> = ({ data }) => {
return (
<>
<hr />
<div class={classes['son-header']}>子组件:
{data < 10 ? <span>{data}</span> : <h1>{data}</h1>}
</div>
</>
)
};
これまでのところ、less 構文はプロジェクト内で通常どおり使用できます。
6. スタイルの統一導入
src/styles/reset.less
デフォルトのスタイルをクリアしてファイルを作成します。- 統一されたスタイル管理としてファイルを作成する
src/styles/index.less
と、いくつかのグローバル スタイルを同時に記述することができます。
@import "./reset.less";
/* Global css */
#app {
font-family: Avenir, Helvetica, Arial, sans-serif;
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
color: #2c3e50;
width: 100%;
height: 100%;
}
- で
main.ts
紹介されましたsrc/styles/index.less
7. ElementUIのインストールと使用方法
ドキュメント: https://element-plus.org/zh-CN/
- インストール
yarn add element-plus
- 必要に応じて ElementUI をプラグインの形式で導入します
scr/plugins/element-plus.ts
Button コンポーネントの導入を例として、プラグインを作成します。
import {
createApp } from "vue";
// 引入样式
import "element-plus/dist/index.css";
// 按需引入组件
import {
ElButton, ElMessage } from "element-plus";
export default function loadComponent(app: ReturnType<typeof createApp>) {
// 注册组件
app.use(ElButton);
app.config.globalProperties.$message = ElMessage;
}
scr/plugins/index.ts
プラグインの統合導入を容易にするファイルを作成します。
import {
createApp } from 'vue'
import elementPlugin from "./element-plus";
/**
* @description 加载所有 Plugins
* @param {ReturnType<typeofcreateApp>} app 整个应用的实例
*/
export function loadAllPlugins(app: ReturnType<typeof createApp>) {
elementPlugin(app)
}
src/main.ts
ファイル内のすべてのプラグインをロードします。
import {
createApp } from "vue";
import App from "./App.vue";
import {
loadAllPlugins } from "./plugins";
import router from "./router";
// 应用实例
const app = createApp(App)
// 加载所有插件
loadAllPlugins(app)
app.use(router).mount("#app");
- ページで次を使用します。
<template>
<div class="header">
<el-button>my button</el-button>
</div>
</template>
8. vite 設定パスのエイリアス
コードの再利用を容易にするために、カスタム構成パスのエイリアスは @ に設定されます。具体的な構成は次のとおりです。
vite.config.ts
ファイル内で設定します。
export default defineConfig({
resolve: {
alias: {
"@": path.resolve(__dirname, "src"),
},
}
});
- で
tsconfig.json
設定する
"compilerOptions": {
"paths": {
"@/*": ["./src/*"]
}
},
- ページ内で引用する
import TsxDemo from "@/components/TsxDemo"
(追記: 設定が完了したら、次のプロジェクトを再起動してください)
9. i18n 設定の多言語化
- vue-i18n をインストールする
yarn add vue-i18n@next
- 多言語
src/locale/zh-cn.ts
言語ファイル、src/locale/ja.ts
言語ファイルを作成し、src/locale/index
言語ファイルを均一にインポートするためのファイルを作成します。
import Keys from "@/constant/key";
import {
createI18n } from "vue-i18n";
import localeLangJa from "./ja";
import localeLangZhCn from "./zh-cn";
const messages = {
"zh-cn": {
...localeLangZhCn,
},
ja: {
...localeLangJa,
},
};
export const getLocale = () => {
// 先寻找缓存里的lang
const localLanguage = window.localStorage.getItem(Keys.languageKey);
if (localLanguage) {
return localLanguage;
}
// 如果缓存没有设置lang,根据所在地查询配置并显示对应lang
const language = navigator.language.toLowerCase();
const locales = Object.keys(messages);
for (const locale of locales) {
if (language.indexOf(locale) > -1) {
return locale;
}
}
// 没有对应的语言配置,显示默认语言
return "ja";
};
const i18n = createI18n({
// 设置地区
locale: getLocale(),
// 设置地区信息
messages,
});
export default i18n;
- ElementUIコンポーネントライブラリと組み合わせて多言語を構成
グローバル多言語構成を App.vue ファイルに挿入します。
<template>
<el-config-provider :locale="locale">
<router-view />
</el-config-provider>
</template>
<script setup lang="ts">
import { ref } from 'vue';
import { getLocale } from "@/locale"
/** 配置默认语言 */
const locale = ref<string>(getLocale())
</script>
- 使用構文: $t("key")
10. システムのレイアウト UI を設計する
要件に応じて、均一に処理する必要がある要素や一部の操作の再利用を容易にするために、基本的なレイアウト ページ レイアウトが必要です。