How to reference built-in components in uniapp

As a cross-platform development framework, Uni-app has a very rich component library, and built-in components are an important part of it. Built-in components are highly reusable and easy to use, and are encapsulations of some commonly used functions, such as buttons, input boxes, lists, etc. During development, you can quickly implement these common functions by referencing built-in components and improve development efficiency. This article will introduce how Uni-app references built-in components.

1. Add built-in components in pages.json file
   In the page configuration file pages.json of Uni-app, there is a global configuration item "usingComponents". This configuration item can be used to reference the built-in component library used by the project. We can add the path of the built-in component we need to use here. The path can be a relative path or an absolute path.

For example, to reference the icon component in the uni-icons icon library on the page, you need to add the following code to the pages.json file:

"usingComponents": {
  "uni-icons": "@/uni-icons/uni-icons.vue"
}

Among them, "uni-icons " is a custom component name, you can choose it casually; "@/" means the project root directory. Here, the uni-icons component is placed in the uni-icons folder in the project root directory.

2. Referencing built-in components in the page
   To use built-in components in the page, you only need to write the custom component name in the tag.

Take the icon component in the uni-icons icon library as an example. The code is as follows:

<template>
    <view class="icon-container">
        <uni-icons type="add"></uni-icons>
        <uni-icons type="attention"></uni-icons>
        <uni-icons type="settings"></uni-icons>
    </view>
</template>

Among them, the type attribute is used to specify the icon to be displayed. For example, type="add" means to display a plus icon. In this way, developers can easily implement the use of some common components. The built-in component library integrates many common basic components, such as buttons, input boxes, selectors, etc., to meet the basic needs of developers.

3. Customize built-in components
   If the component you want is not available in the built-in component library, you can also customize a built-in component. Custom built-in components are basically defined in the same way as ordinary components, and they can be referenced in the above way. It should be noted that when customizing components, you must follow the development specifications of components in Uni-app.

The following is an example of a common custom built-in component:

<template>
  <view class="uni-badge" :class="{&#39;uni-badge--dot&#39;:dot}" v-if="show">
    <slot></slot>
  </view>
</template>

<script>
export default {
    name: 'uni-badge',
    props: {
    dot: {
      type: Boolean,
      default: false
    },
    show: {
      type: Boolean,
      default: true
    }
  }
}
</script>

<style scoped>
.uni-badge {
  display: inline-block;
  font-size: 24rpx;
  line-height: 40rpx;
  color: #fff;
  background-color: #f5222d;
  border-radius: 20rpx;
  text-align: center;
  width: 40rpx;
  height: 40rpx;
}
.uni-badge--dot {
  width: 12rpx;
  height: 12rpx;
  border-radius: 6rpx;
  line-height: 0;
  font-size: 0;
  margin-left: 20rpx;
}
</style>

The above code defines a component named uni-badge. The main function of the component is to display a label with a score or a mark, where the score can be any number and the mark can be a red dot or other graphic.

When customizing built-in components, you need to write code according to Uni-app's component specifications. The component reference method is also as mentioned above.

Summary
Through the introduction of this article, we have understood how Uni-app references built-in components. It can easily use built-in components, shorten development time, and also customize built-in components to suit business needs. . During development, developers can flexibly use built-in components according to their own needs to improve development efficiency and implement more powerful applications.

The above is the detailed content of How to reference built-in components in uniapp. For more information, please follow other related articles on the PHP Chinese website!