滚动面板
设置滚动区域、方向、内容分组与结束位置。
水平滚动
menu:
title: '&8滚动食物'
rows: 1
panels:
- layout:
- '< >'
icons:
'<':
material: ARROW
name: '&f向左'
action: 'scroll left'
'>':
material: ARROW
name: '&f向右'
action: 'scroll right'
scroll:
direction: horizontal
tail: -1
colums:
- material: APPLE
name: '&f苹果'
- material: CARROT
name: '&f胡萝卜'
- material: POTATO
name: '&f马铃薯'
- material: BREAD
name: '&f面包'
- material: MELON_SLICE
name: '&f西瓜'
- material: GOLDEN_CARROT
name: '&f金胡萝卜'
- material: BAKED_POTATO
name: '&f烤马铃薯'
- material: GOLDEN_APPLE
name: '&f金苹果'下载 scroll-demo.yml。两端为控制按钮，中间七格为可见区域。
区域与分组
layout 中连续的空格矩形作为滚动区域，icons 放区域外的固定图标。以下面板字段写在 panels 的相应项中：
| 字段 | 类型 | 必填 | 默认行为 | 说明 |
|---|---|---|---|---|
layout | 文字列表 | 是 | — | 必须留出连续的空格矩形作为滚动区域 |
scale | 两项整数列表 | 否 | 根据 layout 确定 | 面板宽度、高度 |
locate | 两项整数列表 | 否 | 在父容器中自动放置 | 面板起点坐标 |
icons（icon、item、items） | 图标映射 | 是 | — | 滚动区域外的固定图标 |
scroll | 滚动设置对象 | 是 | — | 滚动方向与内容 |
滚动字段
以下字段写在 scroll 中：
| 字段 | 类型 | 必填 | 默认行为 | 说明 |
|---|---|---|---|---|
direction | 文字 | 否 | horizontal | horizontal 横向，vertical 纵向 |
colums | 图标或图标组的列表 | 是 | — | 内容分组，使用 colums 这一拼写 |
tail | 整数 | 否 | -1，循环滚动 | 结束位置与循环方式，见下文 |
default-index | 整数或表达式文本 | 否 | 从偏移 0 开始 | 打开时的滚动偏移；正数移动到对应位置 |
横向时，每组是一列，图标从上到下排列；纵向时，每组是一行，图标从左到右排列。单格内容可直接写图标，多个图标使用嵌套列表：
scroll:
direction: horizontal
colums:
-
- material: APPLE
- material: CARROT
-
- material: BREAD
- material: POTATO滚动结束位置
tail | 行为 |
|---|---|
| 负数，例如 -1 | 循环滚动 |
| 0 | 可以滚动到可见区域全部为空的位置 |
| 正数 | 停止时保留该数量的内容分组 |
例如上述七格可见区域设 tail: 7，会在最后七项完整显示时停止。正数不超过内容分组数量。
控制语句
| 语句 | 作用 |
|---|---|
scroll right / scroll down / scroll next | 正向滚动一组 |
scroll left / scroll up / scroll previous | 反向滚动一组 |
scroll reset | 回到偏移 0 |
scroll get | 读取当前偏移 |
有多个滚动区域时，可使用 panel 选择目标，见面板选择。
最后更新于