JavaScript. Подробное руководство, 6-е издание

FormValidity

реализует проверку элемента формы

Свойство validity объекта FormControl ссылается на объект FormValidity, который является представлением признака корректности данных в этом элементе формы. Если свойство valid имеет значение false, элемент формы содержит недопустимые данные и по крайней мере одно из других свойств, определяющих природу ошибки (или ошибок), будет иметь значение true.

Проверка форм является особенностью, введенной спецификацией HTML5, которая на момент написания этих строк была реализована не во всех броузерах.

Свойства

  readonly boolean customError

Сценарий вызвал метод FormControl.setCustomValidity данного элемента.

  readonly boolean patternMismatch

Введенные данные не соответствуют регулярному выражению.

  readonly boolean rangeOverflow

Объем введенных данных слишком велик.

  readonly boolean rangeUnderflow

Объем введенных данных слишком мал.

  readonly boolean stepMismatch

Введенные данные не соответствуют указанному шагу.

  readonly boolean tooLong

Объем введенных данных слишком велик.

  readonly boolean typeMismatch

Введенные данные имеют неверный тип.

  readonly boolean valid

Если это свойство имеет значение true, элемент формы содержит корректные данные и все другие свойства имеют значение false. Если это свойство имеет значение false, элемент формы содержит недопустимые данные и, по крайней мере, одно из других свойств имеет значение true.

  readonly boolean valueMissing

Элемент формы пуст, хотя он должен быть заполнен.

Geocoordinates

географическое местонахождение

Объект этого типа является представлением точки на поверхности Земли.

Свойства

  readonly double accuracy

Точность определения широты и долготы (свойства latitude и longitude) в метрах.

  readonly double altitude

Высота над уровнем моря в метрах или null, если информация о высоте недоступна.

  readonly double altitudeAccuracy

Точность определения высоты (свойство altitude) над уровнем моря в метрах. Если свойство altitude имеет значение null, свойство altitudeAccuracy также будет иметь значение null.

  readonly double heading

Направление движения пользователя в градусах относительно направления на истинный север или null, если информация о направлении недоступна. Если информация о высоте доступна, но скорость (свойство speed) движения равна нулю, то свойство heading будет иметь значение NaN.

  readonly double latitude

Широта местоположения пользователя в градусах с долями к северу от экватора.

  readonly double longitude

Долгота местоположения пользователя в градусах с долями к востоку от Гринвичского меридиана.

  readonly double speed

Скорость движения пользователя в метрах в секунду или null, если информация о скорости недоступна. Это свойство никогда не принимает отрицательные значения. См. также heading.

Geolocation

позволяет получить широту и долготу местоположения пользователя

Объект Geolocation определяет методы, позволяющие получить точные географические координаты местоположения пользователя. В броузерах, поддерживающих такую возможность, объект Geolocation можно получить через объекта Navigator, обратившись к свойству navigator.geolocation. Методы, описываемые ниже, опираются на использование некоторых других типов: местоположение определяется в форме объекта Geoposition, а ошибки - в форме объектов GeolocationError.

Методы

  void clearWatch(long watchId)

Останавливает слежение за местонахождением пользователя. В аргументе watchId должно передаваться значение, полученное соответствующим вызовом метода watchPosition.

  void getCurrentPosition(function success, [function error], [object options])

Асинхронно определяет местонахождение пользователя с учетом параметров options (перечень свойств объекта option приводится ниже). Этот метод немедленно возвращает управление, а когда местонахождение пользователя будет определено, указанной функции обратного вызова success будет передан объект Geoposition. Или в случае ошибки (возможно из-за того, что пользователь не дал разрешение на определение его координат) функции обратного вызова error будет передан объект GeolocationError.

  long watchPosition(function success, [function error], [object options])

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

Параметры

Аргумент options, передаваемый методам getCurrentPosition и watchPosition, является обычным объектом, содержащим ноль или более свойств из числа следующих:

  boolean enableHighAccuracy

Этот параметр говорит о желательности определения координат с высокой точностью, даже если это повлечет увеличение расхода энергии в аккумуляторах. По умолчанию имеет значение false. В устройствах, способных определять местонахождение посредством измерения мощности сигналов WiFi или с помощью GPS, установка этого параметра в значение true обычно означает «использовать GPS».