How to use h5 interface in uniapp

With the development of mobile Internet, developing a multi-platform application has become the pursuit of developers. Uniapp came into being, which allows us to quickly realize the need for one code to run on multiple terminals. Among them, an important aspect involved is how to use the H5 interface in Uniapp. This article will introduce how to use the H5 interface in Uniapp.

1. What is the H5 interface

Let’s first understand what the H5 interface is. H5 (HTML5) is the latest version of the HTML standard. Like the native APP, H5 also provides some interfaces for developers to call, such as positioning, camera, QR code scanning, payment, etc. These interfaces and functions improve the experience of web applications and achieve functions and effects similar to native applications.

2. Using the H5 interface in Uniapp

Uniapp supports the use of the H5 interface. We only need to register a global event on the H5 page and listen to this event in Uniapp.

Register a global event in the H5 page:

document.addEventListener('custom_event', function(e) {
  //执行你的逻辑代码
  alert('H5页面触发一个事件');
})

Listen to this event in Uniapp:

mounted() {
  if(process.env.VUE_APP_PLATFORM === 'h5') {
    const ua = navigator.userAgent.toLowerCase()
    if(/iphone|ipad|ipod/.test(ua)) {
      window.webkit.messageHandlers.callNative.postMessage('H5页面初始化完成');
    } else {
      window.android.callNative('H5页面初始化完成');
    }
  }
}

methods: {
  callNative() {
    alert('Native页面调用了H5里的方法');
  }
}

The above code uses the life cycle mounted and method patches of uniapp. If you don’t understand these concepts, you can first go to uniapp’s official website documentation to learn more.

In the mounted life cycle, the running environment is judged. If the current environment is H5, the corresponding code is executed.

Among them, window.webkit.messageHandlers.callNative.postMessage is the method on iOS, and window.android.callNative is the method on Android. These two methods are to call methods in native and execute the logic code defined in h5.

Call the method defined in the H5 page in Uniapp:

mounted() {
  document.addEventListener('custom_event', () => {
    this.$refs.iframe.contentWindow.postMessage('调用方法', '*');
  });
}

<iframe ref="iframe" src="./h5-page"></iframe>

In the above code, we introduced the H5 page through an iframe on the Uniapp page and added a global event. When the event defined in the H5 page is triggered, call this.$refs.iframe.contentWindow.postMessage to call the method in the H5 page.

3. Notes

When using the H5 interface for cross-platform calls, you need to pay attention to the following matters:

1. Events must be clearly agreed on in the H5 page and Native code name and the type of parameters passed to ensure a successful call.
2. It is recommended to use the Chrome browser when debugging. Using the browser's developer tools can make debugging and testing more convenient. However, it should be noted that some interfaces may not support debugging in the browser and need to be tested on a real machine.
3. For some sensitive functions, such as positioning, camera, etc., user privacy needs to be paid attention to. These operations on H5 pages require user authorization before they can be used.

4. Summary

The above are the methods and precautions for using the H5 interface in Uniapp. Uniapp's cross-platform capabilities allow developers to develop multi-terminal applications more conveniently. When using the H5 interface for cross-platform calls, the event names and parameter types of each party need to be carefully agreed upon to ensure successful calls. In addition, user privacy and security issues need to be paid attention to. I hope this article can help developers better understand and use the H5 interface in Uniapp.

The above is the detailed content of How to use h5 interface in uniapp. For more information, please follow other related articles on the PHP Chinese website!