The meta module can be used to declare meta information for a single page, such as the viewport of the container.




The default width (viewport) of Weex container is 750px. The setViewport method can change the viewport of the page and only takes effect on the current page.

Notice: The viewport must be set before the page rendering starts. In other words, the setViewport method can only be used in the entry file, and before the new Vue (...) statement. If it’s used in the component, the code is executed only when the component is being rendered, meanwhile, the page is already in the rendering process, set the viewport will not take effect again.

it is only in the rendering of the components will be implemented The corresponding code,


Referance: W3C Spec CSS Device Adaptation.

  • options: viewport configuration
    • width: Number or "device-width" or "device-height".
    • height: Number or "device-width" or "device-height".

The default unit of the width and height is px, other units are not supported.


The entry file:

// entry.js

import App from './app.vue'
const meta = weex.requireModule('meta')

// The width of the viewport is set to 640px
width: 640

App.el = '#root'
new Vue(App)

After configuring the width of the viewport to 640 in the entry.js, all the components in the current page will take 640px as full screen width.

Example component:

<!-- app.vue -->
<div class="box750">
<text class="text">750</text>
<div class="box640">
<text class="text">640</text>
<div class="box480">
<text class="text">480</text>

<style scoped>
.box750 {
width: 750px;
height: 750px;
background-color: #EEEEEE;
.box640 {
width: 640px;
height: 640px;
background-color: #CCCCCC;
.box480 {
width: 480px;
height: 480px;
background-color: #AAAAAA;
.text {
font-size: 50px;

Try it. (The doesn’t support to configure the entry file currently.)

Referance: Set up development environment.

Edit this page on GitHub