Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface DOMTokenList

A set of space-separated tokens. Such a set is returned by Element.classList, HTMLLinkElement.relList, HTMLAnchorElement.relList, HTMLAreaElement.relList, HTMLIframeElement.sandbox, or HTMLOutputElement.htmlFor. It is indexed beginning with 0 as with JavaScript Array objects. DOMTokenList is always case-sensitive.

Hierarchy

  • DOMTokenList

Indexable

[index: number]: string

A set of space-separated tokens. Such a set is returned by Element.classList, HTMLLinkElement.relList, HTMLAnchorElement.relList, HTMLAreaElement.relList, HTMLIframeElement.sandbox, or HTMLOutputElement.htmlFor. It is indexed beginning with 0 as with JavaScript Array objects. DOMTokenList is always case-sensitive.

Index

Properties

Readonly length

length: number

Returns the number of tokens.

value

value: string

Returns the associated set as string.

Can be set, to change the associated attribute.

Methods

add

  • add(...tokens: string[]): void
  • Adds all arguments passed, except those already present.

    Throws a "SyntaxError" DOMException if one of the arguments is the empty string.

    Throws an "InvalidCharacterError" DOMException if one of the arguments contains any ASCII whitespace.

    Parameters

    • Rest ...tokens: string[]

    Returns void

contains

  • contains(token: string): boolean
  • Returns true if token is present, and false otherwise.

    Parameters

    • token: string

    Returns boolean

forEach

  • forEach(callbackfn: (value: string, key: number, parent: DOMTokenList) => void, thisArg?: any): void
  • Parameters

    • callbackfn: (value: string, key: number, parent: DOMTokenList) => void
        • Parameters

          Returns void

    • Optional thisArg: any

    Returns void

item

  • item(index: number): string | null
  • Returns the token with index index.

    Parameters

    • index: number

    Returns string | null

remove

  • remove(...tokens: string[]): void
  • Removes arguments passed, if they are present.

    Throws a "SyntaxError" DOMException if one of the arguments is the empty string.

    Throws an "InvalidCharacterError" DOMException if one of the arguments contains any ASCII whitespace.

    Parameters

    • Rest ...tokens: string[]

    Returns void

replace

  • replace(oldToken: string, newToken: string): void
  • Replaces token with newToken.

    Returns true if token was replaced with newToken, and false otherwise.

    Throws a "SyntaxError" DOMException if one of the arguments is the empty string.

    Throws an "InvalidCharacterError" DOMException if one of the arguments contains any ASCII whitespace.

    Parameters

    • oldToken: string
    • newToken: string

    Returns void

supports

  • supports(token: string): boolean
  • Returns true if token is in the associated attribute's supported tokens. Returns false otherwise.

    Throws a TypeError if the associated attribute has no supported tokens defined.

    Parameters

    • token: string

    Returns boolean

toString

  • toString(): string
  • Returns string

toggle

  • toggle(token: string, force?: boolean): boolean
  • If force is not given, "toggles" token, removing it if it's present and adding it if it's not present. If force is true, adds token (same as add()). If force is false, removes token (same as remove()).

    Returns true if token is now present, and false otherwise.

    Throws a "SyntaxError" DOMException if token is empty.

    Throws an "InvalidCharacterError" DOMException if token contains any spaces.

    Parameters

    • token: string
    • Optional force: boolean

    Returns boolean

Generated using TypeDoc