CSS Container Queries终于能用了

最近在做项目的时候遇到这个问题，查了不少资料总算搞明白了。把过程记下来，方便以后查阅，也希望能帮到有同样需求的朋友。

先搞清楚原理

Container Queries的基本概念其实不复杂。关键在于理解样式隔离这个环节。看下面这段代码，逻辑就很清楚了：

class EventBus {
  constructor() { this.events = new Map(); }
  on(event, callback) {
    if (!this.events.has(event)) this.events.set(event, []);
    this.events.get(event).push(callback);
    return () => this.off(event, callback);
  }
  off(event, callback) {
    const callbacks = this.events.get(event);
    if (callbacks) this.events.set(event, callbacks.filter(cb => cb !== callback));
  }
  emit(event, ...args) {
    const callbacks = this.events.get(event);
    if (callbacks) callbacks.forEach(cb => cb(...args));
  }
}

const bus = new EventBus();
bus.on('data', (d) => console.log('收到:', d));
bus.emit('data', { id: 21 });

实际怎么用

在真实项目中用Container Queries，和教程里还是有区别的。主要是样式隔离这块需要额外处理。完整代码如下：

class StorageManager {
  #storage = window.localStorage;
  #prefix = 'app_28';

  get(key, defaultValue = null) {
    const raw = this.#storage.getItem(`${this.#prefix}:${key}`);
    if (raw === null) return defaultValue;
    try { return JSON.parse(raw); } catch { return raw; }
  }

  set(key, value) {
    this.#storage.setItem(`${this.#prefix}:${key}`, JSON.stringify(value));
  }

  remove(key) { this.#storage.removeItem(`${this.#prefix}:${key}`); }

  clear() {
    Object.keys(this.#storage)
      .filter(k => k.startsWith(`${this.#prefix}:`))
      .forEach(k => this.#storage.removeItem(k));
  }
}

进阶一点的用法

如果对性能有要求，Container Queries可以做样式隔离方面的优化。核心改动不大，但效果明显：

容易踩的坑

用Container Queries的时候有几个常见的错误写法。比如样式隔离没有正确处理，或者组件状态管理的顺序搞反了。下面列出几个典型问题和修复方式。

写在最后

整体来看，Container Queries用起来不算复杂，关键是理解组件状态管理这个核心机制。建议先跑通基础示例，再逐步加功能。有问题可以看官方文档，社区也比较活跃。