隨著小程序的普及,越來越多的開發者開始涉足小程序的開發,而在小程序的開發過程中,組件的使用是不可避免的一部分。 小程序中內(nei) 置了很多常用組件,例如 button(按鈕)、view(視圖容器)、text(文本)等,但是這些內(nei) 置組件並不能滿足我們(men) 在開發過程中的所有需求,因此,我們(men) 需要使用自定義(yi) 組件來滿足更多的需求。
什麽(me) 是自定義(yi) 組件?
自定義(yi) 組件是指除了小程序內(nei) 置的組件之外,由開發者自己定義(yi) 和封裝的組件。自定義(yi) 組件封裝了一些常見的UI元素,例如列表、輪播、導航等,以便於(yu) 在小程序中進行複用。 自定義(yi) 組件可以理解為(wei) 一個(ge) 獨立的功能模塊,其可以被多個(ge) 頁麵使用,這意味著,你隻需要編寫(xie) 一次自定義(yi) 組件,就可以在多個(ge) 頁麵中使用它。
如何創建自定義(yi) 組件?
在創建自定義(yi) 組件之前,您需要先了解一些基本的規則。
1.自定義(yi) 組件的存放位置必須在 `/components` 目錄下。如圖所示:
[](https://imgtu.com/i/D5jHlt)
2. 自定義(yi) 組件的文件名必須以 `.wxml`、`.wxss`、`.js` 和 `.json` 後綴結尾。
3. 自定義(yi) 組件的 `js` 文件必須 `exports` 出一個(ge) 自定義(yi) Component。
4. 自定義(yi) 組件的 `json` 配置文件中, `component` 字段的值必須以 `-` 連接單詞,且第一個(ge) 字母必須小寫(xie) 。
創建自定義(yi) 組件的詳細步驟:
步驟一:首先在小程序的根目錄中創建一個(ge) `components` 目錄:
[](https://imgtu.com/i/D5P84f)
步驟二:在 `components` 目錄下創建一個(ge) 名為(wei) `my-component` 的目錄,並在該目錄中創建如下所示的四個(ge) 文件: `my-component.wxml` 、`my-component.wxss`、 `my-component.js`和 `my-component.json`。
[](https://imgtu.com/i/D5PuWQ)
步驟三:在 `my-component.wxml` 中編寫(xie) 自定義(yi) 組件的模板:
```html
```
此處的模板代碼實現了一個(ge) 包含一個(ge) 文本框和一個(ge) 按鈕的自定義(yi) 組件。
步驟四:在 `my-component.wxss` 中編寫(xie) 自定義(yi) 組件的樣式:
```css
.container {
display: flex;
align-items: center;
justify-content: center;
flex-direction: column;
}
.btn {
margin-top: 20px;
width: 200px;
height: 40px;
background-color: #369;
color: #fff;
border: none;
outline: none;
box-shadow: 0 4px 4px rgba(0, 0, 0, 0.3);
border-radius: 5px;
}
```
此處的樣式代碼可以實現居中顯示組件,並給按鈕添加了樣式。
步驟五:在 `my-component.js` 中編寫(xie) 自定義(yi) 組件的邏輯:
```javascript
Component({
properties: {
text: String,
},
methods: {
onButtonClick() {
console.log('Click the button!');
},
},
});
```
此處的邏輯代碼用於(yu) 添加組件的屬性和方法。
步驟六:在 `my-component.json` 中編寫(xie) 自定義(yi) 組件的配置信息:
```json
{
"component": true,
"usingComponents": {}
}
```
此處的配置文件用於(yu) 聲明當前文件是一個(ge) 自定義(yi) 組件,並且可以在其他頁麵中使用。
使用自定義(yi) 組件
在創建了自定義(yi) 組件之後,就可以在其他頁麵中引用和使用它了。使用自定義(yi) 組件的步驟如下:
步驟一:在需要使用自定義(yi) 組件的 `wxml` 文件中添加 `usingComponents` 聲明:
```html
```
此處的 `name` 屬性是當前頁麵使用該組件的名稱,在該頁麵的 `wxml` 中可以使用該名稱來引用該組件的 UI 和邏輯。`src` 屬性則指定自定義(yi) 組件的路徑。
步驟二:在該頁麵的 `wxml` 中使用剛才聲明的自定義(yi) 組件:
```html
```
此處的 `text` 屬性是自定義(yi) 組件的屬性,可以通過 `properties` 字段在自定義(yi) 組件中定義(yi) 。
小結
自定義(yi) 組件在小程序開發中起到非常重要的作用,可以使開發者在開發過程中更加方便、快捷地編寫(xie) 出自己想要的功能和UI。 在實際的開發過程中,使用自定義(yi) 組件應遵循一些基本的規則,並可以通過 `properties` 和 `methods` 字段來添加組件的屬性和方法。