# grid-view
基礎庫 2.29.0 開始支持,低版本需做兼容處理。
相關文檔: Skyline 渲染引擎、Skyline 遷移起步
渲染框架支持情況:Skyline (使用最新 Nightly 工具調試)
# 功能描述
Skyline 下網格布局容器 和 瀑布流布局容器?;A庫版本 2.30.4 起提供 WebView 兼容實現(xiàn)。
- 僅支持作為
<scroll-view type="custom">模式的直接子節(jié)點 - 按需渲染節(jié)點,比 WebView 兼容實現(xiàn)具備更好的性能。
# 通用屬性
| 屬性 | 類型 | 默認值 | 必填 | 說明 | 最低版本 | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| type | string | aligned | 是 | 布局方式 | ||||||||
| ||||||||||||
| cross-axis-count | number | 2 | 否 | 交叉軸元素數(shù)量 | ||||||||
| max-cross-axis-extent | number | 0 | 否 | 交叉軸元素最大范圍 | ||||||||
| main-axis-gap | number | 0 | 否 | 主軸方向間隔 | ||||||||
| cross-axis-gap | number | 0 | 否 | 交叉軸方向間隔 | ||||||||
| padding | Array | [0, 0, 0, 0] | 否 | 長度為 4 的數(shù)組,按 top、right、bottom、left 順序指定內邊距 | 3.0.0 | |||||||
# 示例代碼
# Tip
在 WebView 下且 type="masonry" 時,grid-view 的子元素:
- 需具有可見的寬高(
clientWidth和clientHeight)。例如: 設置display: block屬性; 使用 image 組件時,應當手動指定高度或設置mode="widthFix"。 - 若使用
padding、margin等影響盒模型的CSS屬性,需同時設置box-sizing: border。 - 僅針對在末尾增刪元素做優(yōu)化,盡量避免在中間插入子元素。
- 子節(jié)點過多時仍會影響布局性能。對性能敏感的場景,建議使用 Skyline 對應組件。