WPanelDivideMulti

多切分面板組件,組合兩分割(WPanelDivideHorizontal、WPanelDivideVertical)與三分割(WPanelDivideHorizontalTriple、WPanelDivideVerticalTriple)四組件而成, 支援rows(1~3)列x cols(1~3)欄共9種佈局,先水平切為cols欄(外層),各欄再各自垂直切為rows列(各欄比例獨立), 各格內容以具名scoped slot(pane)帶出,pane帶出index(格序=row*cols+col)、row(列序)、col(欄序)、width(格寬px)、height(格高px), 分隔條之呈現與拖曳行為皆由前述四組件提供,本組件僅負責組合與比例陣列之轉接

Props

Name Type Default value Required? Description
cols Number 1 No 輸入水平切分欄數整數,範圍為1~3,預設1
rows Number 1 No 輸入各欄垂直切分列數整數,範圍為1~3,預設1
layouts Array null No 輸入支援佈局清單陣列,元素為'rows:cols'字串(如'2:2'),rows與cols組合不在清單內時回退為1:1並提示錯誤,預設null表示支援全部9種
ratiosX Array null No 輸入直向分隔條(欄邊界)位置比例陣列,長度需為cols-1且為遞增於0~1之數字,無效時自動均分,預設null
ratiosY Array null No 輸入橫向分隔條(列邊界)位置比例陣列之陣列,外層長度需為cols,各欄內層長度需為rows-1且為遞增於0~1之數字,無效時自動均分,預設null
sectionWidthMin Number null No 輸入各欄最小寬度數字,單位為px,預設null
sectionWidthMax Number null No 輸入各欄最大寬度數字,單位為px,預設null
sectionHeightMin Number null No 輸入各格最小高度數字,單位為px,預設null
sectionHeightMax Number null No 輸入各格最大高度數字,單位為px,預設null
barColor String '#ddd' No 輸入分隔條顏色字串,預設'#ddd'
barSize Number 2 No 輸入分隔條尺寸數字,為分隔條寬(高)度,單位為px,預設2
barBorderColor String 'transparent' No 輸入分隔條框線顏色字串,預設'transparent'
barBorderSize Number 3 No 輸入分隔條框線寬度數字,單位為px,預設3,通常配合barBorderColor='transparent'使可拖曳區加大又不遮蔽可視區

Events

Name Payload Type Description
update:ratiosX 拖曳直向分隔條時發射,帶出新的欄邊界比例陣列
update:ratiosY 拖曳橫向分隔條時發射,帶出新的列邊界比例陣列之陣列
resize 面板尺寸變更時發射,帶出domresize訊息物件

Description:
  • 多切分面板組件,組合兩分割(WPanelDivideHorizontal、WPanelDivideVertical)與三分割(WPanelDivideHorizontalTriple、WPanelDivideVerticalTriple)四組件而成, 支援rows(1~3)列x cols(1~3)欄共9種佈局,先水平切為cols欄(外層),各欄再各自垂直切為rows列(各欄比例獨立), 各格內容以具名scoped slot(pane)帶出,pane帶出index(格序=row*cols+col)、row(列序)、col(欄序)、width(格寬px)、height(格高px), 分隔條之呈現與拖曳行為皆由前述四組件提供,本組件僅負責組合與比例陣列之轉接

Props

Name Type Default value Required? Description
cols Number 1 No 輸入水平切分欄數整數,範圍為1~3,預設1
rows Number 1 No 輸入各欄垂直切分列數整數,範圍為1~3,預設1
layouts Array null No 輸入支援佈局清單陣列,元素為'rows:cols'字串(如'2:2'),rows與cols組合不在清單內時回退為1:1並提示錯誤,預設null表示支援全部9種
ratiosX Array null No 輸入直向分隔條(欄邊界)位置比例陣列,長度需為cols-1且為遞增於0~1之數字,無效時自動均分,預設null
ratiosY Array null No 輸入橫向分隔條(列邊界)位置比例陣列之陣列,外層長度需為cols,各欄內層長度需為rows-1且為遞增於0~1之數字,無效時自動均分,預設null
sectionWidthMin Number null No 輸入各欄最小寬度數字,單位為px,預設null
sectionWidthMax Number null No 輸入各欄最大寬度數字,單位為px,預設null
sectionHeightMin Number null No 輸入各格最小高度數字,單位為px,預設null
sectionHeightMax Number null No 輸入各格最大高度數字,單位為px,預設null
barColor String '#ddd' No 輸入分隔條顏色字串,預設'#ddd'
barSize Number 2 No 輸入分隔條尺寸數字,為分隔條寬(高)度,單位為px,預設2
barBorderColor String 'transparent' No 輸入分隔條框線顏色字串,預設'transparent'
barBorderSize Number 3 No 輸入分隔條框線寬度數字,單位為px,預設3,通常配合barBorderColor='transparent'使可拖曳區加大又不遮蔽可視區

Events

Name Payload Type Description
update:ratiosX 拖曳直向分隔條時發射,帶出新的欄邊界比例陣列
update:ratiosY 拖曳橫向分隔條時發射,帶出新的列邊界比例陣列之陣列
resize 面板尺寸變更時發射,帶出domresize訊息物件