LayMesh文档
EN

样式与动画库:从导入到组合#

从这里开始#

本章先运行,再查目录和调参。内置库随引擎提供,但默认没有启用任何一套;使用哪一套,就显式导入哪一套。.lcss 文件不是必需的,单个 .lay 文件也可以组合样式与动画。

三套库分别是什么#

库 固定版本 / MIT 上游项目与官方文档 内置导入路径 提供什么
Bootstrap 5.3.8 项目 · 文档 @laymesh/bootstrap.css 现成外观工具类与组件样式;LayMesh 使用受支持的外观部分
Open Props 1.7.23 项目 · 文档 @laymesh/open-props.css 配色、渐变、圆角、阴影、字体、缓动及动画变量
Animate.css 4.1.1 项目 · 文档 @laymesh/animate.css 基础类、97 个效果、速度/延迟/重复工具类和关键帧

三套原始 CSS、版本、许可证和 SHA-256 由资源清单固定。许可证文件随项目保留。@laymesh/ 是引擎资源名,不是需要自己创建的磁盘目录。

读懂最少的五个名字#

名称 写在哪里 用途
stylesheet canvas() 参数 导入一个文件或有序文件列表
class 素材、实例或 animate() 参数 引用类名;多个类以空格分隔,不带选择器的点号
style { ... } .lay 文件 内嵌 CSS 声明,避免单独主题文件
var(--name) 样式属性值 使用已导入或自定义的变量
@keyframes style 或样式文件 定义自定义动画;由 animate() 执行动作

Open Props 提供变量,需要把变量用于属性;Bootstrap 常用工具类可以直接套用;Animate.css 的效果类需与 animate__animated 基础类一起使用。

先分别运行三个库#

Bootstrap 用法与目录 · Open Props 用法与目录 · Animate.css 用法与目录

下面分别只有一个库,源码可直接运行。

完整源码
bootstrap.lay
page=canvas(size=(100mm,65mm),stylesheet="@laymesh/bootstrap.css",background="#f6f7fb")card=page.add(rect(size=(40mm,25mm),class="bg-primary rounded shadow"),anchor=center,target=page.center)page.add(text("Bootstrap: classes",class="text-primary"),anchor=top_center,target=card.bottom_center,offset=(0mm,8mm))

预览

背景
正在准备预览…
Bootstrap
正在准备预览…
合计 —
详情

尚未运行

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

修改仅保留在本页
依赖文件
  • examples/libraries/bootstrap.lay
完整源码
open-props.lay
page=canvas(size=(100mm,65mm),stylesheet="@laymesh/open-props.css",background="#f6f7fb")style { .card { background:var(--gradient-7);border-radius:var(--radius-3);box-shadow:var(--shadow-3); } .label { color:var(--blue-9);font-size:4mm; }}card=page.add(rect(size=(40mm,25mm),class="card"),anchor=center,target=page.center)page.add(text("Open Props: variables",class="label"),anchor=top_center,target=card.bottom_center,offset=(0mm,8mm))

预览

背景
正在准备预览…
Open Props
正在准备预览…
合计 —
详情

尚未运行

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

修改仅保留在本页
依赖文件
  • examples/libraries/open-props.lay
完整源码
animate.lay
page=canvas(size=(100mm,65mm),stylesheet="@laymesh/animate.css",background="#f6f7fb")card=page.add(rect(size=(40mm,25mm),fill="#0d6efd",border_radius=2mm),anchor=center,target=page.center)s=page.step(name="Entrance",start="after-previous",hold=1s)s.animate(card,class="animate__animated animate__fadeInUp",duration=800ms)

预览

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

尚未运行

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

修改仅保留在本页
依赖文件
  • examples/libraries/animate.lay

Bootstrap 加动画:无需自写 CSS#

完整源码
bootstrap-animate.lay
page=canvas(size=(100mm,65mm),stylesheet=["@laymesh/bootstrap.css","@laymesh/animate.css"],background="#f6f7fb")card=page.add(rect(size=(40mm,25mm),class="bg-primary rounded shadow"),anchor=center,target=page.center)s=page.step(name="Styled entrance",start="after-previous",hold=1s)s.animate(card,class="animate__animated animate__fadeInUp",duration=800ms)

预览

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

尚未运行

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

修改仅保留在本页
依赖文件
  • examples/libraries/bootstrap-animate.lay

外观由 bg-primary rounded shadow 提供,动作使用 animate__animated animate__fadeInUp。步骤设置 after-previous,进入放映后自动开始;省略时默认等待点击。

Open Props 加动画:少量内嵌样式#

完整源码
open-props-animate.lay
page=canvas(size=(100mm,65mm),stylesheet=["@laymesh/open-props.css","@laymesh/animate.css"],background="#f6f7fb")style { .card { background:var(--gradient-7);border-radius:var(--radius-3);box-shadow:var(--shadow-3); } }card=page.add(rect(size=(40mm,25mm),class="card"),anchor=center,target=page.center)s=page.step(name="Gradient entrance",start="after-previous",hold=1s)s.animate(card,class="animate__animated animate__fadeInUp",duration=800ms)

预览

背景
正在准备动画…
Open Props Animate
正在准备预览…
合计 —
详情

尚未运行

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

修改仅保留在本页
依赖文件
  • examples/libraries/open-props-animate.lay

--gradient-7、--radius-3、--shadow-3 作用于外观,Animate.css 处理入场。这份项目仍只有一个 .lay 文件。

组合三个库并局部覆盖#

完整源码
all-three.lay
page=canvas(size=(140mm,80mm),stylesheet=["@laymesh/bootstrap.css","@laymesh/open-props.css","@laymesh/animate.css"],background="#f6f7fb")style { .ocean {background:var(--gradient-7);border-radius:var(--radius-3);box-shadow:var(--shadow-3);} .shadow.custom {box-shadow-blur:2mm !important;} .caption {font-size:3mm;color:var(--blue-9);}}records=[("bg-primary rounded shadow custom","Bootstrap + 2mm blur"),("ocean","Open Props gradient")]items=[]for appearance,label in records { target=page.top_left gap=(15mm,25mm) if len(items)>0 { target=items[len(items)-1].top_right gap=(20mm,0mm) } item=page.add(rect(size=(45mm,28mm),class=appearance),target=target,offset=gap) items=append(items,item) page.add(text(label,class="caption"),target=item.bottom_left,offset=(0mm,5mm))}s=page.step(name="Stagger",start="after-previous",hold=1s)for i,item in enumerate(items) {s.animate(item,class="animate__animated animate__fadeInUp",duration=800ms,delay=i*200ms)}

预览

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

尚未运行

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

修改仅保留在本页
依赖文件
  • examples/libraries/all-three.lay

只改 Bootstrap 阴影模糊为 2mm,保留其他字段。!important 与更具体的选择器对应库的阴影声明。循环保存实例并计算延迟,卡片和标签通过锚点排列。

下一步:调参、复用、第三方库#

  1. 选择器与覆盖:显式 .lay 参数优先,CSS 之间再比较重要性、具体程度与顺序。
  2. 属性与单位、阴影:先改颜色、圆角、模糊,再学相对单位和计算表达式。
  3. 动作参数:修改时长、延迟、重复和衔接。
  4. 共享主题与第三方 CSS:只有跨文件重复时才抽出主题。
  5. 综合项目:再阅读艺术字与复杂仪表板。

版本与兼容范围#

本教程面向当前源码构建;已发布包以其发布说明为准。完整上游 CSS 可以加载,外观按 LayMesh 支持范围生效。库不会提供 HTML 组件行为,尺寸、定位和数据继续用 .lay 与锚点;未知内容集中提示,详见兼容与排错。