====== clipboardutils Plugin ======

---- plugin ----
description: Copy text to clipboard by icon, text, ...
author     : jeanmarcb 
email      : jean-marc@boulade.com 
type       : syntax
lastupdate : 2021-09-09
compatible : 
depends    : 
conflicts  : 
similar    : clippy, copy2clipboard, copycode, codeclipboard
tags       : clipboard, code, copy, paste

downloadurl: https://github.com/jeanmarcb/dokuwiki-plugin-clipboardutils/archive/refs/tags/v210909.zip
bugtracker : https://github.com/jeanmarcb/dokuwiki-plugin-clipboardutils/issues
sourcerepo : https://github.com/jeanmarcb/dokuwiki-plugin-clipboardutils/
donationurl: 

screenshot_img : 
----

===== Installation =====

Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

Text with icon (click the icon copy the text in clipboard):

  <clipb type=ti>Value copied in clipboard</clipb>
  <clipb type=texticon>Value copied in clipboard</clipb>
  <clipb f=t,i>Value copied in clipboard</clipb>

%%{{:dev:clipboardutils:screenshot1.png?200|}}%% FIXME

Some more complex boxes
<code>
An email address clickable: <clipb type=clic>an-email-address@ggmail.com</clipb>\\
Several lines copied by icon: <clipb t=i>a simple text
on several lines
just to try</clipb>\\
An icon, the text, an icon, all clickable: <clipb f=i,c,i>Copier cela dans le presse-papier</clipb>\\
</code>
%%{{:dev:clipboardutils:screenshot2.png?500|}}%% FIXME

===== Syntax =====

Basic syntax:
<code><clibp parameters>Text to copy in clipboard</clipb></code>
  * **parameters** can be can be a sequence of key value pairs separated by spaces or semicolons '';''
  * The keys are separated from the values either by '':'' or by ''=''
  * **The keys**  
    * //type|t// --- Type of value to display:
      * //text|t// --- just the text (normally used in compound types)
      * //icon|i// --- a icon clickable
      * //clic|c// --- the text clicable (to copy the text in clipboard)
    * //format|f// --- a list of 'type' separated by comma '','' (ex: ''format=t,i'' or ''f=clic,icon'').