widget 布局与尺寸

import widget

steps = widget.param.number("步数", 8420, min=0, max=50000)
calories = widget.param.number("千卡", 420, min=0, max=5000)
sleep_h = widget.param.number("睡眠(h)", 7, min=0, max=12)
accent = widget.param.color("主色", "#10B981")

w = widget.Widget(background=("#ECFDF5", "#064E3B"), padding=14)
w.text("今日健康", size=16, weight="semibold").line_limit(1)
with w.row(spacing=12):
    with w.column(spacing=2):
        w.text("步数", size=11, color="secondary").line_limit(1)
        w.value(steps).monospaced_digit().line_limit(1).min_scale(0.72)
    with w.column(spacing=2):
        w.text("千卡", size=11, color="secondary").line_limit(1)
        w.value(calories).monospaced_digit().line_limit(1).min_scale(0.72)
    with w.column(spacing=2):
        w.text("睡眠", size=11, color="secondary").line_limit(1)
        (
            w.value(sleep_h, unit="h")
            .monospaced_digit()
            .line_limit(1)
            .min_scale(0.72)
        )
w.rect(color=accent, height=3, corner_radius=2)
w.render()

选定 family（small / medium / large / 锁屏 accessory）
        ↓
读 widget.context → content_width × content_height（扣掉 padding 后的可画区域）
        ↓
决定信息层级：标题 → 主值 → 次要说明 → 图表/表格
        ↓
选容器：语义流式用 row/column/grid；精确格子用 table；点位绘制用 canvas
        ↓
防裁切：line_limit + min_scale；small 隐藏次要行

import widget

tracking = widget.param.text("单号", "SF1234567890")
status = widget.param.text("状态", "运输中")
eta = widget.param.text("预计", "明天 18:00")
accent = widget.param.color("主色", "#F59E0B")
ctx = widget.context
pad = widget.family_value(14, small=10, large=16)

w = widget.Widget(background=("#FFFBEB", "#292524"), padding=pad)

if ctx.is_family("small"):
    w.text("快递", size=14, weight="semibold", color=accent).line_limit(1)
    w.text(tracking, size=12).line_limit(1).min_scale(0.6)
    w.text(status, size=11, color="secondary").line_limit(1).min_scale(0.72)
else:
    w.text("快递追踪", size=16, weight="semibold").line_limit(1)
    w.text(tracking, size=12, color="secondary").line_limit(1).min_scale(0.65)
    with w.row(spacing=8):
        w.symbol("shippingbox.fill").color(accent).font_size(16)
        w.text(status, size=14, weight="semibold").line_limit(1).min_scale(0.72)
    if ctx.is_family("large"):
        w.text(f"预计送达 {eta}", size=12, color="secondary").line_limit(1)
    else:
        w.text(f"预计 {eta}", size=12, color="secondary").line_limit(1).min_scale(0.72)

w.render()

import widget

show = widget.param.text("节目", "心灵马杀鸡")
episode = widget.param.text("集数", "第 128 期")
progress = widget.param.slider("进度", 0.42, min=0, max=1, step=0.01)
accent = widget.param.color("主色", "#8B5CF6")

title_size = widget.family_value(16, small=14, large=18)
bar_h = widget.family_value(6, small=5, large=8)
pad = widget.family_value(14, small=10, large=16)

w = widget.Widget(background=("#FAF5FF", "#1E1B4B"), padding=pad)
w.text(show, size=title_size, weight="semibold").line_limit(1).min_scale(0.72)
w.text(episode, size=12, color="secondary").line_limit(1).min_scale(0.72)
w.progress(float(progress), total=1, color=accent, height=bar_h)

with w.when("large", layout="column"):
    w.text("继续收听 →", size=12, color=accent).line_limit(1)

w.render()

import widget

days = ["一", "二", "三", "四", "五", "六", "日"]
plan = widget.param.choice("打卡计划", ["一三五", "天天练", "周末"], default="一三五")
accent = widget.param.color("打卡色", "#EF4444")

active_sets = {
    "一三五": {0, 2, 4},
    "天天练": set(range(7)),
    "周末": {5, 6},
}
active = active_sets[str(plan)]

w = widget.Widget(background=("#FFFFFF", "#1C1C1E"), padding=12)
w.text("本周训练", size=15, weight="semibold").line_limit(1)
with w.grid(columns=7, spacing=4, equal=True):
    for i, day in enumerate(days):
        mark = "●" if i in active else "○"
        (
            w.text(day + mark, size=10, color=accent if i in active else "secondary")
            .line_limit(1)
            .min_scale(0.55)
            .align("center")
        )
w.render()

import widget

items = ["喝水", "散步", "整理", "阅读", "计划", "备份", "写作", "放松", "复盘"]
done = widget.state.list("bingo_done", [])
accent = widget.param.color("完成色", "#4F9A48")

w = widget.Widget(background=("#FBFAF5", "#141414"), padding=10)
w.text("今日九宫格", size=17, weight="bold").line_limit(1).min_scale(0.72).align("center")

with w.table(rows=3, columns=3, line_color=accent, line_width="hairline", fill=True) as table:
    for i, label in enumerate(items):
        checked = done.contains(i)
        with table.cell(i // 3, i % 3):
            (
                w.button(
                    ("✓ " if checked else "") + label,
                    action=done.toggle_item(i),
                    style="plain",
                    color=accent if checked else "#242326",
                    size=12,
                    press={"scale": 0.94},
                    normal={"scale": 1},
                )
                .line_limit(1)
                .min_scale(0.55)
                .align("center")
            )

w.render()

import widget

w = widget.Widget(background="#FFFFFF", padding=12)
ctx = widget.context
cw = ctx.content_width
ch = ctx.content_height

with w.canvas(fill=True, coordinate_space="points") as c:
    c.rect(color="#EEF2F7", width=cw, height=ch).place(cw / 2, ch / 2, unit="points")
    (
        c.text(f"{int(cw)} × {int(ch)} pt", size=14, weight="semibold")
        .line_limit(1)
        .min_scale(0.72)
        .place(cw / 2, ch / 2, unit="points")
    )
    (
        c.text(ctx.family, size=11, color="secondary")
        .line_limit(1)
        .place(cw / 2, ch / 2 + 16, unit="points")
    )

w.render()

import widget

steps = widget.state.int("steps", 6234)
accent = widget.param.color("主色", "#34D399")
ctx = widget.context

w = widget.Widget(background=("#F0FDF4", "#14532D"), padding=widget.family_value(8, circular=0, rectangular=4, inline=0))

if ctx.is_family("circular"):
    w.symbol("figure.walk").color(accent).font_size(14)
    w.text(str(int(steps) // 1000) + "k", size=11, weight="bold").line_limit(1).min_scale(0.6)
elif ctx.is_family("rectangular"):
    with w.row(spacing=6):
        w.symbol("figure.walk").color(accent).font_size(14)
        (
            w.value(steps, unit="步")
            .monospaced_digit()
            .line_limit(1)
            .min_scale(0.65)
        )
elif ctx.is_family("inline"):
    w.text(f"今日 {int(steps)} 步", size=12).line_limit(1).min_scale(0.72)
else:
    w.text("请切换到锁屏 accessory 预览", size=13, color="secondary").line_limit(2).min_scale(0.7)

w.render()

ctx = widget.context          # 或 w.context（绑定 Widget padding）
ctx.family                    # "small" | "medium" | "large" | ...
ctx.width / ctx.height        # family 预算（点）
ctx.content_width             # 扣 padding 后可画宽
ctx.content_height            # 扣 padding 后可画高
ctx.is_family("small", "medium")
ctx.value(default, small=..., large=...)  # 同 family_value，读当前 family

size = widget.family_value(16, small=14, medium=16, large=20)
pad = widget.family_value(14, small=10, rectangular=6, circular=4, inline=0)

with w.row(spacing=10, align="center"):
    w.symbol("star.fill").color("#F59E0B")
    w.text("标题")

with w.column(spacing=4, align="leading"):
    w.text("副标题", size=12, color="secondary")

with w.layer(align="center", background="#EEF2F7", corner_radius=8):
    w.text("叠放")

with w.grid(columns=2, spacing=8, equal=True):
    w.text("A")
    w.text("B")

with w.when("large", layout="column"):
    w.line_chart([1, 3, 2, 5])