Document#
Document.characterSet#
Właściwość characterSet
zwraca nazwę z kodowania stosowanego w danym dokumencie. Właściwość jest tylko do odczytu.
Z uwagi na kompatybilność wsteczną specyfikacja DOM4 definiuje dla właściwość characterSet
dwa dodatkowe aliasy w formie właściwości Document.charset
lub Document.inputEncoding
, ale ich stosowanie w aktualnym kodzie produkcyjnym jest zbędne i odradzane.
Opis działania#
Samo wywołanie i poszczególne jego części najlepiej objaśnić na zapisie składniowym:
var encoding = document.characterSet;
gdzie poszczególne człony oznaczają:
- encoding - łańcuch znakowy reprezentujący nazwę z kodowania stosowanego w dokumencie.
- document - dokument będący obiektem kontekstu.
Więcej szczegółów związanych z kodowaniami umieściłem w zbiorczym dziale "Podstawy - Kodowanie".
Prosty przykład:
<!DOCTYPE html>
<html>
<script>
function getInfoDoc(desc, whatDoc){
doc.write(desc + "<br>");
doc.write("Interfejs: " + whatDoc + "<br>");
doc.write("characterSet: " + whatDoc.characterSet + "<br>");
doc.write("charset: " + whatDoc.charset + "<br>");
doc.write("inputEncoding: " + whatDoc.inputEncoding + "<br><br>");
}
var doc = document; // domyślny dokument tworzony przez parser HTML
getInfoDoc("Parametry dla domyślnego dokumentu tworzonego przez parser HTML (właściwość document):", doc);
var newDocXML = doc.implementation.createDocument(null, null, null); // nowy dokument XML
getInfoDoc("Parametry dla createDocument(null, null, null):", newDocXML);
var newDocHTML = doc.implementation.createHTMLDocument(""); // nowy dokument HTML
getInfoDoc("Parametry dla createHTMLDocument(''):", newDocHTML);
</script>
</html>
Właściwość characterSet
pojawia się dopiero w specyfikacji DOM4.
Składnia Web IDL#
interface Document : Node { readonly attribute DOMString characterSet; };
Specyfikacje i inne materiały#
Pasek społecznościowy