wechat-miniprogram/skyline-skills/skyline-components

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Skyline 组件开发技能。涵盖 scroll-view 及其增强模式(列表/嵌套滚动)、swiper 高级特性、表单组件、图片/文本组件、半屏可拖拽组件、共享元素动画等。适用于需要开发滚动列表、轮播、表单输入、页面过渡动画等场景。

Install

npx vskill@latest install wechat-miniprogram/skyline-skills/skyline-components

SKILL.md

Skyline 组件开发指南

适用场景

  • 开发滚动列表/瀑布流/网格布局
  • 实现下拉刷新、下拉二级功能
  • 使用嵌套滚动模式
  • 开发轮播图、卡片切换效果
  • 处理表单输入(input/textarea)
  • 实现共享元素/页面转场动画
  • 开发半屏可拖拽面板

组件支持概览

完全支持的高频组件
组件Skyline 特性增强
scroll-viewtype 模式、worklet 回调、嵌套滚动、下拉二级
swiperlayout-type 堆叠/卡片、indicator 动画类型
textoverflow 文本溢出处理、max-lines
imagefade-in 渐显、默认懒加载
input/textareaworklet 键盘回调、输入法事件
view/button完全支持
Skyline 新增组件
组件说明
list-view列表布局容器
grid-view网格/瀑布流容器
sticky-section/sticky-header吸顶布局
nested-scroll-header/body嵌套滚动
draggable-sheet半屏可拖拽
share-element共享元素动画
snapshot截图组件
span内联混排

文档索引

根据需求快速定位(路径相对于 references/):

我想要...查阅文档
实现长列表/虚拟列表scroll/scroll-view.md
下拉刷新/下拉二级scroll/scroll-view.md#下拉刷新
嵌套滚动scroll/nested-scroll.md
列表/网格布局scroll/list-grid-view.md
吸顶效果scroll/sticky.md
半屏拖拽面板scroll/draggable-sheet.md
轮播图/卡片效果layout/swiper.md
文本处理media/text.md
图片显示media/image.md
输入框开发form/input.md
共享元素动画special/share-element.md
截图功能special/snapshot.md

强制规则

MUST(必须遵守)
  1. scroll-view 必须指定 type:Skyline 下使用 scroll-view 必须设置 type 属性

```html <!-- ✅ 正确 --> <scroll-view type="list" scroll-y>...</scroll-view>

<!-- ❌ 错误:缺少 type --> <scroll-view scroll-y>...</scroll-view> ```

  1. 横向滚动需 enable-flex:横向滚动需同时开启 enable-flex 以兼容 WebView

``html <scroll-view scroll-x enable-flex style="flex-direction: row;"> ``

  1. 文本必须用 text 组件:内联文本只能用 <text> 组件

```html <!-- ✅ 正确 --> <text>Hello <text>World</text></text>

<!-- ❌ 错误:内联文本不能用 view --> <view>Hello <view>World</view></view> ```

  1. list-view/grid-view 必须在 custom 模式:

``html <scroll-view type="custom" scroll-y> <list-view>...</list-view> </scroll-view> ``

  1. 嵌套滚动必须使用 nested 模式:

``html <scroll-view type="nested" scroll-y> <nested-scroll-header>...</nested-scroll-header> <nested-scroll-body>...</nested-scroll-body> </scroll-view> ``

NEVER(禁止行为)
  1. NEVER 在 scroll-view 外直接放置 list-view/grid-view
  2. NEVER 在 list-view 中使用非直接子节点列表项
  3. NEVER 在 Skyline 使用 web-view/editor/movable-view 组件
  4. NEVER 依赖 image 的 WebView-only 裁剪模式(top/bottom/center/left/right)

scroll-view 核心用法

type 属性详解
type 值说明使用场景
list列表模式,按需渲染直接子节点普通长列表
custom自定义模式,支持 list-view/grid-view/sticky复杂布局
nested嵌套模式,处理父子 scroll-view 联动Tab + 列表
基础列表模式
html
<!-- 列表模式:直接子节点按需渲染 -->
<scroll-view
type="list"
scroll-y
style="height: 100vh;"
bindscrolltolower="loadMore"
>
<view wx:for="{{list}}" wx:key="id">
{{item.name}}
</view>
</scroll-view>
下拉刷新
html
<scroll-view
type="list"
scroll-y
refresher-enabled="{{true}}"
refresher-triggered="{{refreshing}}"
bindrefresherrefresh="onRefresh"
>
<view slot="refresher" class="custom-refresher">
自定义刷新区域
</view>
<!-- 列表内容 -->
</scroll-view>
javascript
Page({
data: { refreshing: false },
onRefresh() {
this.setData({ refreshing: true })
// 加载数据...
setTimeout(() => {
this.setData({ refreshing: false })
}, 1000)
}
})
嵌套滚动模式
html
<scroll-view type="nested" scroll-y>
<nested-scroll-header>
<view>顶部固定区域</view>
</nested-scroll-header>
<nested-scroll-body>
<swiper>
<swiper-item wx:for="{{tabs}}" wx:key="id">
<scroll-view
type="list"
scroll-y
associative-container="nested-scroll-view"
>
<!-- 列表内容 -->
</scroll-view>
</swiper-item>
</swiper>
</nested-scroll-body>
</scroll-view>
Worklet 滚动回调
html
<scroll-view
type="list"
scroll-y
worklet:onscrollupdate="onScrollUpdate"
>
javascript
Page({
onScrollUpdate(e) {
'worklet'
// 在 UI 线程执行,无延迟
console.log(e.detail.scrollTop)
}
})

swiper 增强特性

布局类型
html
<!-- 堆叠效果 -->
<swiper layout-type="stackLeft">
<swiper-item>...</swiper-item>
</swiper>
<!-- 卡片滑动 -->
<swiper layout-type="tinder">
<swiper-item>...</swiper-item>
</swiper>
<!-- 过渡动画 -->
<swiper layout-type="transformer" transformer-type="threeD">
<swiper-item>...</swiper-item>
</swiper>
指示器样式
html
<swiper
indicator-dots
indicator-type="worm"
indicator-color="rgba(0,0,0,0.3)"
indicator-active-color="#000"
indicator-margin="10"
indicator-spacing="4"
>
indicator-type效果
normal默认圆点
worm蠕虫动画
expand展开动画
jump跳跃动画
slide滑动动画
scale缩放动画

text 组件

文本溢出处理
html
<!-- 单行省略 -->
<text overflow="ellipsis" max-lines="1">
这是一段很长的文本内容...
</text>
<!-- 多行省略 -->
<text overflow="ellipsis" max-lines="3">
这是一段很长的文本内容...
</text>
<!-- 渐隐效果 -->
<text overflow="fade" max-lines="1">
这是一段很长的文本内容...
</text>
内联混排
html
<!-- 使用 span 实现图文混排 -->
<span>
<image src="icon.png" style="width:20px;height:20px;" />
<text>图文混排内容</text>
</span>

input 组件

Skyline 特有事件
html
<input
value="{{value}}"
bindinput="onInput"
bind:selectionchange="onSelectionChange"
bind:keyboardcompositionend="onCompositionEnd"
worklet:onkeyboardheightchange="onKeyboardHeight"
/>
javascript
Page({
onKeyboardHeight(e) {
'worklet'
// UI 线程回调,可用于同步调整布局
const { height, pageBottomPadding } = e.detail
}
})

draggable-sheet 半屏组件

html
<draggable-sheet
class="sheet"
initial-child-size="0.5"
min-child-size="0.2"
max-child-size="0.8"
snap="{{true}}"
snap-sizes="{{[0.4, 0.6]}}"
worklet:onsizeupdate="onSizeUpdate"
>
<scroll-view
scroll-y
type="list"
associative-container="draggable-sheet"
>
<!-- 内容 -->
</scroll-view>
</draggable-sheet>
javascript
Page({
onReady() {
this.createSelectorQuery()
.select('.sheet')
.node()
.exec(res => {
const sheetContext = res[0].node
sheetContext.scrollTo({
size: 0.7,
animated: true,
duration: 300
})
})
}
})

share-element 共享元素

页面间共享元素动画

源页面:

html
<share-element key="hero-image" transform>
<image src="{{item.cover}}" />
</share-element>

目标页面:

html
<share-element key="hero-image" transform transition-on-gesture>
<image src="{{detail.cover}}" />
</share-element>
属性说明
属性说明
key页面内唯一标识,源和目标必须匹配
transform是否启用动画
transition-on-gesture手势返回时是否动画
rect-tween-type动画轨迹(materialRectArc/linear)

性能优化

列表性能
  1. 使用 list 模式:确保只渲染可见区域

``html <scroll-view type="list" scroll-y cache-extent="500"> ``

  1. 指定 cache-extent:预渲染视口外区域,优化滚动体验
  1. 使用 list-item 属性:启用样式共享

``html <view wx:for="{{list}}" wx:key="id" list-item> ``

swiper 性能
html
<!-- 使用 cache-extent 预渲染相邻页 -->
<swiper cache-extent="1">

组件差异速查

组件WebViewSkyline备注
scroll-view无 type必须 typeSkyline 增强
textspace 属性overflow/max-lines不同特性
image9种裁剪模式5种缩放模式裁剪模式仅 WebView
swipersnap-to-edgelayout-type/indicator-type不同特性
inputplaceholder-classworklet 回调不同特性

相关技能

场景推荐技能说明
滚动 APIskyline-scroll-apiScrollViewContext 接口
动画开发skyline-workletWorklet 动画系统
样式开发skyline-wxssWXSS 支持情况
路由转场skyline-route页面转场动画
兼容性诊断skyline-diagnostics自动检查组件兼容性问题

References 目录结构

references/
├── form/
│ └── input.md
├── gesture/
│ ├── gesture-negotiation.md
│ └── gesture-system.md
├── layout/
│ └── swiper.md
├── media/
│ ├── image.md
│ └── text.md
├── scroll/
│ ├── draggable-sheet.md
│ ├── list-grid-view.md
│ ├── nested-scroll.md
│ ├── scroll-view.md
│ └── sticky.md
└── special/
├── share-element.md
└── snapshot.md

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
39
Repository forks
1
7-day trend score
18

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/wechat-miniprogram/skyline-skills/skyline-components/badge)](https://verified-skill.com/skills/wechat-miniprogram/skyline-skills/skyline-components)

Something wrong with this skill or its page? Tell us.