LayMesh文档
EN

样式与动画综合案例#

从样式与动画库开始:先了解内置库、来源和导入方法,再逐项尝试、调参和组合;单文件 .lay 就能起步。

样式手册 · 动画手册

这三组完整项目从样式库组合走到艺术字与复杂场景。每组都提供可编辑 .lay、主题、资源和真实 WASM 预览;静态图与动画从同一份源码生成。先看完整排版,再点“放映”:这些案例的第一步设置了 after-previous,进入后会自动开始。

案例 样式内容 动画内容
三库卡片 Bootstrap 配色、2mm 模糊覆盖、Open Props 渐变、圆角与阴影、内阴影 标题入场、错开卡片入场、描线、自定义透视强调
艺术字海报 字形渐变、描边、矢量挤出、曲线路径、波浪变形、阴影、发光、透明图片 子对象独立动作、重复与交替、整个组的三维投影
复杂仪表板 256 组矢量图案、12 张图表、24 个公式、透明面板和效果 并行循环、负延迟、透视翻转、12 条描线、有限窗口

styled-cards#

三个离线库和一个项目主题#

布局文件只保存尺寸、放置、组件内容与步骤;styled-theme.lcss 同时管理外观和关键帧。主题显式导入 Bootstrap、Open Props 和 Animate.css。metric() 复用卡片结构,循环遍历三条内容记录,以不同 class 获得三种外观。第一张相对说明文字放置,后续卡片连接前一张的 top_right;组内文字也沿 bottom_left 接续。

第一张卡片组合 bg-primary rounded shadow custom,只把 Bootstrap 阴影模糊改为 2mm;第二张把 Open Props 变量用于渐变、圆角和多层阴影;第三张使用内阴影。.metric .label 等所属选择器统一组内文字,显式参数优先的规则仍然适用。

完整源码
styled-cards.lay
# Reusable appearance and motion live in styled-theme.lcss; geometry stays here.page = canvas(size=(200mm,105mm), stylesheet="styled-theme.lcss", background="#f6f7fb")title = page.add(text("Style + motion",class="heading"),target=page.top_left,offset=(12mm,8mm))note = page.add(text("Three offline libraries / one project theme",class="caption"),target=title.bottom_left,offset=(0mm,5mm)) function metric(label,value,detail,appearance) {  card = group(class="metric")  plate = card.add(rect(size=(54mm,38mm),class=appearance))  label_text = card.add(text(label,class="label"),target=plate.top_left,offset=(5mm,5mm))  value_text = card.add(text(value,class="value"),target=label_text.bottom_left,offset=(0mm,6mm))  card.add(text(detail,class="footnote"),target=value_text.bottom_left,offset=(0mm,7mm))  return card}metrics = [  ("Bootstrap","2 mm","Blur override only","bg-primary rounded shadow custom"),  ("Open Props","Gradient","Radius + layered shadow","ocean"),  ("Inset shadow","Inside","Same animation pipeline","inset")]instances = []for label,value,detail,appearance in metrics {  target = note.bottom_left  gap = (0mm,10mm)  if len(instances) > 0 {    target = instances[len(instances)-1].top_right    gap = (7mm,0mm)  }  item = page.add(metric(label,value,detail,appearance),target=target,offset=gap)  instances = append(instances,item)}rule = page.add(line(length=page.width-24mm,class="rule"),target=instances[0].bottom_left,offset=(0mm,11mm))page.add(text("Theme + components + anchors",class="caption"),target=rule.start,offset=(0mm,9mm)) intro = page.step(name="Title",start="after-previous",hold=200ms)intro.animate(title,class="animate__animated animate__fadeInDown",duration=600ms)intro.animate(note,class="animate__animated animate__fadeIn",duration=400ms,delay=200ms)cards = page.step(name="Staggered cards",start="after-previous",hold=400ms)for i,item in enumerate(instances) {  cards.animate(item,class="animate__animated animate__fadeInUp",duration=700ms,delay=i*150ms)}cards.animate(rule,name="laymesh-draw",duration=1s,fill="both")focus = page.step(name="Inspect one card",start="after-previous",hold=400ms)focus.animate(instances[1],class="focus-motion")

预览

背景
正在准备动画…
Styled Cards
正在准备预览…
合计 —
详情

尚未运行

本设备浏览器实测;不含防抖等待。

修改仅保留在本页
依赖文件
  • examples/animation/styled-cards.lay
  • examples/animation/styled-theme.lcss

instances = append(instances,item) 保存实际放置的实例;append() 返回新列表,需要重新赋值。第二个循环把这些实例交给 animate(),用 delay=i*150ms 实现错开入场。修改一个卡片尺寸或文字字号,邻接卡片及后续文字按锚点重新定位,无需逐个修改页面坐标。

全局时间 动作
0–0.6s 标题与说明同时入场,说明延迟 0.2s
0.6–0.8s 停留
0.8–1.8s 三张卡片相隔 0.15s 开始,分隔线同时描线
1.8–2.2s 停留
2.2–3.1s 第二张卡片执行主题中的自定义透视动作
3.1–3.5s 停留,随后保留终态

在完整源码中编辑主题的 box-shadow-blur:2mm,静态阴影和动画中的阴影一起改变;改成 box-shadow-spread:2mm 则改变扩散,不是模糊。编辑 focus-card 改变运动。动画调用里的显式 duration 会覆盖 CSS 时长,见步骤参数。

布局源码 · 项目主题

art-direction#

把已有艺术字与效果案例组合成动画#

此项目沿用已有的艺术字案例和透明图片与组效果,把重复外观移入 art-direction.lcss。图片来自仓库内的 alpha-ring.png,无需下载。

完整源码
art-direction.lay
# Adapted from examples/effects/art-text.lay and images-groups.lay.page = canvas(size=(180mm,125mm),stylesheet="art-direction.lcss",background="#f6f7fb")heading = page.add(text("ART DIRECTION / styled and animated",class="heading"),target=page.top_left,offset=(12mm,8mm))art = group()plate = art.add(rect(size=(156mm,83mm),class="plate"))hero = art.add(text("Layers in motion",class="hero"),target=plate.top_left,offset=(8mm,8mm))route = path(commands=[move_to(0mm,10mm),cubic_to(35mm,0mm,95mm,0mm,128mm,10mm)],class="route")# Path and path text share their local origin; place their group as a unit.curve = group()trace = curve.add(route,target=curve.top_left)curved = curve.add(text("Text follows a curved path",class="curved",path=text_path(route,align="center")),target=curve.top_left)art.add(curve,anchor=top_center,target=plate.top_center,offset=(0mm,31mm))wave = art.add(text("Wave and glow",class="wave"),target=plate.bottom_left,anchor=bottom_left,offset=(12mm,-25mm))stamp = art.add(image(src="../effects/alpha-ring.png",class="stamp"),size=(20mm,20mm),                target=plate.bottom_right,anchor=bottom_right,offset=(-10mm,-15mm))art.add(text("Glyph paint / outline / extrusion / alpha shadows",class="poster-note"),         target=plate.bottom_left,anchor=bottom_left,offset=(8mm,-10mm))poster = page.add(art,target=heading.bottom_left,offset=(0mm,12mm))page.add(text("Child motion and parent perspective compose without changing layout.",class="caption"),          target=poster.bottom_left,offset=(0mm,7mm)) entrance = page.step(name="Glyphs and curved path",start="after-previous",hold=300ms)entrance.animate(hero,class="animate__animated animate__fadeInUp",duration=800ms)entrance.animate(trace,name="laymesh-draw",duration=1200ms,fill="both")entrance.animate(curved,class="animate__animated animate__fadeIn",duration=600ms,start="after-previous",delay=200ms)details = page.step(name="Independent child animations",start="after-previous",hold=300ms)details.animate(wave,class="wave-motion")details.animate(stamp,class="animate__animated animate__flipInY",duration=1200ms)inspect = page.step(name="Whole poster in perspective",start="after-previous",hold=600ms)inspect.animate(poster,class="poster-motion")

预览

背景
正在准备动画…
Art Direction
正在准备预览…
合计 —
详情

尚未运行

本设备浏览器实测;不含防抖等待。

修改仅保留在本页
依赖文件
  • examples/animation/art-direction.lay
  • examples/animation/art-direction.lcss
  • examples/effects/alpha-ring.png

主题里的 .hero 组合字形渐变、白色描边、二维矢量挤出和原有 effects 阴影;.curved 使用 CSS 文字阴影,.wave 使用波浪变形与发光,.stamp 使用内容 Alpha 的 drop-shadow。底板的盒阴影是另一套轮廓。它们各自保留阴影与效果中说明的模糊语义。

海报底板相对页标题放置,页脚跟随海报的 bottom_left,印章以 bottom_right 贴住底板内侧。曲线路径仍由 .lay 定义;路径和沿路径排字的文字共用局部原点,并把它们的组对齐底板。路径控制点是几何数据,不是各对象的页面位置;描线动作逐步显示路径。三个步骤分别是:

  1. 标题入场与路径描线并行;曲线文字在描线后延迟 0.2s 出现。
  2. 波浪文字上下移动,两轮交替;透明图片同时执行 flipInY。
  3. 放置后的整个海报组执行透视旋转,所有子对象及效果随组一起变化。

总时间为 7.6s,含每步停留。float-wave 的两轮动作占 2.4s,inspect-poster 占 2s。变形文字的轮廓是静态外观,transform 是播放时的整体变换;动画不重新排字。最后关键帧回到零旋转,退出放映或选择“完整排版”恢复静态设计。

布局源码 · 项目主题 · 透明图片

complex-dashboard#

用循环组织复杂动画场景#

这个项目借用已有压力场景配方中 09-motion-3d 的内容规模,改写成可维护的 Lay 程序:组件函数定义结构,循环创建对象,列表保存实例,锚点连接相邻对象。数值采样保存在独立 dashboard-data.json 中;它们是确定性合成信号,不代表实验结果。

完整源码
complex-dashboard.lay
# Layout uses components, loops and anchors. Plot data lives in its own file.page = canvas(size=(320mm,180mm), stylesheet="dashboard-theme.lcss", background="#f4f6fa")data = dict(src="dashboard-data.json")colors = ["#2975b9","#d88735","#318b7d","#8867b1"]equations = [  r"\int_0^\infty e^{-x^2}\,dx=\frac{\sqrt{\pi}}{2}",  r"E=\sum_{i=1}^{N}\frac{1}{2}m_i v_i^2",  r"\frac{\partial u}{\partial t}=\alpha\nabla^2 u",  r"\mathbf{A}=\begin{pmatrix}a&b\\c&d\end{pmatrix}",  r"f(x)=\frac{1}{\sigma\sqrt{2\pi}}e^{-\frac{(x-\mu)^2}{2\sigma^2}}",  r"\hat{f}(\omega)=\int_{-\infty}^{\infty}f(t)e^{-i\omega t}\,dt",  r"\Delta G=\Delta H-T\Delta S",  r"\lim_{n\to\infty}\left(1+\frac{1}{n}\right)^n=e"] # Lay supports arithmetic and loops; cycle a palette without unrolling items.function cycle_index(index,count) {  while index >= count { index = index - count }  return index} # Seed the first item; anchor others to a neighbour or the previous row.function in_grid(material,items,columns,origin,inset,gap,opacity=1) {  count = len(items)  if count == 0 {    return page.add(material,target=origin,offset=inset,opacity=opacity)  }  if cycle_index(count,columns) == 0 {    return page.add(material,target=items[count-columns].bottom_left,offset=(0mm,gap[1]),opacity=opacity)  }  return page.add(material,target=items[count-1].top_right,offset=(gap[0],0mm),opacity=opacity)} function motif(index,size) {  tile = group()  plate = tile.add(rect(size=size,class="motif-plate"))  tile.add(ellipse(size=(size[0]/2,size[1]/2),class="motif-ring",border_color=colors[cycle_index(index,4)]),           anchor=center,target=plate.center)  tile.add(line(length=size[0]*0.8,class="motif-stroke"),anchor=center,target=plate.center,rotation=18deg)  return tile}motifs = []motif_size = (310mm/32-1mm,145mm/8-1mm)for i in range(256) {  item = in_grid(motif(i,motif_size),motifs,32,page.top_left,(5mm,25mm),(1mm,1mm),opacity=0.6)  motifs = append(motifs,item)} title = page.add(text("Complex dashboard / 12 charts + 24 equations",class="heading"),                 target=page.top_left,offset=(7mm,5mm))note = page.add(text("256 patterns | 12 charts | 24 equations | 3d",class="caption"),                target=title.bottom_left,offset=(0mm,4mm)) chart_size = (304mm/4-3mm,90mm/3-3mm)function chart(index) {  card = group(class="chart-card")  plate = card.add(rect(size=chart_size,class="chart-plate"))  kind = "Signal"  if cycle_index(index,3) == 2 { kind = "Heat map" }  card.add(text("Panel "+str(index+1)+" / "+kind,class="panel-label"),           target=plate.top_left,offset=(2mm,1mm))  q = plot(size=(chart_size[0]-3mm,chart_size[1]-5mm),           plot_area=box(offset=(7mm,1mm),size=(chart_size[0]-12mm,chart_size[1]-12mm)),           frame=box,style=plot_style(font_family="DejaVu Sans",font_size=4pt,line_width=0.18mm),           x=axis(range=(0,10),ticks=[0,5,10]),y=axis(range=(-1.5,1.5),ticks=[-1,0,1]))  values = data["panels"][index]  if cycle_index(index,3) == 2 {    q.heatmap(z=values["z"],extent=(0,10,-1.5,1.5),origin=lower,cmap="viridis")  } else {    for k,ys in enumerate(values["series"]) {      q.line(x=data["x"],y=ys,color=colors[k])    }    q.scatter(x=data["scatter_x"],y=values["scatter_y"],color="#20354b",marker_size=0.45mm)  }  card.add(q,target=plate.top_left,offset=(0mm,4mm))  return card}charts = []for i in range(len(data["panels"])) {  item = in_grid(chart(i),charts,4,page.top_left,(8mm,27mm),(3mm,3mm))  charts = append(charts,item)} formula_size = (304mm/6-2mm,52mm/4-2mm)function equation_card(source) {  card = group(class="formula-card")  plate = card.add(rect(size=formula_size,class="formula-plate"))  card.add(formula(source=source,class="equation"),anchor=center,target=plate.center)  return card}formulas = []for i in range(24) {  item = in_grid(equation_card(equations[cycle_index(i,len(equations))]),formulas,6,                 charts[len(charts)-4].bottom_left,(0mm,8mm),(2mm,2mm))  formulas = append(formulas,item)}strokes = []for i in range(12) {  item = in_grid(line(length=20mm,line_color=colors[cycle_index(i,4)],line_width=0.22mm),                 strokes,12,formulas[len(formulas)-6].bottom_left,(0mm,4mm),(5mm,0mm))  strokes = append(strokes,item)} # Lists keep the placed instances available for a second pass of animation.scene = page.step(name="Complex scene",start="after-previous",duration=12s,hold=0s)scene.animate(title,name="title-motion",duration=3s,iterations="infinite",easing="linear",fill="both")for i,item in enumerate(charts) {  scene.animate(item,name="panel-flip",duration=3s,delay=-i*71ms,                iterations="infinite",easing="ease-in-out",fill="both")}for i,item in enumerate(formulas) {  scene.animate(item,name="panel-flip",duration=3s,delay=-(i+len(charts))*71ms,                iterations="infinite",easing="ease-in-out",fill="both")}for i in range(0,len(motifs),4) {  scene.animate(motifs[i],name="motif-motion",duration=4s,delay=-i*13ms,                iterations="infinite",easing="linear",fill="both")}for i,item in enumerate(strokes) {  scene.animate(item,name="laymesh-draw",duration=2s,delay=-i*90ms,                iterations="infinite",direction="alternate",easing="linear",fill="both")}

预览

背景
正在准备动画…
Complex Dashboard
正在准备预览…
合计 —
详情

尚未运行

本设备浏览器实测;不含防抖等待。

修改仅保留在本页
依赖文件
  • examples/animation/complex-dashboard.lay
  • examples/animation/dashboard-data.json
  • examples/animation/dashboard-theme.lcss
内容 组合方式
256 组矢量图案 渐变底板、椭圆和交叉线;每四组之一旋转
12 张图表 8 张三曲线+散点图、4 张热图;卡片组带透明度、阴影与光晕
24 个公式 公式位于嵌套卡片中,带阴影并随卡片一起投影
12 条开放线 描线进度交替循环
标题、图表与公式 多个动作并行,使用不同负延迟错开循环相位

这些数量是输入内容数量,不是渲染后路径数或帧率指标。整个步骤显式限定 duration=12s,所以无限循环也能放映、定位和导出;窗口结束不修改 CSS 的重复次数。此页只有一个步骤,回退回到其起点;多步骤练习使用前两个案例。

源码按三层阅读:

  1. motif()、chart()、equation_card() 分别定义图案、图表卡片和公式卡片;主题保存重复外观与关键帧。
  2. in_grid() 只为第一项设置起点;同一行连接前一项的 top_right,换行连接上一行同列的 bottom_left。公式区接在最后一行图表下方,描线区接在最后一行公式下方。行列间距由 gap 控制。
  3. 创建对象的循环收集实例;后面的动画循环遍历列表,用索引计算负延迟和循环相位。每第四组图案执行旋转,用 range(0,len(motifs),4) 表达。

cycle_index() 用循环实现调色板和公式的循环索引;当前 Lay 没有 % 运算符。图表的曲线数组与热图矩阵从 JSON 读取,编辑器中的数据标签可以直接修改。Node 维护脚本只重新计算合成采样数据,不生成或覆盖 .lay、.lcss。已有数据随项目提供,编译和播放不需要运行该脚本。

sh
laymesh validate examples/animation/complex-dashboard.lay# 只有更新合成数据配方时才需要:node scripts/build-dashboard-data.mjs

这是进阶与压力案例,设备负载明显高于前两组。先用“适应”检查整体,再放大工作区看图表和公式;实际设备性能需测量,见播放实现与验证。

完整布局源码 · 项目主题 · 采样数据 · 数据维护脚本

保存、导出与练习#

保存项目时同时保留主题和相对资源。三套离线库仍由引擎提供,文件无需复制上游 CSS。静态导出显示完整设计;MP4/GIF 使用同一份源代码的连续时间线。

sh
laymesh validate examples/animation/styled-cards.laylaymesh render examples/animation/styled-cards.lay -o cards.pdf --dpi 150laymesh animate examples/animation/styled-cards.lay -o cards.mp4 --width 960 --fps 20laymesh render examples/animation/art-direction.lay -o poster.png --time 4 --width 960laymesh animate examples/animation/complex-dashboard.lay -o dashboard.mp4 --width 960 --fps 10

练习时一次只改一个因素:先把模糊从 2mm 改成 1mm,再改卡片延迟,最后改变关键帧角度。对照静态图、时间快照与实际播放;CSS 导入警告、缺失动画、效果溢出分别按兼容与排错和动画排错处理。