Skip to content

Latest commit

 

History

History
481 lines (422 loc) · 22.6 KB

README.ja-JP.md

File metadata and controls

481 lines (422 loc) · 22.6 KB
Raw

Prettier Less Taiwind

すぐに使えるVue3 + Vite2 + TypeScriptなど。 大規模なアプリケーションを迅速に構築するためのテンプレートフレームワーク。 さまざまなプラグインが統合され、モジュール化とリードオンデマンド用に最適化されているため、自信を持って使用できます。 [ドキュメントを更新するには、ここをクリックしてください](https://github.com/tobe-fe-dalao/fast-vue3/blob/main/docs/update.md)

English | 简体中文 | 日本語

特徴

ここでは、いくつかのコアパーツの簡単な紹介を示しますが、インストールパーツについては詳しく説明しません。 公式ドキュメントまたは[ビジュアルウェアハウス]（https://github1s.com/tobe-fe-dalao/fast-vue3）を直接読むことをお勧めします。

🪂技術巨人のコラボレーション-コード仕様

🪁 現在、多くのハイテク巨人チームは、一般的に husky と lint-stagedを使用してコード仕様を制約しています。

  • pre-commitを介して、lintチェック、単体テスト、コードフォーマットなどを実装します。
  • VsCodeと組み合わせる（保存時に自動的にフォーマットする：editor.formatOnSave：true）
  • Gitフックと組み合わせる（コミット前に実行：pre-commit => npm run lint：lint-staged）
  • IDE構成（ .editorconfig）、ESLint構成（ .eslintrc.js和 .eslintignore）、StyleLint構成（ .stylelintrc和 .stylelintignore）、詳細については、対応する構成ファイルを参照してください.

🔌 コード仕様を閉じる .eslintignore と .stylelintignoreをそれぞれ src /ディレクトリに追加して無視します.

ディレクトリ構造

システムのディレクトリ構造は次のとおりです

├── config
│   ├── vite             // vite 構成
│   ├── constant         // システム定数
|   └── themeConfig      // theme 構成
├── docs                 // ドキュメント関連
├── mock                 // モックデータ    
├── plop-tpls            // plopテンプレート
├── src     
│    ├── api             // APIリクエスト   
│    ├── assets          // 静的ファイル  
│    ├── components      // コンポーネント 
│    ├── page            // ページ
│    ├── router          // ルーティングファイル   
│    ├── store           // 状態管理   
│    ├── utils           // ツール   
│    ├── App.vue         // vue テンプレート エントリ 
│    ├── main.ts         // vue テンプレート js
├── .d.ts                // タイプ定義
├── tailwind.config.js   // tailwind グローバル構成 
├── tsconfig.json        // ts 構成
└── vite.config.ts       // vite グローバル構成

💕JSX構文をサポートする

{
    ...
    "@vitejs/plugin-vue-jsx": "^1.3.3"
    ...
}

🎸 UIコンポーネントはオンデマンドで読み込まれ、自動的にインポートされます

// モジュラーライティング
import Components from 'unplugin-vue-components/vite'
export const AutoRegistryComponents = () => {
    return Components({
        extensions: ['vue', 'md'],
        deep: true,
        dts: 'src/components.d.ts',
        directoryAsNamespace: false,
        globalNamespaces: [],
        directives: true,
        include: [/\.vue$/, /\.vue\?vue/, /\.md$/],
        exclude: [/[\\/]node_modules[\\/]/, /[\\/]\.git[\\/]/, /[\\/]\.nuxt[\\/]/],
        resolvers: [
            IconsResolver({
                componentPrefix: '',
            }),
            ArcoResolver({ importStyle: 'less' }),// 必要に応じてUIフレームワークを追加します
            VueUseComponentsResolver(),// VueUseコンポーネントがデフォルトで使用されます
        ],
    })
}

🧩Viteプラグインのモジュール性

プラグインの管理を容易にするために、すべての configを config / vite / pluginsに入れてください。 将来的には、非常にクリーンに管理するために、フォルダーに直接分割されたプラグインが増える予定です。 Fast-Vue3は、特定のプラグインの動的なオープンを区別するために、統合された環境変数管理を追加することは言及する価値があります。

// vite/plugins/index.ts
/**
 * @name createVitePlugins
 * @description Encapsulate the plugins array to call uniformly
 */
import type { Plugin } from 'vite';
import vue from '@vitejs/plugin-vue';
import vueJsx from '@vitejs/plugin-vue-jsx';
import { ConfigSvgIconsPlugin } from './svgIcons';
import { AutoRegistryComponents } from './component';
import { AutoImportDeps } from './autoImport';
import { ConfigMockPlugin } from './mock';
import { ConfigVisualizerConfig } from './visualizer';
import { ConfigCompressPlugin } from './compress';
import { ConfigPagesPlugin } from './pages'
import { ConfigMarkDownPlugin } from './markdown'
import { ConfigRestartPlugin } from './restart'

export function createVitePlugins(isBuild: boolean) {
    const vitePlugins: (Plugin | Plugin[])[] = [
        // vueサポート
        vue(),
        // JSXサポート
        vueJsx(),
        // コンポーネントをオンデマンドで自動的にインポート
        AutoRegistryComponents(),
        // 必要に応じて依存関係を自動的にインポートします
        AutoImportDeps(),
        // ルートを自動的に生成する
        ConfigPagesPlugin(),
        // .gz圧縮を有効にする  rollup-plugin-gzip
        ConfigCompressPlugin(),
        // markdownサポート
        ConfigMarkDownPlugin(),
        // 構成ファイルの変更を監視して再起動します
        ConfigRestartPlugin(),
    ];
    // vite-plugin-svg-icons
    vitePlugins.push(ConfigSvgIconsPlugin(isBuild));
    // vite-plugin-mock
    vitePlugins.push(ConfigMockPlugin(isBuild));
    // rollup-plugin-visualizer
    vitePlugins.push(ConfigVisualizerConfig());
    return vitePlugins;
}

vite.config.ts is much cleaner

import { createVitePlugins } from './config/vite/plugins'
...
return {
    resolve: {
      alias: {
        "@": path.resolve(__dirname, './src'),
        '@config': path.resolve(__dirname, './config'),
        "@components": path.resolve(__dirname, './src/components'),
        '@utils': path.resolve(__dirname, './src/utils'),
        '@api': path.resolve(__dirname, './src/api'),
      }
    },
    // plugins
    plugins: createVitePlugins(isBuild)
}
...

📱 Support for Pinia, the next generation of Vuex5

ファイルを作成する src/store/index.ts

// モジュール化をサポートし、plopを使用してコマンドラインからワンクリックで生成できます
import { createPinia } from 'pinia';
import { useAppStore } from './modules/app';
import { useUserStore } from './modules/user';
const pinia = createPinia();
export { useAppStore, useUserStore };
export default pinia;

ファイルを作成する src/store/modules/user/index.ts

import { defineStore } from 'pinia'
import piniaStore from '@/store'
export const useUserStore = defineStore(
    // unique id
    'user',
    {
        state: () => ({}),
        getters: {},
        actions: {}
    }
)

🤖 ファイルを自動的に生成するための Plopをサポート

⚙️ コードファイルは自動的に生成され、3つのプリセットテンプレート pages、 components、 storeを提供します。また、必要に応じて、より多くの自動生成スクリプトを設計することもできます。 通常、バックエンドエンジニアはこのフォームを使用します。これは非常に効率的です。。

# install plop
pnpm add plop

ルートディレクトリ plopfile.tsに作成します

import { NodePlopAPI } from 'plop';
export default function (plop: NodePlopAPI) {
    plop.setWelcomeMessage('Please select the pattern you want to create')
    plop.setGenerator('page', require('./plop-tpls/page/prompt'))
    plop.setGenerator('component', require('./plop-tpls/component/prompt'))
    plop.setGenerator('store', require('./plop-tpls/store/prompt'))
}
# start command
pnpm run plop

image.png

🖼️ SVGアイコンのサポート

ブラウザの互換性の向上に伴い、SVGのパフォーマンスは徐々に顕著になりました。 多くの技術大手チームが独自のSVG管理ライブラリを作成しており、ツールライブラリは後で推奨されます。

#  svg依存関係をインストールします
pnpm add vite-plugin-svg-icons

設定 vite.config.ts

import viteSvgIcons from 'vite-plugin-svg-icons';
export default defineConfig({
plugins:[
...
 viteSvgIcons({
    // キャッシュする必要のあるアイコンフォルダを指定します
    iconDirs: [path.resolve(process.cwd(), 'src/assets/icons')],
    // symbolId形式を指定します
    symbolId: 'icon-[dir]-[name]',
  }),
]
...
})

単純な SvgIconコンポーネントがカプセル化されており、ファイルの下の svgを直接読み取ることができ、フォルダーディレクトリに従ってファイルを自動的に見つけることができます。

<template>
  <svg aria-hidden="true" class="svg-icon-spin" :class="calsses">
    <use :xlink:href="symbolId" :fill="color" />
  </svg>
</template>

<script lang="ts" setup>
const props = defineProps({
  prefix: {
    type: String,
    default: 'icon',
  },
  name: {
    type: String,
    required: true,
  },
  color: {
    type: String,
    default: '#333',
  },
  size: {
    type: String,
    default: 'default',
  },
})
const symbolId = computed(() => `#${props.prefix}-${props.name}`)
const calsses = computed(() => {
  return {
    [`sdms-size-${props.size}`]: props.size,
  }
})
const fontSize = reactive({ default: '32px', small: '20px', large: '48px' })
</script>

📦 サポート axios (ts version)

主流のインターセプター、リクエスト呼び出し、その他のメソッドをカプセル化し、モジュール index.ts / status.ts / type.tsを区別しています。

// カプセル化 src/api/user/index.ts
import request from '@utils/http/axios'
import { IResponse } from '@utils/http/axios/type'
import { ReqAuth, ReqParams, ResResult } from './type';
enum URL {
    login = '/v1/user/login',
    userProfile = 'mock/api/userProfile'
}
const getUserProfile = async () => request<ReqAuth>({ url: URL.userProfile });
const login = async (data: ReqParams) => request({ url: URL.login, data });
export default { getUserProfile, login };
// 移行
import userApi from "@api/user"
// コンポーネントは、セットアップモードで直接参照できます
const res = await userApi.profile()

👽 Automatically generate router, filter components components

vue-router4.0のモジュール化をサポートし、pagesフォルダーを取得してルートを自動的に生成し、動的ルートをサポートします

import { createRouter, createWebHashHistory, RouteRecordRaw } from 'vue-router'
import routes from 'virtual:generated-pages'

console.log(routes,'print generate auto-generated routes')
// 生成されたルーティングデータをインポートする
const router = createRouter({
  history: createWebHashHistory(),
  routes,
})

export default router

🧬 サポート Mock data

vite-plugin-mockプラグインを使用して、自動識別と開始-停止環境構成をサポートします

// vite config
viteMockServe({
    ignore: /^\_/,
    mockPath: 'mock',
    localEnabled: !isBuild,
    prodEnabled: false,
    // https://github.com/anncwb/vite-plugin-mock/issues/9
    injectCode: `
       import { setupProdMockServer } from '../mock/_createProdMockServer';
       setupProdMockServer();
       `
    })

ルートディレクトリに _createProductionServer.tsファイルを作成します。_で始まらないファイルは自動的にモックファイルにロードされます

import { createProdMockServer } from 'vite-plugin-mock/es/createProdMockServer';
// Bulk load
const modules = import.meta.globEager('./mock/*.ts');

const mockModules: Array<string> = [];
Object.keys(modules).forEach((key) => {
    if (key.includes('/_')) {
        return;
    }
    mockModules.push(...modules[key].default);
});
export function setupProdMockServer() {
    createProdMockServer(mockModules);
}

🎎 プロキシー

// vite 構成
import proxy from '@config/vite/proxy';
export default defineConfig({
    ...
    server: {
        hmr: { overlay: false }, // HMR接続を無効または構成し、server.hmr.overlayをfalseに設定して、サーバーエラーマスキングレイヤーを「無効」にします
        // サービス構成
        port: VITE_PORT, // type:number サーバーポートを指定します；
        open: false, // type:boolean | string サーバーの起動時にブラウザでアプリケーションを自動的に開きます；
        cors: false, // type:boolean | CorsOptionsは、開発サーバーのCORSを構成します.デフォルトで有効になっており、任意のオリジンを許可します
        host: '0.0.0.0', // IP構成、IPからの起動をサポート
        proxy,
    }
    ...
})
// proxy.ts
import {
    API_BASE_URL,
    API_TARGET_URL,
    MOCK_API_BASE_URL,
    MOCK_API_TARGET_URL,
} from '@config/constant';
import { ProxyOptions } from 'vite';
type ProxyTargetList = Record<string, ProxyOptions>;

const init: ProxyTargetList = {
    // test
    [API_BASE_URL]: {
        target: API_TARGET_URL,
        changeOrigin: true,
        rewrite: (path) => path.replace(new RegExp(`^${API_BASE_URL}`), ''),
    },
    // mock
    [MOCK_API_BASE_URL]: {
        target: MOCK_API_TARGET_URL,
        changeOrigin: true,
        rewrite: (path) => path.replace(new RegExp(`^${MOCK_API_BASE_URL}`), '/api'),
    },
};

export default init;

🎉 そのた

  • 🏗 vw / vhモバイル端末レイアウトの互換性をサポートします。plopを使用して、生成されたファイルを自分で構成することもできます
  • commitingにはさらに多くの新機能が追加されています。より良い解決策がある場合は、 PRを歓迎します。

使用する

スターとフォロー：スターまたはフォークまたはビジュアルウェアハウス

# リポジトリコードをプルする
git clone  https://github.com/tobe-fe-dalao/fast-vue3.git

# プロジェクトフォルダに入る
cd fast-vue3 

# プロジェクトの依存関係をインストールする
pnpm install

# ラン
pnpm run dev

エラーが報告されない場合は、点火に成功しました。それ以外の場合は、以下のFAQを参照してください.

このテンプレートをすでに知っている場合は、プロジェクト開発のために テンプレートブランチをプルすることをお勧めします。このブランチには、サンプルコードは含まれていません。

# テンプレートブランチのクローン
git clone -b template https://github.com/tobe-fe-dalao/fast-vue3.git

ツール ライブラリ

適切なツールライブラリを使用して、 コーディングがより少ないリソースでより多くのことを実行できるようにする方法を学びます。 特にオープンソースツールライブラリは、到達すべきレベルであるため、誰もが学ぶ価値があります。 新しいものが好きなので、主要なメーカーで一般的に使用されているクラスライブラリをいくつか示します...次のツールを直接インポートできます。

JS ライブラリ

  • pnpm，パッケージのグローバル管理に依存するツールである上司は、私のCドライブが十分でないことを心配する必要がなくなりました。 Vite公式推奨、ByteDance公式フロントエンドチーム大規模プロジェクトテスト

image-20220110125758056

  • mitt Global event listener library，Vue3の公式推奨

  • Hammer，タッチ、マウス、ポインターのイベントによって行われたジェスチャを認識できます。わずか7.34kb

  • outils，開発で一般的に使用される関数のセットで、 lodashを使用することもできます

  • tailwindcss，ああ、私のイエス様、CSSの行を書かなくても、ページは3分で作成されます。 ジュニアおよび中間のフロントエンドには適していません。 最初に基本を学び、次にフレームワークを使用することをお勧めします。

    tailwindcss-1

    tailwindcss-2

  • Vue I18n，Vue.jsの国際化プラグイン。 オープンソースフレームワークを作成したい場合は、国際化に適したプラグインです。

  • ViteSSG，SEO最適化、このプロジェクトは興味深いです。このソリューションで遊ぶことができます。以前はサーバー側のレンダリングでSEOを実行していましたが、後でVue3サーバーで直接生成できることを学びました。

  • Vitest,Viteに基づく単体テストツールである反復は、現在比較的高速であり、EvanYouが後援しています。 引き続き注意を払うことができますが、小さなプロジェクトで使用することはお勧めしません。

    image-20220110125605172

UI ライブラリ

  • arco-design，Byte Danceチームの新しいUIフレームワークには、より柔軟な構成レベルがあります。 fast-vue3はそれを使用します。 気に入らない場合は削除できます。
  • semi-design，Douyinのフロントエンドのフレームワークは、UIとFEを絶えず引き裂くことを目的としており、試してみることができます。
  • nutui，JDのフロントエンドチームによって開発されたUIフレームワークが3.Xにアップグレードされました。 個人的には見た目が一番高く、反論も受けられると思います。
  • naive-ui，Evan Youが推奨する、TypeScript構文、調整可能なテーマ、この会社は非常に強力です。
  • 今のところこれですべてです。後で補います。

参考

最後

  • グループへようこそ 前端水友群，さぼる、一緒にさぼるしましょう。今ではファングループがテクノロジーについて話し合うことはめったにないので、一緒にさぼるしましょう。 Wechat公開番号に注目することを歓迎します 扫地盲僧。

  • 最先端のテクノロジー、さまざまな経験や相互作用に関連するテクノロジー、さまざまな翻訳や調査レポートの高度な視点。

  • 無料で使用でき、すべての有料リソースがリリースされることが約束されており、すべてのファングループが無料で使用できます。それ以外の場合は、あなたと遊ぶ時間があります。本当に面白い。