第1部:反応と風車の設置と設置


このブログシリーズでは、我々はマイクロフロントエンドを作成します.我々は、シリーズを2つの部分に分けます.これは、最初の部分である、我々はここで我々の反応プロジェクトをセットアップし、一歩ずつTailwindステップをインストールします.このブログの2番目の部分では、統計のマイクロフロントエンドを構築するコードを書きます.そして、後に、我々は束になって、出版して、配備して、Entamandoコンポーネントリポジトリ(ECR)からそれをそれを使用します.ちょうど私たちはすべてのマイクロフロントエンドが何であるかを知らない場合は、ここで少し説明です.
UIまたはウェブサイトを想像してください、そして、あなたは何を見ますか?大きなフロントエンド、右?さて、この特定のフロントエンドアプリケーションをマイクロフロントエンドと呼ばれるフロントエンドのいくつかの小さな部分に分割することができます.我々は、展開し、それぞれの独立して管理することができます.我々は、単一のページにこれらのマイクロフロントエンドを構築するために、様々なライブラリや反応や角度などのフレームワークを使用することができます.今、質問は、どのように我々はこれを行うのですか?
我々が始める前に、私はあなたが束が何であるかについて熟知していると仮定しています.場合は、これにかなり新しい場合は、これをチェックアウトすることができます!
まず始めにtemplate . これは、我々が我々のコードを束ねて、配備するために必要とするすべてのファイルを持っている単純な反応テンプレートです.あなたがしなければならないあなたのローカルマシン上でそれをクローンし、お気に入りのコードエディタでそれを開く!
次の部分については、我々は内部に移動する必要がありますcd ui/widgets/widgets-dir そして、我々の反応アプリを作成します.名前を挙げましょうstats-widget .
我々は我々の反応アプリを作成するには、このコマンドを実行します.
npx create-react-app stats-widget
一旦それがつくられるならば、我々はそれの中に行きますcd stats-widget, ランnpm start アプリケーションが正常に作成されたかどうかを確認します.
さて、私たちがTailwindをインストールする前に、我々のプロジェクトがentando束の準備ができていることを確認する必要があります.そのためにbundle フォルダ内のstats-widget フォルダと2つのファイルを作成します.最初のものはstats-descriptor.yaml 二番目はstats.ftl . このディスクリプタファイルは、ウィジェットについてのコンテクストを含んでおり、またFTLファイルを指し示すためにも使われる.そして、FTLファイルは、最終的なHTMLコードをレンダリングするのに用いられるFreemarkerテンプレートです.ディスクリプタがビューのバンドルポイントから定義を定義する間、それは「表示された」部分を定義します.
行くには、あなたの内側にこのコードを貼り付けてstats-descriptor.yaml ファイル.
code: stats-widget
titles:
 en: Sample Stats Template
 it: Sample Stats Template
group: free
customUiPath: stats.ftl
そして、このコードをstats.ftl ファイル.
<#assign wp=JspTaglibs["/aps-core"]>
<#-- entando_resource_injection_point -->
<#-- Don't add anything above this line. The build scripts will automatically link the compiled JS and CSS for you and add them above this line so that the widget can be loaded-->

<@wp.info key="currentLang" var="currentLangVar" />
<stats-widget locale="${currentLangVar}"/>
クール.我々は現在、バンドルフォルダを設定して行われます.しかし、まだプロジェクトのルートディレクトリ内にあるバンドルlesrcフォルダを更新する必要があります.したがって、ルートディレクトリに戻って、私たちのBandleRunSrcフォルダの中に行きます.ディスクリプタをオープンする.YAMLファイルと私たちの反応アプリとウィジェット記述子の名前を置き換えることによってコードを更新します.次のようになります.
code: tailwind-demo
description: Template for Tailwind Components
components:
 widgets:
   - ui/widgets/widgets-dir/stats-widget/stats-descriptor.yaml
完璧な、今我々は100 %すべてのバンドルのフォルダを設定すると行われます.この時点で、プロジェクトの構造は次のようになります.

今我々は絶対に我々の反応アプリにTailwindをインストールすることから始めることができます.だから、我々の反応アプリのディレクトリに移動しましょうcd ui/widgets/widgets-dir/stats-widget . 今、私は質問があります:あなたはなぜ我々がTarwindを使用する理由を疑問に思ったことがありますか?
Truwindは、HTMLタグで使用するのが簡単な多くのクラスで詰め込まれたユーティリティの最初のCSSフレームワークです.これらのユーティリティクラスは、初心者でも特定のCSSクラスがどのように定義されているかを理解できるように、関数ごとに命名されます.Toowind CSSについての最良の部分は非常にカスタマイズ可能です!さらに、私たちは、彼らが容易にするので、CSSの塊を書く時間を費やす必要はありません.訪問するTailwind CSS website もっと学ぶ.
インストールから始めましょう.
まず、我々はstats-widget フォルダ.cd ui/widgets/widgets-dir/stats-widget ルートディレクトリから.それから次のコマンドを使って端末からTarwindをインストールします.
  • CSS、ポストCSSとAutoPrefixerをインストールします.
  • npm install -D tailwindcss@npm:@tailwindcss/postcss7-compat @tailwindcss/postcss7-compat postcss@^7 autoprefixer@^9
    
  • cracoをインストールします.ResponseはデフォルトでポストCSS設定をオーバーライドすることを許しませんが、CRACOを使用してTailwindを設定できます.
  • npm install @craco/craco
    
  • CRACOの設定ファイルを作成します.
  • touch craco.config.js
    
  • 以下の設定を追加します.
  • module.exports = {
      style: {
        postcssOptions: {
          plugins: [
            require('tailwindcss'),
            require('autoprefixer'),
          ],
        },
      },
    }
    
  • 我々のアプリをcracoを使用するには、我々の設定をpackage.json ファイルを置換するscripts 次のようにします.
  • "scripts": {
        "start": "craco start",
        "build": "craco build",
        "test": "craco test",
        "eject": "react-scripts eject"
    }
    
  • 設定ファイルを作成する--full すべてのデフォルト設定を生成するタグ.
  • npx tailwindcss init --full
    
    使用--full tagはオプションです.それはあなたが対処しないかもしれない巨大な構成が含まれます.
    既存に戻すことを忘れないでくださいpurge[] エンティティのmodule.exports ) これで
    purge: ["./src/**/*.{js,jsx,ts,tsx}", "./public/index.html"],
    
  • に移動src フォルダと既存のコンテンツの置換index.css 以下のファイルを指定します.
  • @tailwind base;
    
    @tailwind components;
    
    @tailwind utilities;
    
    このindex.css ファイルは、すべてのtailwind基本スタイルから成ります.
  • 終了するsrc フォルダとオープンpackage.json 私たちのアプリケーションを実行するたびに私たちのスタイルを構築するクラコを使用するアプリケーションを構成するファイルをnpm start or npm build . これを行うには、次の構文をscripts セクションpackage.json ファイル
  • "build:style": "tailwind build src/styles/index.css -o src/styles/tailwind.css",
    
  • CSSベーススタイルindex.js ファイル
  • import './index.css';
    
  • 削除するapp.css ファイルと変更app.js ファイル:
  • function App() {
     return <div>Hi there!</div>;
    }
    
    export default App;
    
  • 我々は、テール風の設置と設定を完了しました.我々は、“こんにちはそこ”と言うページを生成することによって我々の反応アプリをテストすることができます.それが走るならば、そして、完全な.全員集合!
  • 注意!
    PostCSSバージョン管理やAutoPrefixerバージョン管理に関するエラーが発生した場合、以下のコマンドを使用できます.
    npm uninstall tailwindcss
    npm install -D tailwindcss@latest postcss@latest autoprefixer@latest
    
    これで、すぐにTailwindをインストールしました!
    さて、それはこのブログのためのすべてです.次のブログでは次のようにします.
  • 統計コンポーネントを作成するコードを記述します.
  • ビルド反応アプリ.
  • カスタムUI要素の内側にマイクロフロントエンドをラップします.(もし興味があれば、これをチェックアウトすることができますdocumentation ブログが生きているまで
  • ENT CLIのプロジェクトディレクトリを準備してバンドルします.
  • 構築、プッシュ、Entandoコンポーネントリポジトリ(ECR)にバンドルを展開します.
  • ページの統計ウィジェットをドラッグアンドドロップします.
  • 私はそれが本当にエキサイティングなことを望む!一方、あなたがここにいるので、私は言及したいと思います、Entamdoで我々は、共有可能でモジュラー・アプリケーションの意識を広げるコミュニティを構築しています.我々が我々のコミュニティでしようとしている多くは、より多くあります.あなたが我々のコミュニティに魅力的であるか貢献するように感じるならば、我々に加わってくださいDiscord Server , そして一緒に学びましょう!次のブログでお会いしましょう.ありがとう.