Warning: error_log(/data/www/wwwroot/hmttv.cn/caches/error_log.php): failed to open stream: Permission denied in /data/www/wwwroot/hmttv.cn/phpcms/libs/functions/global.func.php on line 537 Warning: error_log(/data/www/wwwroot/hmttv.cn/caches/error_log.php): failed to open stream: Permission denied in /data/www/wwwroot/hmttv.cn/phpcms/libs/functions/global.func.php on line 537
一篇文章Stimulus:連接HTML和JavaScript的橋梁,實現簡單的controller,并學習了Stimulus是如何連接HTML與JavaScript的。現在我們使用Stimulus來實現復制文本到粘貼板的按鈕。
比如說,我們現在有一個需求,就是幫助用戶生成密碼,在密碼旁邊放置一個按鈕,點擊按鈕后密碼就被拷貝到粘貼板上了,這樣就方便用戶使用這個密碼了。
打開public/index.html,修改body內容,填充一個簡單的按鈕,如下:
<div>
PIN: <input type="text" value="1234" readonly>
<button>Copy to Clipboard</button>
</div>
下一步,創建src/controllers/clipboard_controller.js,然后添加一個copy()方法:
import { Controller } from "@hotwired/stimulus"
export default class extends Controller {
copy() {
}
}
然后,給div添加data-controller=“clipboard”。只要是給元素添加了data-controller屬性,Stimulus就會連接一個controller實例。
<div data-controller="clipboard">
我們還需要一個對輸入框的引用,這樣我們就可以在調用粘貼板API之前獲取輸入框的內容。給文本框添加data-clipboard-target=“source“:
PIN: <input data-clipboard-target="source" type="text" value="1234" readonly>
在controller中定義一個target,然后就可以通過this.sourceTarget訪問文本框了。
import { Controller } from "@hotwired/stimulus"
export default class extends Controller {
static targets = [ "source" ]
copy() {
}
}
解釋一下這個targets:
當Stimulus加載你的controller類時,它會查看靜態數組targets的字符串元素,對于每一個字符串,Stimulus會在controller中添加3個屬性。在這里,對于“source”,會添加如下屬性:
this.sourceTarget 在controller的域內的第一個source
this.sourceTargets 在controller的域內所有的source組成的一個數組
this.hasSourceTarget 在controller的域內是否有source
我們希望點擊按鈕時調用controller中的copy()方法,所以我們需要添加data-action=“clipboard#copy“
<button data-action="clipboard#copy">Copy to Clipboard</button>
你可以已經注意到在上面的動作描述符中省略了click->。那是因為Stimulus給button設置了click作為它默認的事件。
某些其他元素也有默認事件。下面是個全部列表:
元素 | 默認事件 |
a | click |
button | click |
details | toggle |
form | submit |
input | input |
input type=“submit” | click |
select | change |
textarea | input |
最終,在copy()方法中,我們獲取輸入框的內容,調用粘貼板API
copy() {
navigator.clipboard.writeText(this.sourceTarget.value)
}
刷新頁面,點擊按鈕,然后快捷鍵粘貼到Greet按鈕前到輸入框,可以看到1234。
到目前為止,在頁面上同一時間只有一個controller實例。在頁面上同時有一個controller的多個實例也是很正常的。
我們的controller是可以復用的,只要你需要在頁面上添加復制內容的按鈕,無論是哪個頁面,只要把對應的屬性值寫好,我們的controller都是生效的。
還是上面的例子,再添加另外一個復制按鈕:
<div data-controller="clipboard">
PIN: <input data-clipboard-target="source" type="text" value="3737" readonly>
<button data-action="clipboard#copy" class="clipboard-button">Copy to Clipboard</button>
</div>
刷新頁面,驗證一下兩個復制按鈕是否都生效。
我們再添加一個可以復制的元素,不用button,我們用a標簽,
<div data-controller="clipboard">
PIN: <input data-clipboard-target="source" type="text" value="6666" readonly>
<a href="#" data-action="clipboard#copy" class="clipboard-button">Copy to Clipboard</a>
</div>
Stimulus允許我們使用任何元素,只要它設置了合適的data-action屬性,就可以觸發復制。
這個例子里,要注意一點,點擊鏈接會使瀏覽器追蹤a標簽內的href屬性跳轉,可以取消這種默認行為,只需要在action中調用 event.preventDefault()就可以了。
copy(event) {
event.preventDefault()
navigator.clipboard.writeText(this.sourceTarget.value)
}
還有另外一個方法,拷貝粘貼板上
copy(event) {
event.preventDefault()
this.sourceTarget.select()
document.execCommand("copy")
}
在本文中,我們看了一個在現實中把瀏覽器API包裝在Stimulus的controller中的例子。還有一個controller的多個實例如何同時出現在頁面上,我們還探索了actions和targets如何保持HTML和JavaScript的松散耦合。
下一篇文章,我們將優化一下這個復制粘貼板的功能,讓它運行起來更加健壯。
Stimulus:瀏覽器不支持復制或者弱網條件下,怎么辦?
鈕(button)可能是網頁中最常見的組件之一了,大部分都平淡無奇,如果你碰到的是一個這樣的按鈕,會不會忍不住多點幾次呢?
轉載鏈接: https://github.com/XboxYan/notes/issues/16
通常這類效果第一反應可能就是借助canvas了,比如下面這個案例點擊預覽(建議去codepen原鏈接點擊預覽訪問,segmentfault內置的預覽js會加載失敗)
效果就更加震撼了,當然canvas實現也有一定的門檻,而且實際使用起來也略微麻煩(所有js實現的通病),這里嘗試一下CSS的實現方式。
拋開js方案,還有HTML和CSS實現方式。HTML就不用說了,直接寫上大量的標簽
<button>
button
<i></i>
<i></i>
<i></i>
<i></i>
<i></i>
...
</button>
一般情況下我不是很喜歡這種方式,標簽太多,結構不美觀,而且有可能對現有的頁面造成其他影響(很多情況下并不方便修改原始HTML結構)
那么來看看CSS實現方式,主要也是兩種方式,其實就是想一下有哪些屬性可以無限疊加,一個是box-shadow,還有一個是background-image(CSS3支持無限疊加)。
我們先看看box-shadow方式,為了避免使用額外標簽,這里采用偽元素生成。
.button::before{
position: absolute;
content: '';
width: 5px;
height: 5px;
border-radius: 50%;
background-color: #ff0081;
box-shadow: 10px 10px #ff0081,15px 0px 0 2px #ff0081,20px 15px 0 3px #ff0081,...;/*無限疊加*/
}
效果還是有的,主要就是多花點時間來調試,這里主要根據偏移量和擴展來決定粒子的位置和大小。
不過這里的偏移量只能是px單位,無法很好的自適應按鈕的大小,所以這里采用第二種方式來實現
CSS3中background-image是可以無限疊加的,類似于
.myclass {
background: background1, background2, /*...*/ backgroundN;
}
這里我們可以采用徑向漸變radial-gradient來實現多個小圓點。
.button::before{
position: absolute;
content: '';
left: -2em;
right: -2em;
top: -2em;
bottom: -2em;
pointer-events: none;
background-repeat: no-repeat;
background-image: radial-gradient(circle, #ff0081 20%, transparent 0),
radial-gradient(circle, #ff0081 20%, transparent 0),
radial-gradient(circle, #ff0081 20%, transparent 0),
radial-gradient(circle, #ff0081 20%, transparent 0),
...;
background-size: 10% 10%, 20% 20%, 15% 15%,...;
background-position: 18% 40%, 20% 31%, 30% 30%,...;
}
這里主要通過background-size和background-position來控制原點的尺寸與位置,看著好像挺復雜,其實只要background-size和background-position與background-image位置一一對應就行了。實際開發中可能有點難調試,可以直接在控制臺中通過鍵盤上下左右鍵微調實時預覽效果(可以考慮做一個可視化工具)。
這樣就做出了一個簡單的粒子效果。
雖然background-image不支持CSS動畫,但是另外兩個background-size和background-position支持呀,所以,CSS transition和CSS animation都可以用起來。
動畫效果很簡單,就是粒子從中心往外擴散,并且逐漸消失的過程。
我們先看看:hover交互
.button::before{
transition:.75s background-position ease-in-out,75s background-size ease-in-out;
}
.button:hover::before{
background-position: 5% 44%, -5% 20%, 7% 5%...;
background-size: 0% 0%;
}
當然直接這樣設置肯定是不理想,鼠標離開時會收縮回去,效果如下
我們需要是鼠標離開時不收縮回去,如何實現呢?
很簡單,把transition設置在:hover下就可以了,表示只有當鼠標經過時才有過渡,離開時沒有
.button:hover::before{
background-position: 5% 44%, -5% 20%, 7% 5%...;
background-size: 0% 0%;
transition:.75s background-position ease-in-out,75s background-size ease-in-out;
}
這樣是不是感覺稍微好些了呢?點擊這里點擊預覽查看。
如果我們想做成點擊的時候出現粒子動畫該怎么做呢?這里就需要借助:active偽類了。
如果我們按照:hover邏輯,那么
.button:active::before{
background-position: 5% 44%, -5% 20%, 7% 5%...;
background-size: 0% 0%;
transition:.75s background-position ease-in-out,75s background-size ease-in-out;
}
很遺憾,只有當只有按住不動的時候才能觸發,一旦鼠標抬起就沒有了,這個時候我們就需要換個角度了。可以這么想象一下,默認就是發散的,然后點擊的時候聚攏,抬起的時候就會有還原成之前的發散狀態,同時,在點擊的時候需要取消掉過渡效果,如下
.button::before {
/*...*/
background-position: 5% 44%...;/*擴散的狀態*/
background-size: 0% 0%;
transition: background-position .5s ease-in-out, background-size .75s ease-in-out;
}
.button:active::before {
transition:0s;/**注意取消掉過渡**/
background-size: 10% 10%, 20% 20%...;
background-position: 18% 40%, 20% 31%,...;
}
你可以查看這個demo點擊預覽
為什么在:active需要transition:0s呢,你可以試下不添加的效果就明白了,如下
animation和transition實現原理比較類似,優點是可以做出更加精細的動畫,這里就拿:active方式來說吧。
.button::before{
/*...*/
animation: bubbles ease-in-out .75s forwards;
}
.button:active::before {
animation: none; /*這里注意取消動畫*/
background-size: 0;
}
@keyframes bubbles {
0% {
background-position: 18% 40%, ...;
}
50% {
background-position: 10% 44%, ...;
}
100% {
background-position: 5% 44%, ...;
background-size: 0% 0%;
}
}
可以在這里點擊預覽查看源碼。
唯一的不足可能是初始化動畫會自執行一次。
上面介紹了純CSS實現一個粒子動效的按鈕,優點很明顯,復制一下CSS直接扔到項目里就能用,管他什么原生項目還是react項目,也無需綁定什么事件,也無需額外的邏輯處理,增強現有體驗。試想一下,如果這是一個‘購買’按鈕,會不會觸發你多購買幾次呢,反正我肯定是會被吸引住了,哈~缺點也還是有的,比如上面的定位,密密麻麻都是工作量啊,建議這些功能在項目整體完成之后再細細打磨,也可以試著做一些可視化工具來減輕工作量,完。
clipboard.js是一款不依賴flash或任何重量級框架的粘貼復制插件,并且它沒有任何非常復雜的配置,這也是它存在的原因。
npm install clipboard --save
2.引入js
<script src="dist/clipboard.min.js"></script>
//官網提供了下載地址,也可以使用免費的cdn
示例
<!DOCTYPE html> <html class="no-js"> <head> <meta charset="utf-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <title></title> <meta name="description" content="" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <link rel="stylesheet" /> </head> <body> <div class="input-group" style="width: 600px;margin:200px"> <input type="text" class="form-control" id="foo" value="https://github.com/zenorocha/clipboard.js.git" placeholder="Amount" /> <div class="btn input-group-addon" data-clipboard-target="#foo">復制</div> </div> <script src="https://cdn.jsdelivr.net/npm/clipboard@2/dist/clipboard.min.js"></script> <script> new ClipboardJS(".btn"); </script> </body> </html>
如圖書最簡單的例子,單機復制按鈕即可自動復制文本框的內容
換成下面就會變成剪切,主要是以下屬性
data-clipboard-action="cut"
<div class="input-group" style="width: 600px;margin:200px"> <input type="text" class="form-control" id="foo" value="https://github.com/zenorocha/clipboard.js.git" placeholder="Amount" /> <div class="btn input-group-addon" data-clipboard-target="#foo" data-clipboard-action="cut">剪切</div> </div> <script src="https://cdn.jsdelivr.net/npm/clipboard@2/dist/clipboard.min.js"></script> <script> new ClipboardJS(".btn"); </script>
剪切操作僅適用于<input>或<textarea>元素
或者這樣,直接復制 data-clipboard-text屬性的內容
<button class="btn" data-clipboard-text="要復制的內容"> 復制 </button>
var clipboard = new ClipboardJS('.btn'); clipboard.on('success', function(e) { console.info('Action:', e.action); console.info('Text:', e.text); console.info('Trigger:', e.trigger); e.clearSelection(); }); clipboard.on('error', function(e) { console.error('Action:', e.action); console.error('Trigger:', e.trigger); });
new ClipboardJS('.btn', { target: function(trigger) { return trigger.nextElementSibling; } });
new ClipboardJS('.btn', { text: function(trigger) { return trigger.getAttribute('aria-label'); } });
new ClipboardJS('.btn', { container: document.getElementById('modal') });
var clipboard = new ClipboardJS('.btn'); clipboard.destroy();
如果需要支持更低版本的瀏覽器,可以參考官網的介紹,它能夠優雅的降級
一個瀏覽器擴展,為GitHub,MDN,Gist,StackOverflow,StackExchange,npm甚至Medium中的每個代碼塊添加“復制到剪貼板”按鈕。需要的可以私信或者前往擴展中心自行下載。
*請認真填寫需求信息,我們會在24小時內與您取得聯系。