
/* =========================================================
   links-related.css
   WordPress 相关链接推荐模块
   ---------------------------------------------------------
   设计目标：
   1. 视觉风格与网站现有蓝色品牌体系协调，但保持独立。
   2. 背景与文字有明显对比，保证良好的可读性。
   3. 兼容 WordPress shortcode 输出的 ul / li 列表。
   4. 适配桌面、平板、手机及小屏设备。
   5. 不影响网站其他模块、全局导航和 Footer。
   6. 优先使用 CSS 原生能力，减少不必要的动画。
   7. 兼顾键盘访问、触摸操作和减少动态效果偏好。

   对应 HTML：
   <section class="links-related container">
       <h2>相关链接</h2>
       <?php echo $links_output; ?>
   </section>

   注意：
   所有选择器均限制在 .links-related 内。
   ========================================================= */


/* =========================================================
   01. 模块基础样式
   ========================================================= */

.links-related {
    /* 模块专属颜色，避免直接修改全站 CSS 变量 */
    --links-primary: #287fc5;
    --links-primary-hover: #1766a8;

    --links-text: #172b43;
    --links-text-secondary: #53657a;

    --links-background: #ffffff;
    --links-item-background: #f7faff;
    --links-item-hover: #edf5ff;

    --links-border: #dce6f0;
    --links-border-hover: #b8d2ed;

    --links-radius: 12px;
    --links-item-radius: 9px;

    --links-shadow:
        0 5px 22px rgba(25, 55, 90, 0.055);

    --links-transition:
        0.2s ease;

    /* 模块布局 */
    position: relative;
    width: 100%;
    min-width: 0;

    /* 与正文内容保持距离 */
    margin-top: 42px !important;
    margin-bottom: 42px;

    /* 模块内部空间 */
    padding: 26px 28px !important;

    /* 独立卡片背景 */
    background: var(--links-background);

    border: 1px solid var(--links-border);
    border-radius: var(--links-radius);

    box-shadow: var(--links-shadow);

    /* 防止短代码中的长文本撑破布局 */
    overflow-wrap: anywhere;

    /* 避免模块内容溢出 */
    box-sizing: border-box;
}


/* =========================================================
   02. 模块标题
   ========================================================= */

.links-related > h2 {
    position: relative;

    display: flex;
    align-items: center;

    /* 标题与左侧装饰线的距离 */
    gap: 12px;

    margin: 0 0 22px;
    padding: 0 0 16px;

    color: var(--links-text);

    font-size: 21px;
    font-weight: 750;
    line-height: 1.45;

    letter-spacing: -0.35px;

    border-bottom: 1px solid var(--links-border);
}

/* 标题左侧蓝色装饰条 */
.links-related > h2::before {
    content: "";

    display: block;
    flex: 0 0 4px;

    width: 4px;
    height: 21px;

    background: linear-gradient(
        180deg,
        #3897e6 0%,
        #1766a8 100%
    );

    border-radius: 4px;
}


/* =========================================================
   03. WordPress shortcode 输出兼容
   ---------------------------------------------------------
   兼容：
   ul > li > a
   ul > li > h3 > a
   ul > li > h4 > a
   ul > li > p > a
   以及 shortcode 可能生成的多层列表。

   不设置全局 ul / li 样式，只处理当前模块。
   ========================================================= */

/* 相关链接模块内的列表 */
.links-related ul {
    list-style: none;

    margin: 0;
    padding: 0;

    /* 防止短代码列表宽度异常 */
    max-width: 100%;
}

/* 一级列表项目 */
.links-related > ul,
.links-related > div > ul,
.links-related > div > div > ul {
    display: grid;

    grid-template-columns: repeat(2, minmax(0, 1fr));

    gap: 11px 13px;
}

/* 所有列表项目 */
.links-related li {
    position: relative;

    min-width: 0;

    margin: 0;
    padding: 0;

    list-style: none;
}

/* =========================================================
   04. 链接卡片基础样式
   ========================================================= */

.links-related li > a {
    position: relative;

    display: flex;
    align-items: flex-start;

    width: 100%;
    min-height: 48px;

    padding: 13px 15px;

    color: var(--links-text);

    background: var(--links-item-background);

    border: 1px solid var(--links-border);
    border-radius: var(--links-item-radius);

    font-size: 14px;
    font-weight: 600;
    line-height: 1.65;

    text-decoration: none;

    transition:
        background-color var(--links-transition),
        border-color var(--links-transition),
        color var(--links-transition),
        box-shadow var(--links-transition),
        transform var(--links-transition);

    /* 长标题自动换行 */
    overflow-wrap: anywhere;
    word-break: normal;
}

/* =========================================================
   05. 兼容标题标签包裹链接的结构
   ========================================================= */

/* h3 / h4 / h5 等标题容器 */
.links-related li > h2,
.links-related li > h3,
.links-related li > h4,
.links-related li > h5 {
    margin: 0;
    padding: 0;

    font-size: inherit;
    font-weight: inherit;
    line-height: inherit;
}

/* 标题内部的链接 */
.links-related li > h2 > a,
.links-related li > h3 > a,
.links-related li > h4 > a,
.links-related li > h5 > a,
.links-related li > p > a {
    display: flex;
    align-items: flex-start;

    width: 100%;
    min-height: 48px;

    padding: 13px 15px;

    color: var(--links-text);

    background: var(--links-item-background);

    border: 1px solid var(--links-border);
    border-radius: var(--links-item-radius);

    font-size: 14px;
    font-weight: 600;
    line-height: 1.65;

    text-decoration: none;

    transition:
        background-color var(--links-transition),
        border-color var(--links-transition),
        color var(--links-transition),
        box-shadow var(--links-transition),
        transform var(--links-transition);

    overflow-wrap: anywhere;
    word-break: normal;
}

/* =========================================================
   06. 链接左侧装饰标记
   ---------------------------------------------------------
   使用 CSS 伪元素，不需要额外 HTML 图标。
   ========================================================= */

.links-related li > a::before,
.links-related li > h2 > a::before,
.links-related li > h3 > a::before,
.links-related li > h4 > a::before,
.links-related li > h5 > a::before,
.links-related li > p > a::before {
    content: "";

    flex: 0 0 7px;

    width: 7px;
    height: 7px;

    margin-top: 8px;
    margin-right: 11px;

    background: var(--links-primary);

    border-radius: 50%;

    transition:
        background-color var(--links-transition),
        transform var(--links-transition);
}

/* =========================================================
   07. Hover 悬停效果
   ---------------------------------------------------------
   仅对具备真实悬停能力的设备启用。
   避免触屏设备产生不必要的粘滞悬停状态。
   ========================================================= */

@media (hover: hover) and (pointer: fine) {

    .links-related li > a:hover,
    .links-related li > h2 > a:hover,
    .links-related li > h3 > a:hover,
    .links-related li > h4 > a:hover,
    .links-related li > h5 > a:hover,
    .links-related li > p > a:hover {

        color: var(--links-primary-hover);

        background: var(--links-item-hover);

        border-color: var(--links-border-hover);

        box-shadow:
            0 5px 15px rgba(40, 127, 197, 0.09);

        transform: translateY(-2px);
    }

    .links-related li > a:hover::before,
    .links-related li > h2 > a:hover::before,
    .links-related li > h3 > a:hover::before,
    .links-related li > h4 > a:hover::before,
    .links-related li > h5 > a:hover::before,
    .links-related li > p > a:hover::before {

        background: var(--links-primary-hover);

        transform: scale(1.2);
    }
}


/* =========================================================
   08. 键盘无障碍焦点
   ---------------------------------------------------------
   使用 :focus-visible：
   键盘操作时显示清晰焦点，
   鼠标点击时不强制显示焦点边框。
   ========================================================= */

.links-related a:focus-visible {
    position: relative;
    z-index: 2;

    outline: 3px solid #1766a8;
    outline-offset: 3px;

    border-color: #1766a8;

    background: #edf5ff;
}

/* 不支持 focus-visible 的浏览器保留基本焦点提示 */
.links-related a:focus {
    outline-offset: 3px;
}


/* =========================================================
   09. 多层列表处理
   ---------------------------------------------------------
   如果 shortcode 输出嵌套 ul，
   避免二级列表错误继承一级双栏布局。
   ========================================================= */

.links-related li ul {
    display: block;

    margin-top: 8px;
    padding-left: 16px;
}

/* 二级列表项目 */
.links-related li ul li {
    margin-top: 6px;
}

/* 二级列表链接 */
.links-related li ul li > a,
.links-related li ul li > h3 > a,
.links-related li ul li > h4 > a {
    min-height: 40px;

    padding: 9px 12px;

    font-size: 13px;
    font-weight: 500;

    background: #ffffff;

    border: 1px solid #e7edf4;
}

/* 二级列表装饰点 */
.links-related li ul li > a::before,
.links-related li ul li > h3 > a::before,
.links-related li ul li > h4 > a::before {
    width: 5px;
    height: 5px;
    flex-basis: 5px;

    margin-top: 7px;

    background: #94a3b8;
}


/* =========================================================
   10. 兼容 shortcode 输出的段落
   ========================================================= */

.links-related p {
    margin-top: 0;
    margin-bottom: 10px;

    color: var(--links-text-secondary);

    font-size: 14px;
    line-height: 1.75;
}

.links-related p:last-child {
    margin-bottom: 0;
}


/* =========================================================
   11. 兼容 shortcode 可能输出的标题
   ---------------------------------------------------------
   不干扰模块本身的直接子级 h2。
   ========================================================= */

.links-related li h3,
.links-related li h4,
.links-related li h5 {
    color: var(--links-text);

    font-size: 14px;
    font-weight: 650;
    line-height: 1.6;
}


/* =========================================================
   12. 兼容 shortcode 可能输出的图片
   ========================================================= */

.links-related img {
    display: block;

    max-width: 100%;
    height: auto;

    border-radius: 7px;
}

/* 图片与文字组合时 */
.links-related li a img {
    flex: 0 0 auto;

    max-width: 64px;
    max-height: 48px;

    margin-right: 10px;

    object-fit: cover;
}


/* =========================================================
   13. 平板适配
   ---------------------------------------------------------
   1024px 以下：
   缩小模块内边距和卡片间距。
   ========================================================= */

@media (max-width: 1024px) {

    .links-related {
        margin-top: 34px;
        margin-bottom: 34px;

        padding: 23px;
    }

    .links-related > h2 {
        font-size: 20px;
        margin-bottom: 18px;
    }

    .links-related > ul,
    .links-related > div > ul,
    .links-related > div > div > ul {
        gap: 10px;
    }

}


/* =========================================================
   14. 手机端适配
   ---------------------------------------------------------
   768px 以下：
   双列切换为单列，保证标题有足够阅读宽度。
   ========================================================= */

@media (max-width: 768px) {

    .links-related {
        margin-top: 28px;
        margin-bottom: 28px;

        padding: 20px 18px;

        border-radius: 11px;
    }

    .links-related > h2 {
        gap: 10px;

        margin-bottom: 16px;
        padding-bottom: 13px;

        font-size: 19px;
    }

    .links-related > h2::before {
        height: 19px;
    }

    .links-related > ul,
    .links-related > div > ul,
    .links-related > div > div > ul {
        grid-template-columns: minmax(0, 1fr);

        gap: 9px;
    }

    .links-related li > a,
    .links-related li > h2 > a,
    .links-related li > h3 > a,
    .links-related li > h4 > a,
    .links-related li > h5 > a,
    .links-related li > p > a {
        min-height: 46px;

        padding: 12px 14px;

        font-size: 14px;
    }

}


/* =========================================================
   15. 小屏手机适配
   ---------------------------------------------------------
   480px 以下：
   进一步收紧间距，防止内容显得拥挤。
   ========================================================= */

@media (max-width: 480px) {

    .links-related {
        margin-top: 24px;
        margin-bottom: 24px;

        padding: 17px 14px;

        border-radius: 10px;
    }

    .links-related > h2 {
        margin-bottom: 14px;

        font-size: 18px;
    }

    .links-related li > a,
    .links-related li > h2 > a,
    .links-related li > h3 > a,
    .links-related li > h4 > a,
    .links-related li > h5 > a,
    .links-related li > p > a {
        min-height: 44px;

        padding: 11px 12px;

        font-size: 13px;
        line-height: 1.7;
    }

    .links-related li > a::before,
    .links-related li > h2 > a::before,
    .links-related li > h3 > a::before,
    .links-related li > h4 > a::before,
    .links-related li > h5 > a::before,
    .links-related li > p > a::before {
        margin-right: 9px;
    }

}


/* =========================================================
   16. 极窄屏幕适配
   ---------------------------------------------------------
   360px 以下：
   保持内容完整，不强制固定宽度。
   ========================================================= */

@media (max-width: 360px) {

    .links-related {
        padding: 15px 11px;
    }

    .links-related > h2 {
        font-size: 17px;
    }

    .links-related li > a,
    .links-related li > h3 > a,
    .links-related li > h4 > a {
        padding: 10px;
        font-size: 13px;
    }

}


/* =========================================================
   17. 减少动态效果
   ---------------------------------------------------------
   尊重用户操作系统的减少动态效果设置。
   ========================================================= */

@media (prefers-reduced-motion: reduce) {

    .links-related *,
    .links-related *::before,
    .links-related *::after {

        scroll-behavior: auto !important;

        animation-duration: 0.01ms !important;
        animation-iteration-count: 1 !important;

        transition-duration: 0.01ms !important;
    }

}


/* =========================================================
   18. 高对比度模式
   ---------------------------------------------------------
   Windows 高对比度等环境下，
   确保链接仍然有明确边界。
   ========================================================= */

@media (forced-colors: active) {

    .links-related {
        border: 1px solid CanvasText;
    }

    .links-related li > a,
    .links-related li > h3 > a,
    .links-related li > h4 > a {
        color: LinkText;

        border: 1px solid LinkText;

        forced-color-adjust: auto;
    }

    .links-related a:focus-visible {
        outline: 3px solid Highlight;
    }

}


/* =========================================================
   19. 打印样式
   ---------------------------------------------------------
   打印时取消阴影和悬停装饰，
   保留链接文本的可读性。
   ========================================================= */

@media print {

    .links-related {
        margin: 20px 0;
        padding: 16px;

        background: #ffffff;

        border: 1px solid #999999;
        box-shadow: none;

        break-inside: avoid;
    }

    .links-related > h2 {
        color: #000000;
    }

    .links-related li > a,
    .links-related li > h3 > a,
    .links-related li > h4 > a {
        color: #000000;

        background: #ffffff;

        border: 1px solid #cccccc;

        box-shadow: none;

        transform: none;
    }

}
