Offline Screen in Vue, Angular, React with Capacitor

Learn how to implement an offline screen in Vue, Angular, or React applications using the Network API and Capacitor. Improve the user experience by handling offline scenarios effectively.

__CAPGO_KEEP_0__

마틴 도나디유

작가

발레리아

리뷰어

조던

편집자

Vue 3, Angular 14, 또는 React에서 오프라인 화면을 만들기

이 튜토리얼에서 Vue 3, Angular 14, 및 React 애플리케이션에서 오프라인 화면을 만들기 위해 네트워크 API를 사용하는 방법을 배웁니다. 네트워크 API는 네트워크 및 연결 정보를 제공하여 오프라인 시나리오를 처리하고 사용자 경험을 향상할 수 있습니다. 더 깊은 연결 가능성 확인을 위해 온라인/오프라인 플래그 외에 @capgo/capacitor-네트워크-디아그램 네이티브 code에서 URL 연결 가능성, TCP 포트, 및 WebSocket handshake를 테스트할 수 있습니다.

사전 요구 사항

시작하기 전에 다음을 설치하십시오:

프로젝트 설정

첫 번째로 각 프레임워크의 respective scaffolding tool를 사용하여 새로운 프로젝트를 생성하세요.

Vue 3

터미널을 열고 Vue 3 프로젝트를 생성하기 위해 다음 명령어를 실행하세요:

vue create offline-screen-vue3

기본 preset을 선택하고 프로젝트가 생성될 때까지 기다리세요.

Angular 14

터미널을 열고 다음 명령어를 실행하여 새로운 Angular 14 프로젝트를 생성하세요:

ng new offline-screen-angular14

안내를 따라 주시고, 추가 기능에 대한 질문이 나올 때 “라우팅”을 선택하여 스페이스바를 누르세요. 스페이스바 프로젝트가 생성될 때까지 기다리세요.

리액트

터미널을 열고 다음 명령어를 실행하여 새로운 React 프로젝트를 생성하세요.

npx create-react-app offline-screen-react

터미널을 열고 다음 명령어를 실행하여 새로운 리액트 프로젝트를 생성하세요:

Installing the Network API

네트워크 __CAPGO_KEEP_0__ 설치 @capacitor/network 네트워크 API를 제공하는 패키지를 설치해 보겠습니다.

터미널을 열고 프로젝트 디렉토리로 이동한 후 다음 명령어를 실행하여 패키지를 설치하세요:

npm install @capacitor/network

Capacitor 프로젝트의 경우, 다음 명령어를 실행하여 네이티브 프로젝트 파일을 동기화하세요:

npx cap sync

global Capacitor CLI을 설치하여 다음 명령어를 실행하세요:

npm install -g @capacitor/cli

오프라인 화면 구현

다음으로 각 프레임워크에서 오프라인 화면 기능을 구현하겠습니다. 사용자가 오프라인 상태가 되면 간단한 메시지를 표시하겠습니다.

Vue 3

Vue 3 프로젝트에서 src/main.js 파일을 열고 Network 모듈을 import하세요. @capacitor/network:

import { createApp } from 'vue';
import { Network } from '@capacitor/network';

const app = createApp(App);

// Your application setup

app.mount('#app');

Network.addListener('networkStatusChange', status => {
  if (status.connected) {
    // User is back online
    // Hide the offline screen
    document.getElementById('offline-screen').style.display = 'none';
  } else {
    // User is offline
    // Display the offline screen
    document.getElementById('offline-screen').style.display = 'block';
  }
});

const logCurrentNetworkStatus = async () => {
  const status = await Network.getStatus();
  console.log('Network status:', status);
};

모듈을 import하세요.App.vue모듈을 import하세요. <div> 애플리케이션 템플릿 ( offline-screen )에

<template>
  <div id="app">
    <div id="offline-screen">
      <h1>You are offline</h1>
      <p>Please check your internet connection and try again.</p>
    </div>
    <!-- Your application content -->
  </div>
</template>

<style>
#offline-screen {
  display: none;
  text-align: center;
  padding: 20px;
  background-color: #f2f2f2;
}

#offline-screen h1 {
  font-size: 24px;
}

#offline-screen p {
  font-size: 16px;
}
</style>

id가 '을 가진 요소를 추가하여 오프라인 화면 메시지를 표시하세요:

Angular 14

Angular 14 프로젝트에서 src/app/app.component.ts 파일을 열고 Network 모듈을 import하세요. @capacitor/network:

import { Component } from '@angular/core';
import { Network } from '@capacitor/network';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.css']
})
export class AppComponent {

  constructor() {
    Network.addListener('networkStatusChange', status => {
      if (status.connected) {
        // User is back online
        // Hide the offline screen
        document.getElementById('offline-screen').style.display = 'none';
      } else {
        // User is offline
        // Display the offline screen
        document.getElementById('offline-screen').style.display = 'block';
      }
    });
  }

  logCurrentNetworkStatus = async () => {
    const status = await Network.getStatus();
    console.log('Network status:', status);
  };

}

에서 app.component.html모듈을 import하세요. <div> 애플리케이션 템플릿 ( offline-screen )에

<div id="offline-screen">
  <h1>You are offline</h1>
  <p>Please check your internet connection and try again.</p>
</div>

<!-- Your application content -->

id가 app.component.css file:

#offline-screen {
  display: none;
  text-align: center;
  padding: 20px;
  background-color: #f2f2f2;
}

#offline-screen h1 {
  font-size: 24px;
}

#offline-screen p {
  font-size: 16px;
}

파일에 다음 스타일을 추가하세요:

React

In React 프로젝트에서, src/App.js 파일을 열고 Network 모듈을 import하세요. @capacitor/network:

import React, { useEffect } from 'react'
import { Network } from '@capacitor/network'

function App() {

  useEffect(() => {
    Network.addListener('networkStatusChange', (status) => {
      if (status.connected) {
        // User is back online
        // Hide the offline screen
        document.getElementById('offline-screen').style.display = 'none'
      }
      else {
        // User is offline
        // Display the offline screen
        document.getElementById('offline-screen').style.display = 'block'
      }
    })
  }, [])

  const logCurrentNetworkStatus = async () => {
    const status = await Network.getStatus()
    console.log('Network status:', status)
  }

  return (
    <div id="app">
      <div id='offline-screen'>
        <h1>You are offline</h1>
        <p>Please check your internet connection and try again.</p>
      </div>
      {/* Your application content */}
    </div>
  )

}

export default App

다음 스타일을 App.css 파일에 추가하세요:

#offline-screen {
  display: none;
  text-align: center;
  padding: 20px;
  background-color: #f2f2f2;
}

#offline-screen h1 {
  font-size: 24px;
}

#offline-screen p {
  font-size: 16px;
}

현재, 사용자가 오프라인 상태일 때 오프라인 화면이 표시되고, 사용자가 온라인 상태로 돌아오면 오프라인 화면이 숨겨집니다.

지원하는 메서드 및 인터페이스

네트워크 API는 네트워크 연결을 처리하는 데 도움이 되는 여러 메서드 및 인터페이스를 제공합니다. 여기에는 몇 가지 주요 메서드와 인터페이스가 있습니다:

getStatus(): 현재 네트워크 연결 상태를 확인합니다.
addListener('networkStatusChange', ...): 네트워크 연결 상태의 변경을 감지합니다.

Vue, Angular, React에서 오프라인 화면을 계속 진행하세요. Capacitor

Capgo를 사용하는 경우 Vue, Angular, React에서 Capacitor 네이티브 미디어 및 인터페이스 동작을 계획하기 위해 연결하세요. @capgo/capacitor-live-activities를 사용하여 네이티브 기능을 @capgo/capacitor-live-activities를 사용하여 @capgo/capacitor-라이브-활동 네이티브 기능 구현 세부 사항은 @capgo/capacitor-live-activities에서 @capgo/capacitor-live-activities를 사용하여 네이티브 기능 구현 세부 사항은 @capgo/capacitor-video-player에서 @capgo/capacitor-video-player @capgo/capacitor-video-player를 사용하여 네이티브 기능 구현 세부 사항은 @capgo/capacitor-video-player에서 @capgo/capacitor-video-player를 사용하여, 그리고