從0開發豆果美食小程序——搜索組件

效果圖

組件結構

爲組件設置一個容器，在容器中放置搜索圖標、輸入框、清除文字按鈕和搜索按鈕。

<view class='container'>
    <view class='input-wrapper'>
        <image class='search-icon' src='/img/search.png'></image>
        <input 
        placeholder='{{placeholder}}' 
        value='{{inputValue}}' 
        bindinput='handleInput' 
        bindconfirm='handleSearch'
        bindfocus='inputFocused'>
        </input>
        <view class='close-icon-wrapper' wx:if="{{showCloseIcon}}" bindtap='clearValue'>
        <image class='close-icon' src='/img/close.png' ></image>
        </view>
        <text bindtap='onTap'>搜索</text>
    </view>
</view>

組件樣式

container：高度 100 rpx，背景色 #eee，flex 佈局。
input-wrapper：高度 80 rpx，背景色 #fff，flex 佈局，border-radius: 20rpx。
search-icon：寬高 32 rpx。
input：字體和光標顏色 #000，字體大小 32 rpx。
close-icon-wrapper：寬高 80 rpx，絕對定位。
text：搜索按鈕寬 110 rpx，高 65 rpx，絕對定位，左邊框 2rpx solid #eee。

.container {
    background: #eee;
    height: 100rpx;
    width: 100%;
    display: flex;
    justify-content: center;
    align-items: center;
}

.input-wrapper {
    display: flex;
    align-items: center;
    height: 80rpx;
    width: 80%;
    background: #fff;
    border-radius: 20rpx;
}

.input-wrapper .search-icon {
    margin-left: 20rpx;
    width: 32rpx;
    height: 32rpx;
}

.input-wrapper input {
    margin-left: 10rpx;
    color: #000;
    font-size: 32rpx;
    caret-color: #000;
    width: 60%;
}

.input-wrapper .close-icon-wrapper{
    position: absolute;
    left: 480rpx;
    width: 80rpx;
    height: 80rpx;
    background:#fff;
    display: flex;
    justify-content: center;
    align-items: center;
}

.input-wrapper .close-icon {
    width: 42rpx;
    height: 42rpx;
}

.input-wrapper text {
    position: absolute;
    right: 80rpx;
    width: 110rpx;
    height: 65rpx;
    padding: 0;
    background: #fff;
    display: flex;
    justify-content: center;
    align-items: center;
    font-size: 32rpx;
    border-left: 2rpx solid #eee;
}

組件功能

1. 屬性區分

組件的構造器中要注意區分 properties 和 data，properties 中寫組件的對外屬性，data 寫組件的對內屬性。在本搜索組件中 placeholder 和 value 從頁面傳來，因此它們寫在 properties 中，控制清除按鈕是否出現的 showCloseIcon 要寫在 data 中。

properties: {
    placeholder: {
        type: String,
        value: '搜索' // 若是頁面不傳placeholder，顯示「搜索」
    },
    inputValue: {
        type: String
    }
},
data: {
    showCloseIcon: false,
},

2.方法設置

事件流程

（1）光標不聚焦，沒有任何輸入——顯示搜索圖標、placeholder和搜索按鈕。
（2）光標聚焦，沒有任何輸入——光標閃爍，顯示搜索圖標、placeholder和搜索按鈕。
（3）光標聚焦，有輸入——光標閃爍，顯示搜索圖標、輸入文字、清除按鈕和搜索按鈕。
（4）光標不聚焦，有輸入——顯示搜索圖標、輸入文字、清除按鈕和搜索按鈕。
（5）按回車搜索——清除按鈕隱藏。
（6）點擊搜索按鈕——清除按鈕隱藏。

因而可知，須要 input 組件的聚焦和鍵盤輸入事件。

<input 
    placeholder='{{placeholder}}' 
    value='{{inputValue}}' 
    bindinput='handleInput' 
    bindconfirm='handleSearch'
    bindfocus='inputFocused'>
</input>

inputFocused：若是聚焦時，輸入框中有內容，顯示 closeIcon；
handleInput：若是輸入時沒有內容，不顯示 closeIcon，有內容，顯示 closeIcon 並把值存入 value。
handleSearch：點擊回車後，不顯示 closeIcon。
triggerEvent：自定義組件觸發事件時，須要使用 triggerEvent 方法，指定事件名、detail對象和事件選項。文檔詳情

inputFocused(e) {
            if (e.detail.value !== '') {
                this.setData({
                    showCloseIcon: true,
                });
            }
        },
        handleInput(e) {
            if (e.detail.value == '') {
                this.setData({
                    showCloseIcon: false,
                });
            } else {
                this.setData({
                    showCloseIcon: true,
                });
                this.triggerEvent('handleInput', {
                    value: e.detail.value
                });
            }
        },
        handleSearch() { // 點擊鍵盤上的回車，調用此方法
            this.setData({
                showCloseIcon: false,
            });
            console.log('handleSearch', this.data.inputValue);
        },

<view class='close-icon-wrapper' wx:if="{{showCloseIcon}}" bindtap='clearValue'>
    <image class='close-icon' src='/img/close.png' ></image>
</view>
<text bindtap='onTap'>搜索</text>

分別爲 closeIcon 和 搜索按鈕添加點擊事件。

clearValue() {
            this.triggerEvent('handleInput', {
                value: ''
            });
            this.setData({
                showCloseIcon: false,
            });
        },
        onTap() {
            this.setData({
                showCloseIcon: false,
            });
            console.log('onTap', this.data.inputValue);
        },

組件 json

{
  "component":true
}

頁面 json

工程的名字是 cookbook，這裏組件前綴統一爲 ck。

{
    "usingComponents":{
        "ck-input":"/components/search/index"
    }
}

頁面 wxml

<view class='container'>
    <ck-input
    placeholder='搜你想吃的'
    inputValue="{{inputValue}}"
    bind:handleInput="handleInput">
    </ck-input>
</view>

頁面 js

handleInput(e) {
        this.setData({
            inputValue: e.detail.value,
        });
    },

結束語

至此，搜索組件已完成初步開發。