打開(kāi)一個(gè)抽屜式側(cè)滑 window，可以從當(dāng)前 window 的左右邊緣滑動(dòng)拉出側(cè)滑 window。

此方法能夠使用 openWin 方法的所有參數(shù)，在此基礎(chǔ)上增加了 leftPane、rightPane 等參數(shù)，可以通過(guò) api.closeWin()方法來(lái)關(guān)閉整個(gè)抽屜式側(cè)滑。

實(shí)例widget下載地址

openDrawerLayout({params})

params

leftPane：

• 類(lèi)型：JSON 對(duì)象
• 默認(rèn)值：無(wú)
• 描述：左邊側(cè)滑 window
• 內(nèi)部字段：

{
    edge:60,                            // 左邊側(cè)滑打開(kāi)后，漏出的半透明區(qū)域?qū)挾龋J(rèn)值為60。此時(shí)左邊側(cè)滑window的寬度為屏幕寬度減去edge
    name:'',                            // window名字（字符串類(lèi)型）
    url:'',                             // 頁(yè)面地址，可以為本地文件路徑，支持相對(duì)路徑和絕對(duì)路徑，以及widget://、fs://等協(xié)議路徑，也可以為遠(yuǎn)程地址
    pageParam:{},                       //（可選項(xiàng)）頁(yè)面參數(shù)，頁(yè)面中可以通過(guò)api.pageParam獲取，JSON對(duì)象
    bgColor:'',                         //（可選項(xiàng)）背景色，支持圖片和顏色，格式為#fff、#ffffff、rgba(r,g,b,a)等，圖片路徑支持fs://、widget://等APICloud自定義文件路徑協(xié)議，同時(shí)支持相對(duì)路徑
    bounces:false,                      //（可選項(xiàng)）是否彈動(dòng)，默認(rèn)值：若在 config.xml 里面配置了pageBounce，則默認(rèn)值為配置的值，否則為false
    scrollToTop:false,                  //（可選項(xiàng)）當(dāng)點(diǎn)擊狀態(tài)欄，頁(yè)面是否滾動(dòng)到頂部。若當(dāng)前屏幕上不止一個(gè)頁(yè)面的scrollToTop屬性為true，則所有的都不會(huì)起作用。默認(rèn)值：true。只iOS有效
    scrollEnabled:true                  //（可選項(xiàng)）頁(yè)面內(nèi)容超出后是否可以滾動(dòng)，默認(rèn)為true，只支持iOS
    vScrollBarEnabled:true,             //（可選項(xiàng)）是否顯示垂直滾動(dòng)條，默認(rèn)true 
    hScrollBarEnabled:true,             //（可選項(xiàng)）是否顯示水平滾動(dòng)條，默認(rèn)true
    scaleEnabled:true,                  //（可選項(xiàng)）頁(yè)面是否可以縮放，布爾型，默認(rèn)值：false
    allowEdit:false,                    //（可選項(xiàng)）是否允許長(zhǎng)按頁(yè)面時(shí)彈出選擇菜單
    softInputMode:'auto',               //（可選項(xiàng)）當(dāng)鍵盤(pán)彈出時(shí)，輸入框被蓋住時(shí)，當(dāng)前頁(yè)面的調(diào)整方式，只iOS有效
                                        //取值范圍：
                                        //resize      //若鍵盤(pán)蓋住輸入框，頁(yè)面會(huì)自動(dòng)上移
                                        //pan         //若鍵盤(pán)蓋住輸入框，頁(yè)面不會(huì)自動(dòng)上移
                                        //auto        //默認(rèn)值，由系統(tǒng)決定如何處理，iOS平臺(tái)該字段等同于resize
    softInputBarEnabled:false,          //（可選項(xiàng)）是否顯示鍵盤(pán)上方的工具條，布爾型，默認(rèn)值：true，只iOS有效
    defaultRefreshHeader:''             //（可選項(xiàng)）設(shè)置使用默認(rèn)下拉刷新類(lèi)型，取值范圍：pull、swipe
    customRefreshHeader:''              //（可選項(xiàng)）設(shè)置使用自定義下拉刷新模塊的名稱(chēng)，設(shè)置后可以使用api.setCustomRefreshHeaderInfo方法來(lái)使用自定義下拉刷新組件
}

rightPane：

• 類(lèi)型：JSON 對(duì)象
• 默認(rèn)值：無(wú)
• 描述：右邊側(cè)滑 window
• 內(nèi)部字段：

{
    edge:60,                            // 右邊側(cè)滑打開(kāi)后，漏出的半透明區(qū)域?qū)挾?，默認(rèn)值為60。此時(shí)右邊側(cè)滑window的寬度為屏幕寬度減去edge
    name:'',                            // window名字（字符串類(lèi)型）
    url:'',                             // 頁(yè)面地址，可以為本地文件路徑，支持相對(duì)路徑和絕對(duì)路徑，以及widget://、fs://等協(xié)議路徑，也可以為遠(yuǎn)程地址
    pageParam:{},                       //（可選項(xiàng)）頁(yè)面參數(shù)，頁(yè)面中可以通過(guò)api.pageParam獲取，JSON對(duì)象
    bgColor:'',                         //（可選項(xiàng)）背景色，支持圖片和顏色，格式為#fff、#ffffff、rgba(r,g,b,a)等，圖片路徑支持fs://、widget://等APICloud自定義文件路徑協(xié)議，同時(shí)支持相對(duì)路徑
    bounces:false,                      //（可選項(xiàng)）是否彈動(dòng)，默認(rèn)值：若在 config.xml 里面配置了pageBounce，則默認(rèn)值為配置的值，否則為false
    scrollToTop:false                   //（可選項(xiàng)）當(dāng)點(diǎn)擊狀態(tài)欄，頁(yè)面是否滾動(dòng)到頂部。若當(dāng)前屏幕上不止一個(gè)頁(yè)面的scrollToTop屬性為true，則所有的都不會(huì)起作用。默認(rèn)值：true。只iOS有效
    scrollEnabled:true                  //（可選項(xiàng)）頁(yè)面內(nèi)容超出后是否可以滾動(dòng)，默認(rèn)為true，只支持iOS
    vScrollBarEnabled:true,             //（可選項(xiàng)）是否顯示垂直滾動(dòng)條，默認(rèn)true 
    hScrollBarEnabled:true,             //（可選項(xiàng)）是否顯示水平滾動(dòng)條，默認(rèn)true
    scaleEnabled:true,                  //（可選項(xiàng)）頁(yè)面是否可以縮放，布爾型，默認(rèn)值：false
    allowEdit:false,                    //（可選項(xiàng)）是否允許長(zhǎng)按頁(yè)面時(shí)彈出選擇菜單
    softInputMode:'auto'                //（可選項(xiàng)）當(dāng)鍵盤(pán)彈出時(shí)，輸入框被蓋住時(shí)，當(dāng)前頁(yè)面的調(diào)整方式，只iOS有效
                                        //取值范圍：
                                        //resize       //若鍵盤(pán)蓋住輸入框，頁(yè)面會(huì)自動(dòng)上移
                                        //pan          //若鍵盤(pán)蓋住輸入框，頁(yè)面不會(huì)自動(dòng)上移
                                        //auto         //默認(rèn)值，由系統(tǒng)決定如何處理，iOS平臺(tái)該字段等同于resize
    softInputBarEnabled:false,          //（可選項(xiàng)）是否顯示鍵盤(pán)上方的工具條，布爾型，默認(rèn)值：true，只iOS有效
    defaultRefreshHeader:''             //（可選項(xiàng)）設(shè)置使用默認(rèn)下拉刷新類(lèi)型，取值范圍：pull、swipe
    customRefreshHeader:''              //（可選項(xiàng)）設(shè)置使用自定義下拉刷新模塊的名稱(chēng)，設(shè)置后可以使用api.setCustomRefreshHeaderInfo方法來(lái)使用自定義下拉刷新組件
}

slidToOpenPane：

• 類(lèi)型：布爾
• 默認(rèn)值：true
• 描述：（可選項(xiàng)）是否支持在頁(yè)面邊緣處滑動(dòng)打開(kāi)drawerPane

slidToClosePane：

• 類(lèi)型：布爾
• 默認(rèn)值：true
• 描述：（可選項(xiàng)）在打開(kāi)的drawerPane頁(yè)面，是否支持滑動(dòng)關(guān)閉drawerPane

tapToClosePane：

• 類(lèi)型：布爾
• 默認(rèn)值：true
• 描述：（可選項(xiàng)）在打開(kāi)的drawerPane頁(yè)面，是否支持點(diǎn)擊遮罩部分關(guān)閉drawerPane

示例代碼

api.openDrawerLayout({
    name: 'main',
    url: './main.html',
    animation: {
        type: 'none'
    },
    leftPane: {
        name: 'leftPane',
        url: 'leftPane.html'
    }
});

可用性

iOS系統(tǒng)，Android系統(tǒng)

可提供的1.2.0及更高版本