Switch Web Component选中状态显示异常问题求助

问题根源 #

你的问题出在原生checkbox的checked DOM属性与JS属性的差异：原生checkbox的视觉状态由它的.checked JS属性决定，而DOM上的checked属性仅作为初始值存在——点击checkbox时，浏览器会自动切换.checked但不会修改DOM属性。你的syncChecked方法仅通过添加/移除DOM属性同步状态，这会导致组件属性与checkbox的实际JS状态逐渐不同步，最终出现按钮设置属性时视觉无变化的问题。

解决方案 #

修改组件逻辑，直接同步checkbox的.checked JS属性，并通过自定义元素的attributeChangedCallback监听属性变化，确保组件属性与内部状态完全同步：

<!DOCTYPE html>
<html>
<head>
    <title>Page Title</title>
</head>
<body>
    <custom-toggle checked="true"></custom-toggle>
    <button onclick="test()">Change State</button>
    <script>
        function test() {
            var toggle = document.querySelector('custom-toggle');
            toggle.checked = !toggle.checked;
        }
    </script>
    <script type="module">
    const template = document.createElement('template');
template.innerHTML = `
<style>
/* The switch - the box around the slider */
.switch {
  position: relative;
  display: inline-block;
  width: 60px;
  height: 34px;
}

/* Hide default HTML checkbox */
.switch input {
  opacity: 0;
  width: 0;
  height: 0;
}

/* The slider */
.slider {
  position: absolute;
  cursor: pointer;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  background-color: #ccc;
  -webkit-transition: .4s;
  transition: .4s;
}

.slider:before {
  position: absolute;
  content: "";
  height: 26px;
  width: 26px;
  left: 4px;
  bottom: 4px;
  background-color: white;
  -webkit-transition: .4s;
  transition: .4s;
}

input:checked + .slider {
  background-color: #2196F3;
}

input:focus + .slider {
  box-shadow: 0 0 1px #2196F3;
}

input:checked + .slider:before {
  -webkit-transform: translateX(26px);
  -ms-transform: translateX(26px);
  transform: translateX(26px);
}

/* Rounded sliders */
.slider.round {
  border-radius: 34px;
}

.slider.round:before {
  border-radius: 50%;
}
</style>
<label class="switch">
  <input type="checkbox">
  <span class="slider round"></span>
</label>
`

export class customToggle extends HTMLElement {
  #shadowRoot;
  #input;

  static get observedAttributes() {
    return ['checked'];
  }

  constructor() {
    super();
    this.#shadowRoot = this.attachShadow({ mode: 'closed' });
    this.#shadowRoot.appendChild(template.content.cloneNode(true));
    this.#input = this.#shadowRoot.querySelector('input');
  }

  get checked() {
    return this.hasAttribute('checked');
  }

  set checked(value) {
    Boolean(value) ? this.setAttribute('checked', '') : this.removeAttribute('checked');
  }

  connectedCallback() {
    this.#input.addEventListener("click", () => {
      this.checked = !this.checked;
    });
    // 初始化同步状态
    this.#input.checked = this.checked;
  }

  attributeChangedCallback(name, oldValue, newValue) {
    if (name === 'checked') {
      this.#input.checked = this.checked;
    }
  }
}

window.customElements.define('custom-toggle', customToggle);
</script>
</body>
</html>

关键修改点 #

• 简化checked getter：用hasAttribute('checked')判断状态，符合HTML布尔属性的规范（属性存在即代表true）
• 优化checked setter：直接添加/移除属性，逻辑更简洁
• 新增attributeChangedCallback：监听组件checked属性的变化，自动同步到内部checkbox的.checked属性，确保视觉状态与组件属性完全一致
• 移除冗余的syncChecked方法：通过属性回调和初始化同步实现状态管理，逻辑更清晰

内容的提问来源于stack exchange，提问作者user10419906