From f935f08fa2e4be5465eb8c7398888bf96136e54b Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Sun, 18 Apr 2021 10:45:46 +0900 Subject: Web/API/DOMTokenList/toggle を新規翻訳 (#433) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 2021/02/20 の英語版に基づき新規翻訳 --- files/ja/web/api/domtokenlist/toggle/index.html | 84 +++++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 files/ja/web/api/domtokenlist/toggle/index.html (limited to 'files/ja/web/api') diff --git a/files/ja/web/api/domtokenlist/toggle/index.html b/files/ja/web/api/domtokenlist/toggle/index.html new file mode 100644 index 0000000000..eefeaa9861 --- /dev/null +++ b/files/ja/web/api/domtokenlist/toggle/index.html @@ -0,0 +1,84 @@ +--- +title: DOMTokenList.toggle() +slug: Web/API/DOMTokenList/toggle +tags: +- API +- DOM +- DOMTokenList +- Method +- Reference +- toggle +translation_of: Web/API/DOMTokenList/toggle +--- +

{{APIRef("DOM")}}

+ +

toggle() は {{domxref("DOMTokenList")}} インターフェイスのメソッドで、渡された token をリストから削除し、 false を返します。 token が存在しなかった場合は、追加して true を返します。

+ +

構文

+ +
tokenList.toggle(token [, force]);
+ +

引数

+ +
+
token
+
{{domxref("DOMString")}} で、存在をトグル切り替えしたいトークンを表します。
+
force {{optional_inline}}
+
{{jsxref("Boolean")}} で、存在する場合は、片方の操作のみを行います。 false に設定すると、 token を削除するだけとなり、追加は行いません。 true に設定すると、 token を追加するだけとなり、削除は行いません。
+
+ +

返値

+ +

{{jsxref("Boolean")}} で、呼び出し後に token がリストに存在するかどうかを示します。

+ +

+ +

以下の例では、 {{htmlelement("span")}} 要素に設定されたクラスのリストを DOMTokenList として受け取るのに {{domxref("Element.classList")}} を使用しています。それからリスト内のトークンを置き換え、リストを <span> の {{domxref("Node.textContent")}} に書き込みます。

+ +

最初に HTML です。

+ +
<span class="a b">classList is 'a b'</span>
+ +

そして JavaScript です。

+ +
let span = document.querySelector("span");
+let classes = span.classList;
+
+span.addEventListener('click', function() {
+  let result = classes.toggle("c");
+
+  if (result) {
+    span.textContent = `'c' added; classList is now "${classes}".`;
+  } else {
+    span.textContent = `'c' removed; classList is now "${classes}".`;
+  }
+})
+
+ +

出力結果は以下のようになります。

+ +

{{ EmbedLiveSample('Examples', '100%', 60) }}

+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('DOM WHATWG','#dom-domtokenlist-toggle','toggle()')}}{{Spec2('DOM WHATWG')}}初回定義
+ +

ブラウザーの互換性

+ +

{{Compat("api.DOMTokenList.toggle")}}

-- cgit v1.2.3-54-g00ecf