SVGElement

package js.html.svg

extends GraphicsElement › Element › DOMElement › Node › EventTarget

Доступно в js

Интерфейс SVGSVGElement предоставляет доступ к свойствам элементов svg, а также методы для их управления. Этот интерфейс также содержит различные вспомогательные методы общего пользования, такие как операции с матрицами и возможность управления временем перерисовки на визуальных устройствах отображения.

Документация SVGSVGElement от Mozilla Contributors, лицензия CC-BY-SA 2.5.

См. также:

• https://developer.mozilla.org/en-US/docs/Web/API/SVGSVGElement

Статические переменные

staticinlineread onlySVG_ZOOMANDPAN_DISABLE:Int = 1

staticinlineread onlySVG_ZOOMANDPAN_MAGNIFY:Int = 2

staticinlineread onlySVG_ZOOMANDPAN_UNKNOWN:Int = 0

Переменные

currentScale:Float

Внешнем элементе svg, это числовое значение указывает текущий коэффициент масштаба относительно начального вида, учитывая операции масштабирования и перемещения пользователя. Атрибуты DOM currentScale и currentTranslate эквивалентны матрице 2x3 [a b c d e f] = [currentScale 0 0 currentScale currentTranslate.x currentTranslate.y]. Если включено «увеличение» (т.е., zoomAndPan="magnify" ), то эффект эквивалентен дополнительной трансформации на самом верхнем уровне фрагмента SVG-документа (т.е., вне самого внешнего элемента svg).

read onlycurrentTranslate:Point

Значение SVGPoint, представляющее коэффициент смещения, учитывая операцию «увеличения» пользователя, соответствующее внешнему элементу svg. Поведение не определено для svg-элементов, которые не находятся на самом внешнем уровне.

read onlyheight:AnimatedLength

Значение SVGAnimatedLength, соответствующее атрибуту height данного элемента svg.

read onlypreserveAspectRatio:AnimatedPreserveAspectRatio

read onlyuseCurrentView:Bool

Начальный вид (т.е., до масштабирования и перемещения) текущего внутреннего фрагмента SVG-документа может быть либо «стандартным» видом, т.е., основанным на атрибутах элемента svg, таких как viewBox, либо «настраиваемым» видом (т.е., гиперссылкой на конкретный view или другой элемент). Если начальный вид — «стандартный», то этот атрибут — false. Если начальный вид — «настраиваемый», то этот атрибут — true.

read onlyviewBox:AnimatedRect

read onlywidth:AnimatedLength

Значение SVGAnimatedLength, соответствующее атрибуту width данного элемента svg.

read onlyx:AnimatedLength

Значение SVGAnimatedLength, соответствующее атрибуту x данного элемента svg.

read onlyy:AnimatedLength

Значение SVGAnimatedLength, соответствующее атрибуту y данного элемента svg.

zoomAndPan:Int

Методы

animationsPaused():Bool

Возвращает true, если этот фрагмент SVG-документа приостановлен.

createSVGAngle():Angle

Создаёт объект SVGAngle вне любых древовидных структур документа. Объект инициализирован значением ноль градусов (без единиц).

createSVGLength():Length

Создаёт объект SVGLength вне любых древовидных структур документа. Объект инициализирован значением ноль пользовательских единиц.

createSVGMatrix():Matrix

Создаёт объект SVGMatrix вне любых древовидных структур документа. Объект инициализирован единичной матрицей.

createSVGNumber():Number

Создаёт объект SVGNumber вне любых древовидных структур документа. Объект инициализирован значением ноль.

createSVGPoint():Point

Создаёт объект SVGPoint вне любых древовидных структур документа. Объект инициализирован точкой (0,0) в системе координат пользователя.

createSVGRect():Rect

Создаёт объект SVGRect вне любых древовидных структур документа. Объект инициализирован таким образом, что все значения установлены в 0 пользовательских единиц.

createSVGTransform():Transform

Создаёт объект SVGTransform вне любых древовидных структур документа. Объект инициализирован преобразованием единичной матрицы (SVG_TRANSFORM_MATRIX).

createSVGTransformFromMatrix(matrix:Matrix):Transform

Создаёт объект SVGTransform вне любых древовидных структур документа. Объект инициализирован данной матрицей преобразования (т.е., SVG_TRANSFORM_MATRIX). Значения из матрицы-параметра копируются, матрица-параметр не принимается как SVGTransform::matrix.

deselectAll():Void

Отменяет выбор любых выбранных объектов, включая выбор текстовых строк и полей ввода.

forceRedraw():Void

В средах отображения, поддерживающих интерактивность, заставляет пользовательский агент немедленно перерисовать все области области просмотра, которые требуют обновления.

getCurrentTime():Float

Возвращает текущее время в секундах относительно начального времени для текущего фрагмента SVG-документа. Если getCurrentTime вызывается до начала временной шкалы документа (например, сценарием, выполняемым в элементе script перед отправкой события SVGLoad документа), то возвращается 0.

getElementById(elementId:String):Element

Ищет в этом фрагменте SVG-документа (поиск ограничен подмножеством дерева документа) элемент, у которого id задан значением elementId. Если такой элемент найден, он возвращается. Если такого элемента нет, возвращается null. Поведение не определено, если более одного элемента имеют этот id.

pauseAnimations():Void

Приостанавливает все текущие анимации, определённые в фрагменте SVG-документа, соответствующем элементу svg, заставляя соответствующие часы анимации этого фрагмента остановиться до момента возобновления.

setCurrentTime(seconds:Float):Void

Настраивает часы для этого фрагмента SVG-документа, устанавливая новое текущее время. Если setCurrentTime вызывается до начала временной шкалы документа (например, сценарием, выполняемым в элементе script перед отправкой события SVGLoad документа), то значение seconds в последнем вызове метода указывает время, к которому документ перейдёт после начала временной шкалы документа.

suspendRedraw(maxWaitMilliseconds:Int):Int

Принимает значение тайм-аута, которое указывает, что перерисовка не произойдёт до: вызова соответствующего unsuspendRedraw(), вызова unsuspendRedrawAll() или истечения тайм-аута.

В средах, которые не поддерживают интерактивность (например, печатные СМИ), перерисовка не приостанавливается. Вызовы suspendRedraw() и unsuspendRedraw() должны, но не обязательно, выполняться парно.

Чтобы приостановить действия перерисовки при возникновении набора изменений в SVG DOM, перед изменениями в SVG DOM следует вызвать метод, аналогичный:

suspendHandleID = suspendRedraw(maxWaitMilliseconds);

а после изменений — метод, аналогичный:

unsuspendRedraw(suspendHandleID);

Обратите внимание, что можно использовать несколько вызовов suspendRedraw одновременно, и каждый такой вызов обрабатывается независимо от других вызовов suspendRedraw.

unpauseAnimations():Void

Возобновляет текущие анимации, определённые во фрагменте SVG-документа, заставляя часы анимации продолжить работу с момента приостановки.

unsuspendRedraw(suspendHandleID:Int):Void

Отменяет указанный suspendRedraw() путём предоставления уникального идентификатора обработчика приостановки, который был возвращён предыдущим вызовом suspendRedraw().

unsuspendRedrawAll():Void

Отменяет все активные вызовы метода suspendRedraw(). Этот метод наиболее полезен в конце набора вызовов SVG DOM для обеспечения отмены всех ожидающих вызовов метода suspendRedraw().