diff --git a/docs-en/javascripts/examples.js b/docs-en/javascripts/examples.js new file mode 100644 index 0000000000000..0de558abfb51d --- /dev/null +++ b/docs-en/javascripts/examples.js @@ -0,0 +1,89 @@ +/* Copy button on each problem example block. */ +(function (root) { + function uiText(doc) { + var lang = ((doc.documentElement && doc.documentElement.lang) || "").toLowerCase(); + if (lang.indexOf("zh") === 0) return { copy: "复制", copied: "已复制" }; + return { copy: "Copy", copied: "Copied" }; + } + + function blockText(block) { + var clone = block.cloneNode(true); + var button = clone.querySelector(".lc-example__copy"); + if (button) button.remove(); + var text = clone.innerText || clone.textContent || ""; + return text.replace(/\n+$/g, "").trim(); + } + + function copyIcon() { + return ''; + } + + function checkIcon() { + return ''; + } + + function copyText(text) { + if (navigator.clipboard && navigator.clipboard.writeText) { + return navigator.clipboard.writeText(text).then( + function () { + return true; + }, + function () { + return false; + } + ); + } + return Promise.resolve(false); + } + + function enhance(doc) { + var article = doc.querySelector("article.md-content__inner"); + if (!article || article.dataset.lcExamples) return; + var nodes = article.querySelectorAll(":scope > pre, .example-block"); + if (!nodes.length) return; + article.dataset.lcExamples = "1"; + var text = uiText(doc); + for (var i = 0; i < nodes.length; i++) { + var block = nodes[i]; + if (block.closest && block.closest(".lc-example")) continue; + var host = doc.createElement("div"); + host.className = "lc-example"; + block.parentNode.insertBefore(host, block); + host.appendChild(block); + var button = doc.createElement("button"); + button.type = "button"; + button.className = "lc-example__copy"; + button.setAttribute("aria-label", text.copy); + button.innerHTML = copyIcon(); + (function (target, btn) { + btn.addEventListener("click", function () { + copyText(blockText(target)).then(function (ok) { + if (!ok) return; + btn.classList.add("is-copied"); + btn.setAttribute("aria-label", text.copied); + btn.innerHTML = checkIcon(); + setTimeout(function () { + btn.classList.remove("is-copied"); + btn.setAttribute("aria-label", text.copy); + btn.innerHTML = copyIcon(); + }, 1200); + }); + }); + })(block, button); + host.appendChild(button); + } + } + + function boot() { + enhance(document); + } + + if (document.readyState === "loading") { + document.addEventListener("DOMContentLoaded", boot); + } else { + boot(); + } + if (root.document$ && root.document$.subscribe) { + root.document$.subscribe(boot); + } +})(typeof globalThis !== "undefined" ? globalThis : this); diff --git a/docs-en/stylesheets/extra.css b/docs-en/stylesheets/extra.css index c3f853e7a6c20..b9a81c82da208 100644 --- a/docs-en/stylesheets/extra.css +++ b/docs-en/stylesheets/extra.css @@ -36,6 +36,51 @@ background-color: var(--pre-bg); border-radius: .1rem; } +.md-typeset .lc-example { + position: relative; +} +.md-typeset .lc-example > pre { + margin: 0; + overflow-x: auto; + padding: .3em; + background-color: var(--pre-bg); + border-radius: .1rem; +} +.md-typeset .lc-example__copy { + position: absolute; + top: .35em; + right: .35em; + z-index: 1; + display: inline-flex; + align-items: center; + justify-content: center; + width: 1.5rem; + height: 1.5rem; + padding: 0; + border: 0; + border-radius: .1rem; + background: var(--example-block-bg); + color: var(--md-default-fg-color--light); + cursor: pointer; + opacity: 0; + pointer-events: none; + transition: color .25s, opacity .25s; +} +.md-typeset .lc-example:hover > .lc-example__copy, +.md-typeset .lc-example__copy:focus, +.md-typeset .lc-example__copy.is-copied { + opacity: 1; + pointer-events: auto; +} +.md-typeset .lc-example__copy:hover, +.md-typeset .lc-example__copy.is-copied { + color: var(--md-accent-fg-color); +} +.md-typeset .lc-example__copy svg { + width: 1.05rem; + height: 1.05rem; + fill: currentColor; +} .md-typeset .admonition.thinking, .md-typeset details.thinking { diff --git a/docs/javascripts/examples.js b/docs/javascripts/examples.js new file mode 100644 index 0000000000000..0de558abfb51d --- /dev/null +++ b/docs/javascripts/examples.js @@ -0,0 +1,89 @@ +/* Copy button on each problem example block. */ +(function (root) { + function uiText(doc) { + var lang = ((doc.documentElement && doc.documentElement.lang) || "").toLowerCase(); + if (lang.indexOf("zh") === 0) return { copy: "复制", copied: "已复制" }; + return { copy: "Copy", copied: "Copied" }; + } + + function blockText(block) { + var clone = block.cloneNode(true); + var button = clone.querySelector(".lc-example__copy"); + if (button) button.remove(); + var text = clone.innerText || clone.textContent || ""; + return text.replace(/\n+$/g, "").trim(); + } + + function copyIcon() { + return ''; + } + + function checkIcon() { + return ''; + } + + function copyText(text) { + if (navigator.clipboard && navigator.clipboard.writeText) { + return navigator.clipboard.writeText(text).then( + function () { + return true; + }, + function () { + return false; + } + ); + } + return Promise.resolve(false); + } + + function enhance(doc) { + var article = doc.querySelector("article.md-content__inner"); + if (!article || article.dataset.lcExamples) return; + var nodes = article.querySelectorAll(":scope > pre, .example-block"); + if (!nodes.length) return; + article.dataset.lcExamples = "1"; + var text = uiText(doc); + for (var i = 0; i < nodes.length; i++) { + var block = nodes[i]; + if (block.closest && block.closest(".lc-example")) continue; + var host = doc.createElement("div"); + host.className = "lc-example"; + block.parentNode.insertBefore(host, block); + host.appendChild(block); + var button = doc.createElement("button"); + button.type = "button"; + button.className = "lc-example__copy"; + button.setAttribute("aria-label", text.copy); + button.innerHTML = copyIcon(); + (function (target, btn) { + btn.addEventListener("click", function () { + copyText(blockText(target)).then(function (ok) { + if (!ok) return; + btn.classList.add("is-copied"); + btn.setAttribute("aria-label", text.copied); + btn.innerHTML = checkIcon(); + setTimeout(function () { + btn.classList.remove("is-copied"); + btn.setAttribute("aria-label", text.copy); + btn.innerHTML = copyIcon(); + }, 1200); + }); + }); + })(block, button); + host.appendChild(button); + } + } + + function boot() { + enhance(document); + } + + if (document.readyState === "loading") { + document.addEventListener("DOMContentLoaded", boot); + } else { + boot(); + } + if (root.document$ && root.document$.subscribe) { + root.document$.subscribe(boot); + } +})(typeof globalThis !== "undefined" ? globalThis : this); diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css index c3f853e7a6c20..b9a81c82da208 100644 --- a/docs/stylesheets/extra.css +++ b/docs/stylesheets/extra.css @@ -36,6 +36,51 @@ background-color: var(--pre-bg); border-radius: .1rem; } +.md-typeset .lc-example { + position: relative; +} +.md-typeset .lc-example > pre { + margin: 0; + overflow-x: auto; + padding: .3em; + background-color: var(--pre-bg); + border-radius: .1rem; +} +.md-typeset .lc-example__copy { + position: absolute; + top: .35em; + right: .35em; + z-index: 1; + display: inline-flex; + align-items: center; + justify-content: center; + width: 1.5rem; + height: 1.5rem; + padding: 0; + border: 0; + border-radius: .1rem; + background: var(--example-block-bg); + color: var(--md-default-fg-color--light); + cursor: pointer; + opacity: 0; + pointer-events: none; + transition: color .25s, opacity .25s; +} +.md-typeset .lc-example:hover > .lc-example__copy, +.md-typeset .lc-example__copy:focus, +.md-typeset .lc-example__copy.is-copied { + opacity: 1; + pointer-events: auto; +} +.md-typeset .lc-example__copy:hover, +.md-typeset .lc-example__copy.is-copied { + color: var(--md-accent-fg-color); +} +.md-typeset .lc-example__copy svg { + width: 1.05rem; + height: 1.05rem; + fill: currentColor; +} .md-typeset .admonition.thinking, .md-typeset details.thinking { diff --git a/mkdocs.yml b/mkdocs.yml index f579ebaaf15e5..d6d155f72651b 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -126,6 +126,7 @@ markdown_extensions: extra_javascript: + - javascripts/examples.js - javascripts/mathjax.js - https://cdn-doocs.oss-cn-shenzhen.aliyuncs.com/npm/mathjax@3/es5/tex-mml-chtml.js