preact
Version:
Fast 3kb React-compatible Virtual DOM library.
1,181 lines (1,134 loc) • 111 kB
TypeScript
// Users who only use Preact for SSR might not specify "dom" in their lib in tsconfig.json
/// <reference lib="dom" />
import {
ClassAttributes,
Component,
ComponentType,
FunctionComponent,
PreactDOMAttributes,
VNode
} from 'preact';
type Defaultize<Props, Defaults> =
// Distribute over unions
Props extends any // Make any properties included in Default optional
? Partial<Pick<Props, Extract<keyof Props, keyof Defaults>>> & // Include the remaining properties from Props
Pick<Props, Exclude<keyof Props, keyof Defaults>>
: never;
type Booleanish = boolean | 'true' | 'false';
// Remove when bumping TS minimum to >5.2
/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ToggleEvent) */
interface ToggleEvent extends Event {
/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ToggleEvent/newState) */
readonly newState: string;
/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ToggleEvent/oldState) */
readonly oldState: string;
}
declare var ToggleEvent: {
prototype: ToggleEvent;
new (type: string, eventInitDict?: ToggleEventInit): ToggleEvent;
};
interface ToggleEventInit extends EventInit {
newState?: string;
oldState?: string;
}
// End TS >5.2
/** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/CommandEvent) */
interface CommandEvent extends Event {
/** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/CommandEvent/source) */
readonly source: Element | null;
/** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/CommandEvent/command) */
readonly command: string;
}
declare var CommandEvent: {
prototype: CommandEvent;
new (type: string, eventInitDict?: CommandEventInit): CommandEvent;
};
interface CommandEventInit extends EventInit {
source: Element | null;
command: string;
}
export namespace JSXInternal {
export type LibraryManagedAttributes<Component, Props> = Component extends {
defaultProps: infer Defaults;
}
? Defaultize<Props, Defaults>
: Props;
export interface IntrinsicAttributes {
key?: any;
}
export type ElementType<P = any> =
| {
[K in keyof IntrinsicElements]: P extends IntrinsicElements[K]
? K
: never;
}[keyof IntrinsicElements]
| ComponentType<P>;
export interface Element extends VNode<any> {}
export type ElementClass = Component<any, any> | FunctionComponent<any>;
export interface ElementAttributesProperty {
props: any;
}
export interface ElementChildrenAttribute {
children: any;
}
export type DOMCSSProperties = {
[key in keyof Omit<
CSSStyleDeclaration,
| 'item'
| 'setProperty'
| 'removeProperty'
| 'getPropertyValue'
| 'getPropertyPriority'
>]?: string | number | null | undefined;
};
export type AllCSSProperties = {
[key: string]: string | number | null | undefined;
};
export interface CSSProperties extends AllCSSProperties, DOMCSSProperties {
cssText?: string | null;
}
export interface SignalLike<T> {
value: T;
peek(): T;
subscribe(fn: (value: T) => void): () => void;
}
export type Signalish<T> = T | SignalLike<T>;
export type UnpackSignal<T> = T extends SignalLike<infer V> ? V : T;
export interface SVGAttributes<Target extends EventTarget = SVGElement>
extends HTMLAttributes<Target> {
accentHeight?: Signalish<number | string | undefined>;
accumulate?: Signalish<'none' | 'sum' | undefined>;
additive?: Signalish<'replace' | 'sum' | undefined>;
alignmentBaseline?: Signalish<
| 'auto'
| 'baseline'
| 'before-edge'
| 'text-before-edge'
| 'middle'
| 'central'
| 'after-edge'
| 'text-after-edge'
| 'ideographic'
| 'alphabetic'
| 'hanging'
| 'mathematical'
| 'inherit'
| undefined
>;
'alignment-baseline'?: Signalish<
| 'auto'
| 'baseline'
| 'before-edge'
| 'text-before-edge'
| 'middle'
| 'central'
| 'after-edge'
| 'text-after-edge'
| 'ideographic'
| 'alphabetic'
| 'hanging'
| 'mathematical'
| 'inherit'
| undefined
>;
allowReorder?: Signalish<'no' | 'yes' | undefined>;
'allow-reorder'?: Signalish<'no' | 'yes' | undefined>;
alphabetic?: Signalish<number | string | undefined>;
amplitude?: Signalish<number | string | undefined>;
/** @deprecated See https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/arabic-form */
arabicForm?: Signalish<
'initial' | 'medial' | 'terminal' | 'isolated' | undefined
>;
/** @deprecated See https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/arabic-form */
'arabic-form'?: Signalish<
'initial' | 'medial' | 'terminal' | 'isolated' | undefined
>;
ascent?: Signalish<number | string | undefined>;
attributeName?: Signalish<string | undefined>;
attributeType?: Signalish<string | undefined>;
azimuth?: Signalish<number | string | undefined>;
baseFrequency?: Signalish<number | string | undefined>;
baselineShift?: Signalish<number | string | undefined>;
'baseline-shift'?: Signalish<number | string | undefined>;
baseProfile?: Signalish<number | string | undefined>;
bbox?: Signalish<number | string | undefined>;
begin?: Signalish<number | string | undefined>;
bias?: Signalish<number | string | undefined>;
by?: Signalish<number | string | undefined>;
calcMode?: Signalish<number | string | undefined>;
capHeight?: Signalish<number | string | undefined>;
'cap-height'?: Signalish<number | string | undefined>;
clip?: Signalish<number | string | undefined>;
clipPath?: Signalish<string | undefined>;
'clip-path'?: Signalish<string | undefined>;
clipPathUnits?: Signalish<number | string | undefined>;
clipRule?: Signalish<number | string | undefined>;
'clip-rule'?: Signalish<number | string | undefined>;
colorInterpolation?: Signalish<number | string | undefined>;
'color-interpolation'?: Signalish<number | string | undefined>;
colorInterpolationFilters?: Signalish<
'auto' | 'sRGB' | 'linearRGB' | 'inherit' | undefined
>;
'color-interpolation-filters'?: Signalish<
'auto' | 'sRGB' | 'linearRGB' | 'inherit' | undefined
>;
colorProfile?: Signalish<number | string | undefined>;
'color-profile'?: Signalish<number | string | undefined>;
colorRendering?: Signalish<number | string | undefined>;
'color-rendering'?: Signalish<number | string | undefined>;
contentScriptType?: Signalish<number | string | undefined>;
'content-script-type'?: Signalish<number | string | undefined>;
contentStyleType?: Signalish<number | string | undefined>;
'content-style-type'?: Signalish<number | string | undefined>;
cursor?: Signalish<number | string | undefined>;
cx?: Signalish<number | string | undefined>;
cy?: Signalish<number | string | undefined>;
d?: Signalish<string | undefined>;
decelerate?: Signalish<number | string | undefined>;
descent?: Signalish<number | string | undefined>;
diffuseConstant?: Signalish<number | string | undefined>;
direction?: Signalish<number | string | undefined>;
display?: Signalish<number | string | undefined>;
divisor?: Signalish<number | string | undefined>;
dominantBaseline?: Signalish<number | string | undefined>;
'dominant-baseline'?: Signalish<number | string | undefined>;
dur?: Signalish<number | string | undefined>;
dx?: Signalish<number | string | undefined>;
dy?: Signalish<number | string | undefined>;
edgeMode?: Signalish<number | string | undefined>;
elevation?: Signalish<number | string | undefined>;
enableBackground?: Signalish<number | string | undefined>;
'enable-background'?: Signalish<number | string | undefined>;
end?: Signalish<number | string | undefined>;
exponent?: Signalish<number | string | undefined>;
externalResourcesRequired?: Signalish<number | string | undefined>;
fill?: Signalish<string | undefined>;
fillOpacity?: Signalish<number | string | undefined>;
'fill-opacity'?: Signalish<number | string | undefined>;
fillRule?: Signalish<'nonzero' | 'evenodd' | 'inherit' | undefined>;
'fill-rule'?: Signalish<'nonzero' | 'evenodd' | 'inherit' | undefined>;
filter?: Signalish<string | undefined>;
filterRes?: Signalish<number | string | undefined>;
filterUnits?: Signalish<number | string | undefined>;
floodColor?: Signalish<number | string | undefined>;
'flood-color'?: Signalish<number | string | undefined>;
floodOpacity?: Signalish<number | string | undefined>;
'flood-opacity'?: Signalish<number | string | undefined>;
focusable?: Signalish<number | string | undefined>;
fontFamily?: Signalish<string | undefined>;
'font-family'?: Signalish<string | undefined>;
fontSize?: Signalish<number | string | undefined>;
'font-size'?: Signalish<number | string | undefined>;
fontSizeAdjust?: Signalish<number | string | undefined>;
'font-size-adjust'?: Signalish<number | string | undefined>;
fontStretch?: Signalish<number | string | undefined>;
'font-stretch'?: Signalish<number | string | undefined>;
fontStyle?: Signalish<number | string | undefined>;
'font-style'?: Signalish<number | string | undefined>;
fontVariant?: Signalish<number | string | undefined>;
'font-variant'?: Signalish<number | string | undefined>;
fontWeight?: Signalish<number | string | undefined>;
'font-weight'?: Signalish<number | string | undefined>;
format?: Signalish<number | string | undefined>;
from?: Signalish<number | string | undefined>;
fx?: Signalish<number | string | undefined>;
fy?: Signalish<number | string | undefined>;
g1?: Signalish<number | string | undefined>;
g2?: Signalish<number | string | undefined>;
glyphName?: Signalish<number | string | undefined>;
'glyph-name'?: Signalish<number | string | undefined>;
glyphOrientationHorizontal?: Signalish<number | string | undefined>;
'glyph-orientation-horizontal'?: Signalish<number | string | undefined>;
glyphOrientationVertical?: Signalish<number | string | undefined>;
'glyph-orientation-vertical'?: Signalish<number | string | undefined>;
glyphRef?: Signalish<number | string | undefined>;
gradientTransform?: Signalish<string | undefined>;
gradientUnits?: Signalish<string | undefined>;
hanging?: Signalish<number | string | undefined>;
height?: Signalish<number | string | undefined>;
horizAdvX?: Signalish<number | string | undefined>;
'horiz-adv-x'?: Signalish<number | string | undefined>;
horizOriginX?: Signalish<number | string | undefined>;
'horiz-origin-x'?: Signalish<number | string | undefined>;
href?: Signalish<string | undefined>;
hreflang?: Signalish<string | undefined>;
hrefLang?: Signalish<string | undefined>;
ideographic?: Signalish<number | string | undefined>;
imageRendering?: Signalish<number | string | undefined>;
'image-rendering'?: Signalish<number | string | undefined>;
in2?: Signalish<number | string | undefined>;
in?: Signalish<string | undefined>;
intercept?: Signalish<number | string | undefined>;
k1?: Signalish<number | string | undefined>;
k2?: Signalish<number | string | undefined>;
k3?: Signalish<number | string | undefined>;
k4?: Signalish<number | string | undefined>;
k?: Signalish<number | string | undefined>;
kernelMatrix?: Signalish<number | string | undefined>;
kernelUnitLength?: Signalish<number | string | undefined>;
kerning?: Signalish<number | string | undefined>;
keyPoints?: Signalish<number | string | undefined>;
keySplines?: Signalish<number | string | undefined>;
keyTimes?: Signalish<number | string | undefined>;
lengthAdjust?: Signalish<number | string | undefined>;
letterSpacing?: Signalish<number | string | undefined>;
'letter-spacing'?: Signalish<number | string | undefined>;
lightingColor?: Signalish<number | string | undefined>;
'lighting-color'?: Signalish<number | string | undefined>;
limitingConeAngle?: Signalish<number | string | undefined>;
local?: Signalish<number | string | undefined>;
markerEnd?: Signalish<string | undefined>;
'marker-end'?: Signalish<string | undefined>;
markerHeight?: Signalish<number | string | undefined>;
markerMid?: Signalish<string | undefined>;
'marker-mid'?: Signalish<string | undefined>;
markerStart?: Signalish<string | undefined>;
'marker-start'?: Signalish<string | undefined>;
markerUnits?: Signalish<number | string | undefined>;
markerWidth?: Signalish<number | string | undefined>;
mask?: Signalish<string | undefined>;
maskContentUnits?: Signalish<number | string | undefined>;
maskUnits?: Signalish<number | string | undefined>;
mathematical?: Signalish<number | string | undefined>;
mode?: Signalish<number | string | undefined>;
numOctaves?: Signalish<number | string | undefined>;
offset?: Signalish<number | string | undefined>;
opacity?: Signalish<number | string | undefined>;
operator?: Signalish<number | string | undefined>;
order?: Signalish<number | string | undefined>;
orient?: Signalish<number | string | undefined>;
orientation?: Signalish<number | string | undefined>;
origin?: Signalish<number | string | undefined>;
overflow?: Signalish<number | string | undefined>;
overlinePosition?: Signalish<number | string | undefined>;
'overline-position'?: Signalish<number | string | undefined>;
overlineThickness?: Signalish<number | string | undefined>;
'overline-thickness'?: Signalish<number | string | undefined>;
paintOrder?: Signalish<number | string | undefined>;
'paint-order'?: Signalish<number | string | undefined>;
panose1?: Signalish<number | string | undefined>;
'panose-1'?: Signalish<number | string | undefined>;
pathLength?: Signalish<number | string | undefined>;
patternContentUnits?: Signalish<string | undefined>;
patternTransform?: Signalish<number | string | undefined>;
patternUnits?: Signalish<string | undefined>;
pointerEvents?: Signalish<number | string | undefined>;
'pointer-events'?: Signalish<number | string | undefined>;
points?: Signalish<string | undefined>;
pointsAtX?: Signalish<number | string | undefined>;
pointsAtY?: Signalish<number | string | undefined>;
pointsAtZ?: Signalish<number | string | undefined>;
preserveAlpha?: Signalish<number | string | undefined>;
preserveAspectRatio?: Signalish<string | undefined>;
primitiveUnits?: Signalish<number | string | undefined>;
r?: Signalish<number | string | undefined>;
radius?: Signalish<number | string | undefined>;
refX?: Signalish<number | string | undefined>;
refY?: Signalish<number | string | undefined>;
renderingIntent?: Signalish<number | string | undefined>;
'rendering-intent'?: Signalish<number | string | undefined>;
repeatCount?: Signalish<number | string | undefined>;
'repeat-count'?: Signalish<number | string | undefined>;
repeatDur?: Signalish<number | string | undefined>;
'repeat-dur'?: Signalish<number | string | undefined>;
requiredExtensions?: Signalish<number | string | undefined>;
requiredFeatures?: Signalish<number | string | undefined>;
restart?: Signalish<number | string | undefined>;
result?: Signalish<string | undefined>;
rotate?: Signalish<number | string | undefined>;
rx?: Signalish<number | string | undefined>;
ry?: Signalish<number | string | undefined>;
scale?: Signalish<number | string | undefined>;
seed?: Signalish<number | string | undefined>;
shapeRendering?: Signalish<number | string | undefined>;
'shape-rendering'?: Signalish<number | string | undefined>;
slope?: Signalish<number | string | undefined>;
spacing?: Signalish<number | string | undefined>;
specularConstant?: Signalish<number | string | undefined>;
specularExponent?: Signalish<number | string | undefined>;
speed?: Signalish<number | string | undefined>;
spreadMethod?: Signalish<string | undefined>;
startOffset?: Signalish<number | string | undefined>;
stdDeviation?: Signalish<number | string | undefined>;
stemh?: Signalish<number | string | undefined>;
stemv?: Signalish<number | string | undefined>;
stitchTiles?: Signalish<number | string | undefined>;
stopColor?: Signalish<string | undefined>;
'stop-color'?: Signalish<string | undefined>;
stopOpacity?: Signalish<number | string | undefined>;
'stop-opacity'?: Signalish<number | string | undefined>;
strikethroughPosition?: Signalish<number | string | undefined>;
'strikethrough-position'?: Signalish<number | string | undefined>;
strikethroughThickness?: Signalish<number | string | undefined>;
'strikethrough-thickness'?: Signalish<number | string | undefined>;
string?: Signalish<number | string | undefined>;
stroke?: Signalish<string | undefined>;
strokeDasharray?: Signalish<string | number | undefined>;
'stroke-dasharray'?: Signalish<string | number | undefined>;
strokeDashoffset?: Signalish<string | number | undefined>;
'stroke-dashoffset'?: Signalish<string | number | undefined>;
strokeLinecap?: Signalish<
'butt' | 'round' | 'square' | 'inherit' | undefined
>;
'stroke-linecap'?: Signalish<
'butt' | 'round' | 'square' | 'inherit' | undefined
>;
strokeLinejoin?: Signalish<
'miter' | 'round' | 'bevel' | 'inherit' | undefined
>;
'stroke-linejoin'?: Signalish<
'miter' | 'round' | 'bevel' | 'inherit' | undefined
>;
strokeMiterlimit?: Signalish<string | number | undefined>;
'stroke-miterlimit'?: Signalish<string | number | undefined>;
strokeOpacity?: Signalish<number | string | undefined>;
'stroke-opacity'?: Signalish<number | string | undefined>;
strokeWidth?: Signalish<number | string | undefined>;
'stroke-width'?: Signalish<number | string | undefined>;
surfaceScale?: Signalish<number | string | undefined>;
systemLanguage?: Signalish<number | string | undefined>;
tableValues?: Signalish<number | string | undefined>;
targetX?: Signalish<number | string | undefined>;
targetY?: Signalish<number | string | undefined>;
textAnchor?: Signalish<string | undefined>;
'text-anchor'?: Signalish<string | undefined>;
textDecoration?: Signalish<number | string | undefined>;
'text-decoration'?: Signalish<number | string | undefined>;
textLength?: Signalish<number | string | undefined>;
textRendering?: Signalish<number | string | undefined>;
'text-rendering'?: Signalish<number | string | undefined>;
to?: Signalish<number | string | undefined>;
transform?: Signalish<string | undefined>;
transformOrigin?: Signalish<string | undefined>;
'transform-origin'?: Signalish<string | undefined>;
type?: Signalish<string | undefined>;
u1?: Signalish<number | string | undefined>;
u2?: Signalish<number | string | undefined>;
underlinePosition?: Signalish<number | string | undefined>;
'underline-position'?: Signalish<number | string | undefined>;
underlineThickness?: Signalish<number | string | undefined>;
'underline-thickness'?: Signalish<number | string | undefined>;
unicode?: Signalish<number | string | undefined>;
unicodeBidi?: Signalish<number | string | undefined>;
'unicode-bidi'?: Signalish<number | string | undefined>;
unicodeRange?: Signalish<number | string | undefined>;
'unicode-range'?: Signalish<number | string | undefined>;
unitsPerEm?: Signalish<number | string | undefined>;
'units-per-em'?: Signalish<number | string | undefined>;
vAlphabetic?: Signalish<number | string | undefined>;
'v-alphabetic'?: Signalish<number | string | undefined>;
values?: Signalish<string | undefined>;
vectorEffect?: Signalish<number | string | undefined>;
'vector-effect'?: Signalish<number | string | undefined>;
version?: Signalish<string | undefined>;
vertAdvY?: Signalish<number | string | undefined>;
'vert-adv-y'?: Signalish<number | string | undefined>;
vertOriginX?: Signalish<number | string | undefined>;
'vert-origin-x'?: Signalish<number | string | undefined>;
vertOriginY?: Signalish<number | string | undefined>;
'vert-origin-y'?: Signalish<number | string | undefined>;
vHanging?: Signalish<number | string | undefined>;
'v-hanging'?: Signalish<number | string | undefined>;
vIdeographic?: Signalish<number | string | undefined>;
'v-ideographic'?: Signalish<number | string | undefined>;
viewBox?: Signalish<string | undefined>;
viewTarget?: Signalish<number | string | undefined>;
visibility?: Signalish<number | string | undefined>;
vMathematical?: Signalish<number | string | undefined>;
'v-mathematical'?: Signalish<number | string | undefined>;
width?: Signalish<number | string | undefined>;
wordSpacing?: Signalish<number | string | undefined>;
'word-spacing'?: Signalish<number | string | undefined>;
writingMode?: Signalish<number | string | undefined>;
'writing-mode'?: Signalish<number | string | undefined>;
x1?: Signalish<number | string | undefined>;
x2?: Signalish<number | string | undefined>;
x?: Signalish<number | string | undefined>;
xChannelSelector?: Signalish<string | undefined>;
xHeight?: Signalish<number | string | undefined>;
'x-height'?: Signalish<number | string | undefined>;
xlinkActuate?: Signalish<string | undefined>;
'xlink:actuate'?: Signalish<SVGAttributes['xlinkActuate']>;
xlinkArcrole?: Signalish<string | undefined>;
'xlink:arcrole'?: Signalish<string | undefined>;
xlinkHref?: Signalish<string | undefined>;
'xlink:href'?: Signalish<string | undefined>;
xlinkRole?: Signalish<string | undefined>;
'xlink:role'?: Signalish<string | undefined>;
xlinkShow?: Signalish<string | undefined>;
'xlink:show'?: Signalish<string | undefined>;
xlinkTitle?: Signalish<string | undefined>;
'xlink:title'?: Signalish<string | undefined>;
xlinkType?: Signalish<string | undefined>;
'xlink:type'?: Signalish<string | undefined>;
xmlBase?: Signalish<string | undefined>;
'xml:base'?: Signalish<string | undefined>;
xmlLang?: Signalish<string | undefined>;
'xml:lang'?: Signalish<string | undefined>;
xmlns?: Signalish<string | undefined>;
xmlnsXlink?: Signalish<string | undefined>;
xmlSpace?: Signalish<string | undefined>;
'xml:space'?: Signalish<string | undefined>;
y1?: Signalish<number | string | undefined>;
y2?: Signalish<number | string | undefined>;
y?: Signalish<number | string | undefined>;
yChannelSelector?: Signalish<string | undefined>;
z?: Signalish<number | string | undefined>;
zoomAndPan?: Signalish<string | undefined>;
}
export interface PathAttributes {
d: string;
}
export type TargetedEvent<
Target extends EventTarget = EventTarget,
TypedEvent extends Event = Event
> = Omit<TypedEvent, 'currentTarget'> & {
readonly currentTarget: Target;
};
export type TargetedAnimationEvent<Target extends EventTarget> =
TargetedEvent<Target, AnimationEvent>;
export type TargetedClipboardEvent<Target extends EventTarget> =
TargetedEvent<Target, ClipboardEvent>;
export type TargetedCommandEvent<Target extends EventTarget> = TargetedEvent<
Target,
CommandEvent
>;
export type TargetedCompositionEvent<Target extends EventTarget> =
TargetedEvent<Target, CompositionEvent>;
export type TargetedDragEvent<Target extends EventTarget> = TargetedEvent<
Target,
DragEvent
>;
export type TargetedFocusEvent<Target extends EventTarget> = TargetedEvent<
Target,
FocusEvent
>;
export type TargetedInputEvent<Target extends EventTarget> = TargetedEvent<
Target,
InputEvent
>;
export type TargetedKeyboardEvent<Target extends EventTarget> = TargetedEvent<
Target,
KeyboardEvent
>;
export type TargetedMouseEvent<Target extends EventTarget> = TargetedEvent<
Target,
MouseEvent
>;
export type TargetedPointerEvent<Target extends EventTarget> = TargetedEvent<
Target,
PointerEvent
>;
export type TargetedSubmitEvent<Target extends EventTarget> = TargetedEvent<
Target,
SubmitEvent
>;
export type TargetedTouchEvent<Target extends EventTarget> = TargetedEvent<
Target,
TouchEvent
>;
export type TargetedToggleEvent<Target extends EventTarget> = TargetedEvent<
Target,
ToggleEvent
>;
export type TargetedTransitionEvent<Target extends EventTarget> =
TargetedEvent<Target, TransitionEvent>;
export type TargetedUIEvent<Target extends EventTarget> = TargetedEvent<
Target,
UIEvent
>;
export type TargetedWheelEvent<Target extends EventTarget> = TargetedEvent<
Target,
WheelEvent
>;
export type TargetedPictureInPictureEvent<Target extends EventTarget> =
TargetedEvent<Target, PictureInPictureEvent>;
export type EventHandler<E extends TargetedEvent> = {
bivarianceHack(event: E): void;
}['bivarianceHack'];
export type AnimationEventHandler<Target extends EventTarget> = EventHandler<
TargetedAnimationEvent<Target>
>;
export type ClipboardEventHandler<Target extends EventTarget> = EventHandler<
TargetedClipboardEvent<Target>
>;
export type CommandEventHandler<Target extends EventTarget> = EventHandler<
TargetedCommandEvent<Target>
>;
export type CompositionEventHandler<Target extends EventTarget> =
EventHandler<TargetedCompositionEvent<Target>>;
export type DragEventHandler<Target extends EventTarget> = EventHandler<
TargetedDragEvent<Target>
>;
export type ToggleEventHandler<Target extends EventTarget> = EventHandler<
TargetedToggleEvent<Target>
>;
export type FocusEventHandler<Target extends EventTarget> = EventHandler<
TargetedFocusEvent<Target>
>;
export type GenericEventHandler<Target extends EventTarget> = EventHandler<
TargetedEvent<Target>
>;
export type InputEventHandler<Target extends EventTarget> = EventHandler<
TargetedInputEvent<Target>
>;
export type KeyboardEventHandler<Target extends EventTarget> = EventHandler<
TargetedKeyboardEvent<Target>
>;
export type MouseEventHandler<Target extends EventTarget> = EventHandler<
TargetedMouseEvent<Target>
>;
export type PointerEventHandler<Target extends EventTarget> = EventHandler<
TargetedPointerEvent<Target>
>;
export type SubmitEventHandler<Target extends EventTarget> = EventHandler<
TargetedSubmitEvent<Target>
>;
export type TouchEventHandler<Target extends EventTarget> = EventHandler<
TargetedTouchEvent<Target>
>;
export type TransitionEventHandler<Target extends EventTarget> = EventHandler<
TargetedTransitionEvent<Target>
>;
export type UIEventHandler<Target extends EventTarget> = EventHandler<
TargetedUIEvent<Target>
>;
export type WheelEventHandler<Target extends EventTarget> = EventHandler<
TargetedWheelEvent<Target>
>;
export type PictureInPictureEventHandler<Target extends EventTarget> =
EventHandler<TargetedPictureInPictureEvent<Target>>;
export interface DOMAttributes<Target extends EventTarget>
extends PreactDOMAttributes {
// Image Events
onLoad?: GenericEventHandler<Target> | undefined;
onLoadCapture?: GenericEventHandler<Target> | undefined;
onError?: GenericEventHandler<Target> | undefined;
onErrorCapture?: GenericEventHandler<Target> | undefined;
// Clipboard Events
onCopy?: ClipboardEventHandler<Target> | undefined;
onCopyCapture?: ClipboardEventHandler<Target> | undefined;
onCut?: ClipboardEventHandler<Target> | undefined;
onCutCapture?: ClipboardEventHandler<Target> | undefined;
onPaste?: ClipboardEventHandler<Target> | undefined;
onPasteCapture?: ClipboardEventHandler<Target> | undefined;
// Composition Events
onCompositionEnd?: CompositionEventHandler<Target> | undefined;
onCompositionEndCapture?: CompositionEventHandler<Target> | undefined;
onCompositionStart?: CompositionEventHandler<Target> | undefined;
onCompositionStartCapture?: CompositionEventHandler<Target> | undefined;
onCompositionUpdate?: CompositionEventHandler<Target> | undefined;
onCompositionUpdateCapture?: CompositionEventHandler<Target> | undefined;
// Popover Events
onBeforeToggle?: ToggleEventHandler<Target> | undefined;
onToggle?: ToggleEventHandler<Target> | undefined;
// Dialog Events
onClose?: GenericEventHandler<Target> | undefined;
onCancel?: GenericEventHandler<Target> | undefined;
// Focus Events
onFocus?: FocusEventHandler<Target> | undefined;
onFocusCapture?: FocusEventHandler<Target> | undefined;
onFocusIn?: FocusEventHandler<Target> | undefined;
onFocusInCapture?: FocusEventHandler<Target> | undefined;
onFocusOut?: FocusEventHandler<Target> | undefined;
onFocusOutCapture?: FocusEventHandler<Target> | undefined;
onBlur?: FocusEventHandler<Target> | undefined;
onBlurCapture?: FocusEventHandler<Target> | undefined;
// Form Events
onChange?: GenericEventHandler<Target> | undefined;
onChangeCapture?: GenericEventHandler<Target> | undefined;
onInput?: InputEventHandler<Target> | undefined;
onInputCapture?: InputEventHandler<Target> | undefined;
onBeforeInput?: InputEventHandler<Target> | undefined;
onBeforeInputCapture?: InputEventHandler<Target> | undefined;
onSearch?: GenericEventHandler<Target> | undefined;
onSearchCapture?: GenericEventHandler<Target> | undefined;
onSubmit?: SubmitEventHandler<Target> | undefined;
onSubmitCapture?: SubmitEventHandler<Target> | undefined;
onInvalid?: GenericEventHandler<Target> | undefined;
onInvalidCapture?: GenericEventHandler<Target> | undefined;
onReset?: GenericEventHandler<Target> | undefined;
onResetCapture?: GenericEventHandler<Target> | undefined;
onFormData?: GenericEventHandler<Target> | undefined;
onFormDataCapture?: GenericEventHandler<Target> | undefined;
// Keyboard Events
onKeyDown?: KeyboardEventHandler<Target> | undefined;
onKeyDownCapture?: KeyboardEventHandler<Target> | undefined;
onKeyPress?: KeyboardEventHandler<Target> | undefined;
onKeyPressCapture?: KeyboardEventHandler<Target> | undefined;
onKeyUp?: KeyboardEventHandler<Target> | undefined;
onKeyUpCapture?: KeyboardEventHandler<Target> | undefined;
// Media Events
onAbort?: GenericEventHandler<Target> | undefined;
onAbortCapture?: GenericEventHandler<Target> | undefined;
onCanPlay?: GenericEventHandler<Target> | undefined;
onCanPlayCapture?: GenericEventHandler<Target> | undefined;
onCanPlayThrough?: GenericEventHandler<Target> | undefined;
onCanPlayThroughCapture?: GenericEventHandler<Target> | undefined;
onDurationChange?: GenericEventHandler<Target> | undefined;
onDurationChangeCapture?: GenericEventHandler<Target> | undefined;
onEmptied?: GenericEventHandler<Target> | undefined;
onEmptiedCapture?: GenericEventHandler<Target> | undefined;
onEncrypted?: GenericEventHandler<Target> | undefined;
onEncryptedCapture?: GenericEventHandler<Target> | undefined;
onEnded?: GenericEventHandler<Target> | undefined;
onEndedCapture?: GenericEventHandler<Target> | undefined;
onLoadedData?: GenericEventHandler<Target> | undefined;
onLoadedDataCapture?: GenericEventHandler<Target> | undefined;
onLoadedMetadata?: GenericEventHandler<Target> | undefined;
onLoadedMetadataCapture?: GenericEventHandler<Target> | undefined;
onLoadStart?: GenericEventHandler<Target> | undefined;
onLoadStartCapture?: GenericEventHandler<Target> | undefined;
onPause?: GenericEventHandler<Target> | undefined;
onPauseCapture?: GenericEventHandler<Target> | undefined;
onPlay?: GenericEventHandler<Target> | undefined;
onPlayCapture?: GenericEventHandler<Target> | undefined;
onPlaying?: GenericEventHandler<Target> | undefined;
onPlayingCapture?: GenericEventHandler<Target> | undefined;
onProgress?: GenericEventHandler<Target> | undefined;
onProgressCapture?: GenericEventHandler<Target> | undefined;
onRateChange?: GenericEventHandler<Target> | undefined;
onRateChangeCapture?: GenericEventHandler<Target> | undefined;
onSeeked?: GenericEventHandler<Target> | undefined;
onSeekedCapture?: GenericEventHandler<Target> | undefined;
onSeeking?: GenericEventHandler<Target> | undefined;
onSeekingCapture?: GenericEventHandler<Target> | undefined;
onStalled?: GenericEventHandler<Target> | undefined;
onStalledCapture?: GenericEventHandler<Target> | undefined;
onSuspend?: GenericEventHandler<Target> | undefined;
onSuspendCapture?: GenericEventHandler<Target> | undefined;
onTimeUpdate?: GenericEventHandler<Target> | undefined;
onTimeUpdateCapture?: GenericEventHandler<Target> | undefined;
onVolumeChange?: GenericEventHandler<Target> | undefined;
onVolumeChangeCapture?: GenericEventHandler<Target> | undefined;
onWaiting?: GenericEventHandler<Target> | undefined;
onWaitingCapture?: GenericEventHandler<Target> | undefined;
// MouseEvents
onClick?: MouseEventHandler<Target> | undefined;
onClickCapture?: MouseEventHandler<Target> | undefined;
onContextMenu?: MouseEventHandler<Target> | undefined;
onContextMenuCapture?: MouseEventHandler<Target> | undefined;
onDblClick?: MouseEventHandler<Target> | undefined;
onDblClickCapture?: MouseEventHandler<Target> | undefined;
onDrag?: DragEventHandler<Target> | undefined;
onDragCapture?: DragEventHandler<Target> | undefined;
onDragEnd?: DragEventHandler<Target> | undefined;
onDragEndCapture?: DragEventHandler<Target> | undefined;
onDragEnter?: DragEventHandler<Target> | undefined;
onDragEnterCapture?: DragEventHandler<Target> | undefined;
onDragExit?: DragEventHandler<Target> | undefined;
onDragExitCapture?: DragEventHandler<Target> | undefined;
onDragLeave?: DragEventHandler<Target> | undefined;
onDragLeaveCapture?: DragEventHandler<Target> | undefined;
onDragOver?: DragEventHandler<Target> | undefined;
onDragOverCapture?: DragEventHandler<Target> | undefined;
onDragStart?: DragEventHandler<Target> | undefined;
onDragStartCapture?: DragEventHandler<Target> | undefined;
onDrop?: DragEventHandler<Target> | undefined;
onDropCapture?: DragEventHandler<Target> | undefined;
onMouseDown?: MouseEventHandler<Target> | undefined;
onMouseDownCapture?: MouseEventHandler<Target> | undefined;
onMouseEnter?: MouseEventHandler<Target> | undefined;
onMouseEnterCapture?: MouseEventHandler<Target> | undefined;
onMouseLeave?: MouseEventHandler<Target> | undefined;
onMouseLeaveCapture?: MouseEventHandler<Target> | undefined;
onMouseMove?: MouseEventHandler<Target> | undefined;
onMouseMoveCapture?: MouseEventHandler<Target> | undefined;
onMouseOut?: MouseEventHandler<Target> | undefined;
onMouseOutCapture?: MouseEventHandler<Target> | undefined;
onMouseOver?: MouseEventHandler<Target> | undefined;
onMouseOverCapture?: MouseEventHandler<Target> | undefined;
onMouseUp?: MouseEventHandler<Target> | undefined;
onMouseUpCapture?: MouseEventHandler<Target> | undefined;
// TODO: Spec for `auxclick` events was changed to make it a PointerEvent but only
// Chrome has support for it yet. When more browsers align we should change this.
// https://developer.mozilla.org/en-US/docs/Web/API/Element/auxclick_event#browser_compatibility
onAuxClick?: MouseEventHandler<Target> | undefined;
onAuxClickCapture?: MouseEventHandler<Target> | undefined;
// Selection Events
onSelect?: GenericEventHandler<Target> | undefined;
onSelectCapture?: GenericEventHandler<Target> | undefined;
// Touch Events
onTouchCancel?: TouchEventHandler<Target> | undefined;
onTouchCancelCapture?: TouchEventHandler<Target> | undefined;
onTouchEnd?: TouchEventHandler<Target> | undefined;
onTouchEndCapture?: TouchEventHandler<Target> | undefined;
onTouchMove?: TouchEventHandler<Target> | undefined;
onTouchMoveCapture?: TouchEventHandler<Target> | undefined;
onTouchStart?: TouchEventHandler<Target> | undefined;
onTouchStartCapture?: TouchEventHandler<Target> | undefined;
// Pointer Events
onPointerOver?: PointerEventHandler<Target> | undefined;
onPointerOverCapture?: PointerEventHandler<Target> | undefined;
onPointerEnter?: PointerEventHandler<Target> | undefined;
onPointerEnterCapture?: PointerEventHandler<Target> | undefined;
onPointerDown?: PointerEventHandler<Target> | undefined;
onPointerDownCapture?: PointerEventHandler<Target> | undefined;
onPointerMove?: PointerEventHandler<Target> | undefined;
onPointerMoveCapture?: PointerEventHandler<Target> | undefined;
onPointerUp?: PointerEventHandler<Target> | undefined;
onPointerUpCapture?: PointerEventHandler<Target> | undefined;
onPointerCancel?: PointerEventHandler<Target> | undefined;
onPointerCancelCapture?: PointerEventHandler<Target> | undefined;
onPointerOut?: PointerEventHandler<Target> | undefined;
onPointerOutCapture?: PointerEventHandler<Target> | undefined;
onPointerLeave?: PointerEventHandler<Target> | undefined;
onPointerLeaveCapture?: PointerEventHandler<Target> | undefined;
onGotPointerCapture?: PointerEventHandler<Target> | undefined;
onGotPointerCaptureCapture?: PointerEventHandler<Target> | undefined;
onLostPointerCapture?: PointerEventHandler<Target> | undefined;
onLostPointerCaptureCapture?: PointerEventHandler<Target> | undefined;
// UI Events
onScroll?: UIEventHandler<Target> | undefined;
onScrollEnd?: UIEventHandler<Target> | undefined;
onScrollCapture?: UIEventHandler<Target> | undefined;
// Wheel Events
onWheel?: WheelEventHandler<Target> | undefined;
onWheelCapture?: WheelEventHandler<Target> | undefined;
// Animation Events
onAnimationStart?: AnimationEventHandler<Target> | undefined;
onAnimationStartCapture?: AnimationEventHandler<Target> | undefined;
onAnimationEnd?: AnimationEventHandler<Target> | undefined;
onAnimationEndCapture?: AnimationEventHandler<Target> | undefined;
onAnimationIteration?: AnimationEventHandler<Target> | undefined;
onAnimationIterationCapture?: AnimationEventHandler<Target> | undefined;
// Transition Events
onTransitionCancel?: TransitionEventHandler<Target>;
onTransitionCancelCapture?: TransitionEventHandler<Target>;
onTransitionEnd?: TransitionEventHandler<Target>;
onTransitionEndCapture?: TransitionEventHandler<Target>;
onTransitionRun?: TransitionEventHandler<Target>;
onTransitionRunCapture?: TransitionEventHandler<Target>;
onTransitionStart?: TransitionEventHandler<Target>;
onTransitionStartCapture?: TransitionEventHandler<Target>;
// PictureInPicture Events
onEnterPictureInPicture?: PictureInPictureEventHandler<Target>;
onEnterPictureInPictureCapture?: PictureInPictureEventHandler<Target>;
onLeavePictureInPicture?: PictureInPictureEventHandler<Target>;
onLeavePictureInPictureCapture?: PictureInPictureEventHandler<Target>;
onResize?: PictureInPictureEventHandler<Target>;
onResizeCapture?: PictureInPictureEventHandler<Target>;
onCommand?: CommandEventHandler<Target>;
}
// All the WAI-ARIA 1.1 attributes from https://www.w3.org/TR/wai-aria-1.1/
export interface AriaAttributes {
/** Identifies the currently active element when DOM focus is on a composite widget, textbox, group, or application. */
'aria-activedescendant'?: Signalish<string | undefined>;
/** Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute. */
'aria-atomic'?: Signalish<Booleanish | undefined>;
/**
* Indicates whether inputting text could trigger display of one or more predictions of the user's intended value for an input and specifies how predictions would be
* presented if they are made.
*/
'aria-autocomplete'?: Signalish<
'none' | 'inline' | 'list' | 'both' | undefined
>;
/**
* Defines a string value that labels the current element, which is intended to be converted into Braille.
* @see aria-label.
*/
'aria-braillelabel'?: Signalish<string | undefined>;
/**
* Defines a human-readable, author-localized abbreviated description for the role of an element, which is intended to be converted into Braille.
* @see aria-roledescription.
*/
'aria-brailleroledescription'?: Signalish<string | undefined>;
/** Indicates an element is being modified and that assistive technologies MAY want to wait until the modifications are complete before exposing them to the user. */
'aria-busy'?: Signalish<Booleanish | undefined>;
/**
* Indicates the current "checked" state of checkboxes, radio buttons, and other widgets.
* @see aria-pressed
* @see aria-selected.
*/
'aria-checked'?: Signalish<Booleanish | 'mixed' | undefined>;
/**
* Defines the total number of columns in a table, grid, or treegrid.
* @see aria-colindex.
*/
'aria-colcount'?: Signalish<number | undefined>;
/**
* Defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid.
* @see aria-colcount
* @see aria-colspan.
*/
'aria-colindex'?: Signalish<number | undefined>;
/**
* Defines a human readable text alternative of aria-colindex.
* @see aria-rowindextext.
*/
'aria-colindextext'?: Signalish<string | undefined>;
/**
* Defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid.
* @see aria-colindex
* @see aria-rowspan.
*/
'aria-colspan'?: Signalish<number | undefined>;
/**
* Identifies the element (or elements) whose contents or presence are controlled by the current element.
* @see aria-owns.
*/
'aria-controls'?: Signalish<string | undefined>;
/** Indicates the element that represents the current item within a container or set of related elements. */
'aria-current'?: Signalish<
Booleanish | 'page' | 'step' | 'location' | 'date' | 'time' | undefined
>;
/**
* Identifies the element (or elements) that describes the object.
* @see aria-labelledby
*/
'aria-describedby'?: Signalish<string | undefined>;
/**
* Defines a string value that describes or annotates the current element.
* @see related aria-describedby.
*/
'aria-description'?: Signalish<string | undefined>;
/**
* Identifies the element that provides a detailed, extended description for the object.
* @see aria-describedby.
*/
'aria-details'?: Signalish<string | undefined>;
/**
* Indicates that the element is perceivable but disabled, so it is not editable or otherwise operable.
* @see aria-hidden
* @see aria-readonly.
*/
'aria-disabled'?: Signalish<Booleanish | undefined>;
/**
* Indicates what functions can be performed when a dragged object is released on the drop target.
* @deprecated in ARIA 1.1
*/
'aria-dropeffect'?: Signalish<
'none' | 'copy' | 'execute' | 'link' | 'move' | 'popup' | undefined
>;
/**
* Identifies the element that provides an error message for the object.
* @see aria-invalid
* @see aria-describedby.
*/
'aria-errormessage'?: Signalish<string | undefined>;
/** Indicates whether the element, or another grouping element it controls, is currently expanded or collapsed. */
'aria-expanded'?: Signalish<Booleanish | undefined>;
/**
* Identifies the next element (or elements) in an alternate reading order of content which, at the user's discretion,
* allows assistive technology to override the general default of reading in document source order.
*/
'aria-flowto'?: Signalish<string | undefined>;
/**
* Indicates an element's "grabbed" state in a drag-and-drop operation.
* @deprecated in ARIA 1.1
*/
'aria-grabbed'?: Signalish<Booleanish | undefined>;
/** Indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element. */
'aria-haspopup'?: Signalish<
Booleanish | 'menu' | 'listbox' | 'tree' | 'grid' | 'dialog' | undefined
>;
/**
* Indicates whether the element is exposed to an accessibility API.
* @see aria-disabled.
*/
'aria-hidden'?: Signalish<Booleanish | undefined>;
/**
* Indicates the entered value does not conform to the format expected by the application.
* @see aria-errormessage.
*/
'aria-invalid'?: Signalish<Booleanish | 'grammar' | 'spelling' | undefined>;
/** Indicates keyboard shortcuts that an author has implemented to activate or give focus to an element. */
'aria-keyshortcuts'?: Signalish<string | undefined>;
/**
* Defines a string value that labels the current element.
* @see aria-labelledby.
*/
'aria-label'?: Signalish<string | undefined>;
/**
* Identifies the element (or elements) that labels the current element.
* @see aria-describedby.
*/
'aria-labelledby'?: Signalish<string | undefined>;
/** Defines the hierarchical level of an element within a structure. */
'aria-level'?: Signalish<number | undefined>;
/** Indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region. */
'aria-live'?: Signalish<'off' | 'assertive' | 'polite' | undefined>;
/** Indicates whether an element is modal when displayed. */
'aria-modal'?: Signalish<Booleanish | undefined>;
/** Indicates whether a text box accepts multiple lines of input or only a single line. */
'aria-multiline'?: Signalish<Booleanish | undefined>;
/** Indicates that the user may select more than one item from the current selectable descendants. */
'aria-multiselectable'?: Signalish<Booleanish | undefined>;
/** Indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous. */
'aria-orientation'?: Signalish<'horizontal' | 'vertical' | undefined>;
/**
* Identifies an element (or elements) in order to define a visual, functional, or contextual parent/child relationship
* between DOM elements where the DOM hierarchy cannot be used to represent the relationship.
* @see aria-controls.
*/
'aria-owns'?: Signalish<string | undefined>;
/**
* Defines a short hint (a word or short phrase) intended to aid the user with data entry when the control has no value.
* A hint could be a sample value or a brief description of the expected format.
*/
'aria-placeholder'?: Signalish<string | undefined>;
/**
* Defines an element's number or position in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM.
* @see aria-setsize.
*/
'aria-posinset'?: Signalish<number | undefined>;
/**
* Indicates the current "pressed" state of toggle buttons.
* @see aria-checked
* @see aria-selected.
*/
'aria-pressed'?: Signalish<Booleanish | 'mixed' | undefined>;
/**
* Indicates that the element is not editable, but is otherwise operable.
* @see aria-disabled.
*/
'aria-readonly'?: Signalish<Booleanish | undefined>;
/**
* Indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified.
* @see aria-atomic.
*/
'aria-relevant'?: Signalish<
| 'additions'
| 'additions removals'
| 'additions text'
| 'all'
| 'removals'
| 'removals additions'
| 'removals text'
| 'text'
| 'text additions'
| 'text removals'
| undefined
>;
/** Indicates that user input is required on the element before a form may be submitted. */
'aria-required'?: Signalish<Booleanish | undefined>;
/** Defines a human-readable, author-localized description for the role of an element. */
'aria-roledescription'?: Signalish<string | undefined>;
/**
* Defines the total number of rows in a table, grid, or treegrid.
* @see aria-rowindex.
*/
'aria-rowcount'?: Signalish<number | undefined>;
/**
* Defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid.
* @see aria-rowcount
* @see aria-rowspan.
*/
'aria-rowindex'?: Signalish<number | undefined>;
/**
* Defines a human readable text alternative of aria-rowindex.
* @see aria-colindextext.
*/
'aria-rowindextext'?: Signalish<string | undefined>;
/**
* Defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid.
* @see aria-rowindex
* @see aria-colspan.
*/
'aria-rowspan'?: Signalish<number | undefined>;
/**
* Indicates the current "selected" state of various widgets.
* @see aria-checked
* @see aria-pressed.
*/
'aria-selected'?: Signalish<Booleanish | undefined>;
/**
* Defines the number of items in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM.
* @see aria-posinset.
*/
'aria-setsize'?: Signalish<number | undefined>;
/** Indicates if items in a table or grid are sorted in ascending or descending order. */
'aria-sort'?: Signalish<
'none' | 'ascending' | 'descending' | 'other' | undefined
>;
/** Defines the maximum allowed value for a range widget. */
'aria-valuemax'?: Signalish<number | undefined>;
/** Defines the minimum allowed value for a range widget. */
'aria-valuemin'?: Signalish<number | undefined>;
/**
* Defines the current value for a range widget.
* @see aria-valuetext.
*/
'aria-valuenow'?: Signalish<number | undefined>;
/** Defines the human readable text alternative of aria-valuenow for a range widget. */
'aria-valuetext'?: Signalish<string | undefined>;
}
// All the WAI-ARIA 1.2 role attribute values from https://www.w3.org/TR/wai-aria-1.2/#role_definitions
export type WAIAriaRole =
| 'alert'
| 'alertdialog'
| 'application'
| 'article'
| 'banner'
| 'blockquote'
| 'button'
| 'caption'
| 'cell'
| 'checkbox'
| 'code'
| 'columnheader'
| 'combobox'
| 'command'
| 'complementary'
| 'composite'
| 'contentinfo'
| 'definition'
| 'deletion'
| 'dialog'
| 'directory'
| 'document'
| 'emphasis'
| 'feed'
| 'figure'
| 'form'
| 'grid'
| 'gridcell'
| 'group'
| 'heading'
| 'img'
| 'input'
| 'insertion'
| 'landmark'
| 'link'
| 'list'
| 'listbox'
| 'listitem'
| 'log'
| 'main'
| 'marquee'
| 'math'
| 'meter'
| 'menu'
| 'menubar'
| 'menuitem'
| 'menuitemcheckbox'
| 'menuitemradio'
| 'navigation'
| 'none'
| 'note'
| 'option'
| 'paragraph'
| 'presentation'
| 'progressbar'
| 'radio'
| 'radiogroup'
| 'range'
| 'region'
| 'roletype'
| 'row'
| 'rowgroup'
| 'rowheader'
| 'scrollbar'
| 'search'
| 'searchbox'
| 'section'
| 'sectionhead'
| 'select'
| 'separator'
| 'slider'
| 'spinbutton'
| 'status'
| 'strong'
| 'structure'
| 'subscript'
| 'supersc