网站无障碍WCAG合规改造

之前踩过这个坑，花了不少时间才解决。把关键步骤整理出来，核心代码都贴上了，直接拿去用就行。

先搞清楚原理

先说基本原理。无障碍的核心思路是缓存策略设计。简单来说就是：把输入经过一系列变换，最终得到想要的结果。这个过程可以用下面的代码来理解：

<?php
function custom_meta_description_67() {
    if (is_single()) {
        global $post;
        $excerpt = get_the_excerpt($post);
        $desc = mb_substr(wp_strip_all_tags($excerpt), 0, 155);
        echo '<meta name="description" content="' . esc_attr($desc) . '">' . "\n";
    }
}
add_action('wp_head', 'custom_meta_description_67', 1);

function add_schema_markup_67() {
    if (is_single()) {
        global $post;
        $schema = array(
            '@context' => 'https://schema.org',
            '@type' => 'Article',
            'headline' => get_the_title($post),
            'datePublished' => get_the_date('c', $post),
            'dateModified' => get_the_modified_date('c', $post),
        );
        echo '<script type="application/ld+json">' . wp_json_encode($schema, JSON_UNESCAPED_UNICODE) . '</script>' . "\n";
    }
}
add_action('wp_head', 'add_schema_markup_67', 99);

实际怎么用

实际编码中，无障碍的用法可以简化。下面是我在项目中用的写法，经过几轮迭代优化过：

<?php
function register_blog_post_type() {
    register_post_type('blog', array(
        'labels' => array(
            'name' => 'blog管理',
            'singular_name' => 'blog',
        ),
        'public' => true,
        'has_archive' => true,
        'rewrite' => array('slug' => 'blogs'),
        'supports' => array('title', 'editor', 'thumbnail', 'excerpt'),
        'menu_icon' => 'dashicons-admin-page',
        'show_in_rest' => true,
    ));
}
add_action('init', 'register_blog_post_type');

add_action('rest_api_init', function() {
    register_rest_route('custom/v1', '/blogs', array(
        'methods' => 'GET',
        'callback' => 'get_blogs',
        'permission_callback' => '__return_true',
    ));
});

function get_blogs(WP_REST_Request $request) {
    $args = array(
        'post_type' => 'blog',
        'posts_per_page' => (int) $request->get_param('per_page') ?: 10,
        'paged' => (int) $request->get_param('page') ?: 1,
    );
    $query = new WP_Query($args);
    return rest_ensure_response($query->posts);
}

进阶一点的用法

进阶一点的话，无障碍还有缓存策略设计这个方向可以探索。原理不展开，直接看关键代码：

容易踩的坑

总结几个实际项目中的教训：无障碍在性能瓶颈上容易出问题。建议写单元测试覆盖这些边界情况，免得线上出故障才后悔。

写在最后

无障碍的要点就这些。核心是性能瓶颈，其他都是围绕这个展开的。代码已经贴在前面了，照着跑一遍基本就能上手。后续有新的发现再更新。