Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DataTransfer.setData() — ukládání textových dat

DataTransfer.setData() ukládá text v určeném formátu do úložiště dat pro přetahování a nahrazuje předchozí hodnotu tohoto formátu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

dataTransfer.setData(format, data)

DataTransfer.setData(format, data) ukládá text, nikoli soubor. format je obvykle typ MIME; data je řetězec. Metoda vrací undefined.

Formáty se převádějí na malá písmena ASCII; text znamená text/plain a url znamená text/uri-list. Opakovaný zápis nahrazuje text stejného formátu.

Zápis vyžaduje režim čtení/zápisu: během přetahování použijte dragstart, nikoli drop. Bez tohoto režimu nebo přidruženého úložiště se nic nezmění. new DataTransfer() vytvoří zapisovatelné úložiště. Jde o API prohlížeče, nikoli o funkci ECMAScriptu.

Příklady

const transfer = new DataTransfer();
transfer.setData("TEXT", "first");
transfer.setData("text/plain", "second");
console.log(transfer.getData("text/plain"));

Výsledek

second

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje