百度智能小程序 動態(tài)設置整體樣式

2020-09-05 14:10 更新

swan.setTabBarStyle

解釋:動態(tài)設置 tabBar 的整體樣式,底部標簽欄位于小程序底部,方便用戶在不同功能模塊之間進行快速切換。為保證可用性,底部導航欄承載 2-5 個功能,如果超出 5 個功能項,請酌情移入頁面或菜單內。設計文檔詳見 底部標簽欄。

方法參數(shù)

Object object

object參數(shù)說明

屬性名 類型 必填 默認值 說明

color

HexColor

tab 上的文字默認顏色

selectedColor

HexColor

tab 上的文字選中時的顏色

backgroundColor

HexColor

tab 的背景色

borderStyle

String

tabbar 上邊框的顏色, 有效值 black/white

success

Function

接口調用成功的回調函數(shù)

fail

Function

接口調用失敗的回調函數(shù)

complete

Function

接口調用結束的回調函數(shù)(調用成功、失敗都會執(zhí)行)

示例



圖片示例

代碼示例 1 - 動態(tài)設置 

在開發(fā)者工具中打開

<view class="wrap">
    <button type="primary" bindtap="customStyle">
        {{ !hasCustomedStyle ? '自定義Tab樣式' : '移除自定義樣式'}}
    </button>
</view>
Page({
    data: {
        defaultTabBarStyle: {
            color: '#7A7E83',
            selectedColor: '#3cc51f',
            backgroundColor: '#ffffff'
        },
        defaultItemName: '接口'
    },
    customStyle() {
        if (this.data.hasCustomedStyle) {
            this.removeCustomStyle()
            return
        }
        this.setData({hasCustomedStyle: true})
        swan.setTabBarStyle({
            color: '#FFF',
            selectedColor: '#1AAD19',
            backgroundColor: '#000000'
        })
    },

    removeCustomStyle() {
        this.setData({hasCustomedStyle: false})
        swan.setTabBarStyle(this.data.defaultTabBarStyle)
    }
});

設計指南

標簽項應明確區(qū)分默認態(tài)和選中態(tài),方便用戶定位當前所在位置;圖標風格應保存一致;每個標簽項的文字信息不應超出 5 個中文字符,否則將被截斷。

配置背景顏色時,請注意整體頁面效果、及標簽項的可讀性和可用性。

錯誤

圖標的默認態(tài)和選中態(tài)無明顯區(qū)別,只能通過文字顏色判斷當前位置。

錯誤

圖標與文字信息顏色不統(tǒng)一,背景與標簽配色不協(xié)調,過多使用高飽和度顏色等,均會降低閱讀的舒適度。


代碼示例 2 - 設置 borderStyle 

在開發(fā)者工具中打開

Page({
    setTabBarStyle() {
        swan.setTabBarStyle({
            color: '#000', // black
            selectedColor: '#FF0000', // red
            backgroundColor: '#FFFFBD',
            borderStyle: 'black', // 可選值還有white
            success: () => {
                console.log('setTabBarStyle success');
            },
            fail: err => {
                console.log('setTabBarStyle fail', err);
            }
        });
    }
});


代碼示例 3 - tab 的默認樣式可在 app.json 中設置 

在開發(fā)者工具中打開

"tabBar": {
    "list": [
        {
            "pagePath": "pages/index/index",
            "text": "首頁",
            "iconPath":"/images/API_normal.png",
            "selectedIconPath":"/images/API_selected.png"
    },
        {
            "pagePath": "pages/detail/detail",
            "text": "詳情",
            "iconPath":"/images/component_normal.png",
            "selectedIconPath":"/images/component_selected.png"
        }
    ],
    "backgroundColor" : "#ffffff",
    "borderStyle": "white",
    "color": "#000",
    "selectedColor": "#6495ED"
}

錯誤碼

Android

錯誤碼說明

1001

執(zhí)行失敗

iOS

錯誤碼說明

1001

當前頁面不含 tabbar


以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號