者：彭道寬

https://juejin.im/post/5e8d4300f265da47f85de3db

$('.btn').button()

$().button('toggle')

$().button('loading')

$().button('reset')

$().button(string)

一篇文章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作為它默認的事件。

某些其他元素也有默認事件。下面是個全部列表：

最終，在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：瀏覽器不支持復制或者弱網條件下，怎么辦？