布局、尺寸与滚动

卡片错位、内容超出容器或列表滑不动时,分别检查父容器的布局方式、子项尺寸和滚动区域。验证布局时,使用实际的长标题和多行列表检查换行与溢出。

布局模式

需求写法注意事项
横排或纵排display: flex,再设置 flex-direction不希望图标被长文字挤压时,可以为图标设置宽度和 flex-shrink: 0。
等宽网格display: grid; grid-template-columns: 1fr 1fr长文本和图片要有尺寸约束,避免撑宽轨道。
悬浮在同一个容器中父容器 position: relative,子项 position: absolute父容器要有可计算的宽高。
隐藏一块界面display: none节点不占布局空间。只想保留位置时可考虑 visibility: hidden。
滚动吸附position: sticky; top: 0在实际滚动容器中测试吸附起点、终点和返回位置。
旧网页流式布局改为明确的 Flex 或 GridNova 页面样式表接受 flex、grid、linear、relative 和 none。浏览器的 block、inline、inline-block 等写法需要调整。

设置卡片尺寸

需求推荐写法注意事项
让指定宽度包含内边距和边框box-sizing: border-box也可以用 content-box。迁移固定宽度的卡片时建议显式声明。
用比例确定另一边aspect-ratio: 16 / 9至少给其中一边一个可计算的尺寸,例如 width: 100%。
设置最小或最大尺寸min-width、max-width、min-height、max-height使用明确的长度或百分比。Nova 页面样式表会移除 min-width: auto 或 max-width: none 这类声明。若无需限制,省略对应声明。
让卡片之间留白gap,或单独用 row-gap 和 column-gap内边距使用非负长度或百分比。需要在卡片外留白时设置间距或外边距。
网格项过多时换行grid-template-columns: 1fr 1fr,用 grid-auto-flow: row 按行放置Nova 不支持 subgrid。子卡片需要自己的网格时,在子容器上单独声明列。

position 可使用 relative、absolute、fixed 或 sticky。从 WebView 迁移时,使用明确的定位方式替换 position: static。需要把操作按钮固定在卡片角落时,给卡片设置 position: relative,再为按钮指定 right 和 bottom。

长度单位

px 用于明确的布局尺寸和断点。750rpx 对应屏幕宽度,100vw 对应当前页面视口宽度。做分屏和局部容器布局时,优先根据父容器约束使用百分比或 Flex。使用 rem 时检查根字号设置。

滚动区域

overflow: hidden 可用来裁剪内容。需要滚动时用 scroll-view,给容器限定尺寸并开启相应方向。overflow、overflow-x 和 overflow-y 可使用 visible 或 hidden。Nova 不支持 overflow: auto、overflow: scroll、scroll-snap-type 或 overscroll-behavior。迁移步骤见滚动与列表迁移。