Files
wordpress-kratos-yang/assets/css
laoyang 8367231e91 侧栏挂件一致性:标题可配、标签列数、重复 id、URL 转义 (3.2.50) #20
一并修掉上一轮列出的 5 处侧栏挂件遗留问题:

1. 标题不读 $args(4 个挂件标题在后台改不了)
   新增 yang_widget_title($args, $instance, $fallback, $id_base),5 个挂件
   统一走它:读 $instance['title'] → 空则回落 $fallback → 过 widget_title
   过滤器 → 输出用 $args['before_title']/after_title → 仍为空则整个节点不输出。
   四个挂件的 update() 补 title,form() 补输入框 + 「留空则不显示标题」说明。
   widget_tags 留空回落「标签聚合」,老站点显示不变。

2. 标签列数随屏宽反转(1440 一列、1180 反而两列)
   逐视口实测:真实断点在 1311→1310,@media(max-width:1310px) 只把格子压成
   110px 而不改侧栏宽度(侧栏 992px 以上恒为容器 1/3),于是格子变小反而能
   塞下 3 个。改为 .w-tags .item a / .widget_links ul li 用
   width: calc(50% - 2px) + 父容器 font-size:0(消掉 inline-block 之间的
   空白宽度),并在 1310 断点里删掉这两条 110px 规则(分类/归档的 110px
   不是网格,保留)。判据守的是「列数单调不增」而不是「某视口恰好两列」。

3. 重复 id nav-tab(桌面一份、手机一份)
   两份导航合并为一份,id 全部带实例后缀:yang_widget_uid($this) 取
   $widget->id(如 widget_posts-2),输出 {uid}-tab / {uid}-new 等,
   aria-controls / aria-labelledby 同步指向真实 id,两实例并用也不撞。

4. 搜索框固定 id(searchform / search / searchsubmit)
   同样改为 {uid}-form / {uid}-field / {uid}-submit,并补
   <label class="sr-only" for="{uid}-field">搜索</label>。

5. 图片 URL 未加引号 + 未转义
   src/href 一律加引号 + esc_url(),alt 用 wp_strip_all_tags + esc_attr,
   简介用 nl2br(esc_html())。背景图踩了一个自己写出来的坑:一开始写成
   esc_url() 套在 esc_attr() 里 = 双重转义,& 变 &amp;amp;,CSS 里拿到
   字面量 amp,背景图 404。改为 url() 内部用 esc_url_raw()(只做协议/字符
   清洗,不入实体),整个 style 属性交给 esc_attr() 统一转义一次。

顺带把侧栏标签页图标在窄屏隐藏(<1200px),避免三个 tab 挤在一起。

验证:
- _widgets_consistency.php        68 通过 / 0 失败
- _widgets_consistency_falsify.php 24 通过 / 0 失败(基线1·自检3·注入20)
- _widgets_hot_test.php           33 / 0
- _widgets_hot_falsify.php        20 / 0
- _widgets_hot_geom.js            24 / 0(真实浏览器几何)
- _widgets_ids_dom.js              5 / 0(真实 DOM 查重复 id)
- _widgets_visual20.js            30 / 0(像素级:图片 naturalWidth>0、
                                      标题装饰线、标签等宽、tab 点击)
- _widgets_icon_wide.js            7 / 0(断点精确在 1200)
- _widgets_tags_geom.js            5 / 0(列数单调性)
- 发布脚本 R1~R10 十组注入全部真红
2026-10-26 23:04:28 +08:00
..