阴影与效果#
三种 CSS 阴影#
| 效果 | 轮廓与适用对象 |
|---|---|
| box-shadow | 布局边框盒,透明对象、椭圆内容也使用盒轮廓 |
| text-shadow | 文字或公式内容的 alpha 轮廓 |
| filter:drop-shadow(...) | 渲染内容的 alpha 轮廓,目前支持一个 drop-shadow |
.card { box-shadow:1mm 2mm 3mm 0mm #0004; }.title { text-shadow:0.5mm 0.5mm 1mm #0006; }.cutout { filter:drop-shadow(1mm 1mm 1mm #0005); }盒阴影依次为 x 偏移、y 偏移、模糊半径、扩散距离和颜色。前两个长度必需,模糊和扩散可省略,省略颜色使用 currentColor。文字阴影不接受 spread 或 inset;drop-shadow 不接受 spread 或 inset。
多层、内阴影与负扩散#
.card { box-shadow:1mm 2mm 3mm #192c4e40, 3mm 4mm 6mm -1mm #2e2a6820;}.inset { box-shadow:inset 1mm 1mm 3mm #33415580; }逗号定义多个阴影,首层在上。正 spread 外扩、负 spread 收缩。外阴影裁掉盒内部分;内阴影在背景上、内容和边框下。效果随组变换并遵循裁剪,超出画布部分可能被裁掉。
page=canvas(size=(140mm,80mm),background="#f6f7fb")style { .card { background-color:white; border:0.25mm solid #94a3b8; border-radius:2mm; box-shadow:1mm 2mm 3mm #192c4e40,3mm 4mm 6mm -1mm #2e2a6820; } .card.tuned { box-shadow-blur:2mm; box-shadow-color:#7c3aed40,#0891b240; } .card.inset { box-shadow:inset 1mm 1mm 3mm #33415580; } .label { color:rebeccapurple; font-size:5mm; font-weight:700; text-shadow:0.4mm 0.4mm 1mm #33415580; } .drop { background-color:#0d9488; filter:drop-shadow(2mm 2mm 1mm #17255480); }}cards = []for appearance,label in [("card","Original layers"),("card tuned","Blur / color override"),("card inset","Inset")] { target = page.top_left gap = (12mm,12mm) if len(cards) > 0 { target = cards[len(cards)-1].top_right gap = (13mm,0mm) } item = page.add(rect(size=(30mm,25mm),class=appearance),target=target,offset=gap) cards = append(cards,item) page.add(text(label,font_size=3mm,color="#334155"),target=item.bottom_left,offset=(0mm,5mm))}page.add(text("Glyph shadow",class="label"),target=cards[0].bottom_left,offset=(0mm,21mm))page.add(ellipse(size=(18mm,18mm),class="drop"),anchor=top_center,target=cards[2].bottom_center,offset=(0mm,18mm))预览
依赖文件
examples/gallery/styles/layers.lay
partial-overrides#
引用样式库后只把模糊改为 2mm:
@import "@laymesh/bootstrap.css";.shadow.custom { box-shadow-blur:2mm !important; }class="bg-primary rounded shadow custom" 保留库的偏移、扩散、颜色和已有层数。Bootstrap 阴影带重要声明,局部覆盖也需要 !important 和更具体的选择器。
| 调整意图 | 声明 |
|---|---|
| 模糊半径变为 2mm | box-shadow-blur:2mm |
| 向外扩散 2mm | box-shadow-spread:2mm |
| 向右、向下偏移 2mm | box-shadow-offset:2mm 2mm |
| 改颜色 | box-shadow-color:#0d6efd66 |
| 改为内阴影 | box-shadow-position:inset |
下面从左到右是库的原始阴影、仅把模糊改为 2mm、仅把扩散改为 2mm、仅把 x/y 偏移改为 2mm。每项只改一个分项,颜色及其余字段保持原值;完整源码可以直接编辑比较。
# The same Bootstrap shadow; each variant changes one field only.page = canvas(size=(160mm,65mm), stylesheet="@laymesh/bootstrap.css", background="#f6f7fb")style { .caption { font-size:3mm; color:#243447; } .heading { font-size:5mm; color:#243447; } .shadow.blur { box-shadow-blur:2mm !important; } .shadow.spread { box-shadow-spread:2mm !important; } .shadow.offset { box-shadow-offset:2mm 2mm !important; }}heading = page.add(text("One field, three meanings",class="heading"),target=page.top_left,offset=(12mm,8mm))variants = [("","Original"),("blur","Blur: 2 mm"),("spread","Spread: 2 mm"),("offset","Offset: 2, 2 mm")]cards = []for modifier,label in variants { target = heading.bottom_left gap = (0mm,11mm) if len(cards) > 0 { target = cards[len(cards)-1].top_right gap = (11mm,0mm) } item = page.add(rect(size=(27mm,20mm),class="bg-primary rounded shadow "+modifier),target=target,offset=gap) cards = append(cards,item) page.add(text(label,class="caption"),target=item.bottom_left,offset=(0mm,6mm))}预览
依赖文件
examples/gallery/styles/shadow-parameters.lay
分项名称采用 CSS Borders Level 4 工作草案,仍处于草案阶段。以下规则说明 LayMesh 当前实现。单值应用到全部已有层,逗号列表逐层设置,较短列表循环使用。仅设置 blur 不会创建阴影。offset 的单值也保留层数,显式 offset 列表可设置层数;单层一个 offset 长度同时设置 x/y,none 关闭对应层。
重新声明 box-shadow 会重置分项;box-shadow:none 清除阴影。重要分项仍参与级联,普通简写不能越过重要声明。
# Keep reusable imports and local overrides in theme.lcss.page = canvas(size=(80mm,50mm), stylesheet="theme.lcss")page.add( rect(size=(30mm,20mm), class="bg-primary rounded shadow custom"), anchor=center, target=page.center)/* Shared offline libraries; nothing is automatically imported. */@import "@laymesh/bootstrap.css";@import "@laymesh/open-props.css";@import "@laymesh/animate.css"; /* Local appearance and motion follow the same cascade. */.custom { animation-duration: 2s; }.shadow.custom { box-shadow-blur: 2mm !important; }预览
依赖文件
examples/manual/css-shadow-override.layexamples/manual/theme.lcss
blur 与原有 effects 的区别#
CSS 盒阴影和文字阴影的模糊半径转换为高斯标准差时除以 2:blur=2mm 对应 sigma=1mm。drop-shadow 的第三个长度直接表示 sigma。
effects=[shadow(...),glow(...)] 是独立的 LayMesh 效果栈,按列表顺序叠加,保留原有 target、顺序和模糊语义。shadow(blur=2mm) 使用 sigma=2mm,spread 非负。盒阴影分项不会修改此栈,见艺术字与效果。
导出与预算#
SVG、PNG 和 PDF 使用同一效果定义。PDF 主体保留矢量,模糊效果局部栅格化。输出 DPI 影响栅格细节,不改变毫米长度。沿用现有像素与内存预算;预算错误需缩小影响范围或降低相关栅格密度,不能通过隐藏警告忽略错误。


