最近在做一些SAAS产品,Landing page——落地页对于SAAS类产品的重要性不言而喻。之前有想过用wordpress找一些比较漂亮的模板,但想想觉得这个方案对于初期的产品来说还是有点重了。用Vue的话,找了一圈没有发现合适的模板。React体系内,我发现Ant Design生态里有一款Ant Design Landing 框架,简洁明了,又不失美观,比较符合我的需求。
我们来初步看看怎么使用 Ant Design Landing。
我们直接在create-react-app里使用 Ant Design Landing 的模板,create-react-app 是业界最优秀的 React 应用开发工具之一,也可以直接下载官方给出的Demo:anding-create-react-app-example。
安装与初始化
create-react-app的安装和初始化:
npm init react-app my-app
安装完成后,目录结构:
├── README.md ├── node_modules ├── package.json ├── .gitignore ├── public │ ├── favicon.ico │ ├── index.html │ └── manifest.json │── src │ ├── App.css │ ├── App.js │ ├── App.test.js │ ├── index.css │ ├── index.js │ ├── logo.svg │ └── serviceWorker.js
文件路径
我们直接将从 Landing
上下载的 Home
文件夹直接拷贝到 src
文件包里;
├── README.md ├── ... ├── public │ ├── ... │── src + ├── Home + │ ├── less + │ ├── index.js + │ ├── ... │ ├── App.css │ ├── App.js │ ├── App.test.js │ ├── index.css │ ├── index.js │ ├── logo.svg │ └── serviceWorker.js
安装依赖
基础必要组件依赖:
npm install antd enquire-js rc-queue-anim rc-scroll-anim rc-tween-one --save; npm install rc-banner-anim --save;// 如果用的是多屏滑动型的 banner,加上这条; npm install @ant-design/compatible --save;// 如果使用了 Content7 模块,请加上这条;
按需加载ant design
npm install babel-plugin-import --save-dev;
less加载:
npm install react-app-rewired customize-cra less less-loader
配置加载less
安装完 less 加载
后, 我们还需要修改 package.json 里的启动配置。
/* package.json */ "scripts": { - "start": "react-scripts start", + "start": "react-app-rewired start", - "build": "react-scripts build", + "build": "react-app-rewired build", - "test": "react-scripts test", + "test": "react-app-rewired test", }
创建config-overrides.js
然后在项目根目录创建一个 config-overrides.js
用于修改默认配置。
├── README.md ├── node_modules ├── package.json ├── .gitignore +── config-overrides.js ├── public │ ├── ... │── src │ ├── Home │ └── ...
config-overrides.js
const { override, fixBabelImports, addLessLoader } = require('customize-cra'); module.exports = override( // 按需加载 antd fixBabelImports('import', { libraryName: 'antd', libraryDirectory: 'es', style: true, }), // 添加加载 less 的 javascriptEnabled 和 antd 的主题配置。 addLessLoader({ lessOptions: { javascriptEnabled: true, modifyVars: { '@primary-color': '#1DA57A' }, } }), );
修改入口文件
更改的 src
里的 index.js
页面,打开 index.js
,引入 Home
文件包并渲染。
src/index.js
import React from 'react'; import ReactDOM from 'react-dom'; import './index.css'; - import App from './App'; + import App from './Home'; import * as serviceWorker from './serviceWorker'; ReactDOM.render(<App />, document.getElementById('root')); // If you want your app to work offline and load faster, you can change // unregister() to register() below. Note this comes with some pitfalls. // Learn more about service workers: http://bit.ly/CRA-PWA serviceWorker.unregister();
启动
完成以上步骤后执行 npm install, 再 npm start即可查看下载的模板。
npm install npm start
遇到的问题
其中遇到了一个 Module not found: Can't resolve './serviceWorker' in ../MyApp\src 的错误
仔细查看后是 serviceWorker.js 没有下载下来,直接将serviceWorker.js复制到src目录下即可
// This optional code is used to register a service worker. // register() is not called by default. // This lets the app load faster on subsequent visits in production, and gives // it offline capabilities. However, it also means that developers (and users) // will only see deployed updates on subsequent visits to a page, after all the // existing tabs open on the page have been closed, since previously cached // resources are updated in the background. // To learn more about the benefits of this model and instructions on how to // opt-in, read http://bit.ly/CRA-PWA const isLocalhost = Boolean( window.location.hostname === 'localhost' || // [::1] is the IPv6 localhost address. window.location.hostname === '[::1]' || // 127.0.0.1/8 is considered localhost for IPv4. window.location.hostname.match( /^127(?:\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}$/ ) ); export function register(config) { if (process.env.NODE_ENV === 'production' && 'serviceWorker' in navigator) { // The URL constructor is available in all browsers that support SW. const publicUrl = new URL(process.env.PUBLIC_URL, window.location.href); if (publicUrl.origin !== window.location.origin) { // Our service worker won't work if PUBLIC_URL is on a different origin // from what our page is served on. This might happen if a CDN is used to // serve assets; see https://github.com/facebook/create-react-app/issues/2374 return; } window.addEventListener('load', () => { const swUrl = `${process.env.PUBLIC_URL}/service-worker.js`; if (isLocalhost) { // This is running on localhost. Let's check if a service worker still exists or not. checkValidServiceWorker(swUrl, config); // Add some additional logging to localhost, pointing developers to the // service worker/PWA documentation. navigator.serviceWorker.ready.then(() => { console.log( 'This web app is being served cache-first by a service ' + 'worker. To learn more, visit http://bit.ly/CRA-PWA' ); }); } else { // Is not localhost. Just register service worker registerValidSW(swUrl, config); } }); } } function registerValidSW(swUrl, config) { navigator.serviceWorker .register(swUrl) .then(registration => { registration.onupdatefound = () => { const installingWorker = registration.installing; if (installingWorker == null) { return; } installingWorker.onstatechange = () => { if (installingWorker.state === 'installed') { if (navigator.serviceWorker.controller) { // At this point, the updated precached content has been fetched, // but the previous service worker will still serve the older // content until all client tabs are closed. console.log( 'New content is available and will be used when all ' + 'tabs for this page are closed. See http://bit.ly/CRA-PWA.' ); // Execute callback if (config && config.onUpdate) { config.onUpdate(registration); } } else { // At this point, everything has been precached. // It's the perfect time to display a // "Content is cached for offline use." message. console.log('Content is cached for offline use.'); // Execute callback if (config && config.onSuccess) { config.onSuccess(registration); } } } }; }; }) .catch(error => { console.error('Error during service worker registration:', error); }); } function checkValidServiceWorker(swUrl, config) { // Check if the service worker can be found. If it can't reload the page. fetch(swUrl) .then(response => { // Ensure service worker exists, and that we really are getting a JS file. const contentType = response.headers.get('content-type'); if ( response.status === 404 || (contentType != null && contentType.indexOf('javascript') === -1) ) { // No service worker found. Probably a different app. Reload the page. navigator.serviceWorker.ready.then(registration => { registration.unregister().then(() => { window.location.reload(); }); }); } else { // Service worker found. Proceed as normal. registerValidSW(swUrl, config); } }) .catch(() => { console.log( 'No internet connection found. App is running in offline mode.' ); }); } export function unregister() { if ('serviceWorker' in navigator) { navigator.serviceWorker.ready.then(registration => { registration.unregister(); }); } }