uView 2.0 Documentation

uView 2.0 supports the easycom mechanism. Once configured, components are automatically imported on demand. You do not need to manually import components; you can use them directly in your templates.

Example usage:

<template>
	<u-button text="按钮"></u-button>
</template>

uView 2.0 is a UI framework designed for the uni-app ecosystem, providing full compatibility with nvue. It supports multiple platforms including mini-programs, H5, iOS apps, and Android apps.

You can install uView 2.0 via the uni-app plugin market:

https://ext.dcloud.net.cn/plugin?id=1593

For detailed installation instructions, refer to the official installation documentation.

To use uView UI, you must install the library and ensure your environment is configured to handle its dependencies.

Important: CLI Mode Configuration If you encounter errors related to dependency transpilation, you must configure transpileDependencies in your vue.config.js file. Refer to the official documentation for specific settings: https://www.uviewui.com/components/npmSetting.html#_5-cli模式额外配置.

Installation via Vue Plugin The library provides an install function that should be used during your Vue initialization. This function performs the following:

1. Registers global filters: timeFormat, date, and timeFrom.
2. Mounts the $u object to Vue.prototype (except in nvue environments).
3. Applies global mixins.

You can customize the development server behavior by using the configureWebpack property in vue.config.js.

Specifically, setting devServer.disableHostCheck: true allows for network tunneling (内网穿透), enabling external users or devices on different networks to access your local H5 development pages during debugging.

module.exports = {
    configureWebpack: {
        devServer: {
            // 调试时允许内网穿透，让外网的人访问到本地调试的H5页面
            disableHostCheck: true
        }
    }
}

uView provides utilities for deep object manipulation:

• deepClone(obj): Creates a deep copy of an object, handling Date, RegExp, Map, Set, and Array.
• deepMerge(target, source): Performs a deep merge of a source object into a target object. It returns a new object and does not mutate the original target.

The guid(len, firstU, radix) function generates a unique identifier.

• len: Length of the UUID (default 32). If omitted, it generates a standard RFC4122-like UUID.
• firstU: If true (default), the first character is replaced with 'u'. This ensures the ID is a valid CSS class or HTML ID (which cannot start with a digit).
• radix: The base for random character selection (e.g., 10 for decimal, 16 for hex).