Виджет "Лупа", доступный в Android 9 (уровень API 28) и более поздних версиях, представляет собой виртуальную лупу, которая показывает увеличенную копию View через панель наложения, представляющую собой линзу. Эта функция улучшает вставку текста
и выбор пользовательского опыта. Применяя лупу к тексту, пользователь может точно позиционировать курсор или маркеры выделения, просматривая увеличенный текст на панели, которая следует за его пальцем.
На рисунке 1 показано, как лупа помогает выделять текст. API лупы не привязаны к тексту, и вы можете использовать этот виджет в различных случаях, например для чтения мелкого текста или увеличения трудноразличимых названий мест на картах.
Лупа уже интегрирована с виджетами платформы, такими как TextView, EditText и WebView. Она обеспечивает единообразную работу с текстом в разных приложениях.
Виджет поставляется с простым API и может использоваться для увеличения любого View в зависимости от контекста вашего приложения.
Использование API
Вы можете использовать лупу программно в произвольном представлении следующим образом:
Kotlin
val view: View = findViewById(R.id.view) val magnifier = Magnifier.Builder(view).build() magnifier.show(view.width / 2.0f, view.height / 2.0f)
Java
View view = findViewById(R.id.view); Magnifier magnifier = new Magnifier.Builder(view).build(); magnifier.show(view.getWidth() / 2, view.getHeight() / 2);
Если иерархия View имеет первый макет, лупа отображается на экране и содержит область с центром в заданных координатах в пределах View. Панель появляется над центральной точкой копируемого контента. Лупа остается на экране, пока пользователь не закроет ее.
В следующем фрагменте кода показано, как изменить фон увеличенного изображения:
Kotlin
view.setBackgroundColor(...)
Java
view.setBackgroundColor(...);
Если цвет фона виден в лупе, то ее содержимое устарело, поскольку в ней по-прежнему отображается область со старым фоном. Чтобы обновить контент, используйте метод update(), как показано ниже.
Kotlin
view.post { magnifier.update() }
Java
view.post(magnifier::update);
Когда лупа больше не нужна, закройте ее, вызвав метод dismiss():
Kotlin
magnifier.dismiss()
Java
magnifier.dismiss();
Увеличение при взаимодействии с пользователем
Распространенный вариант использования лупы – позволить пользователю увеличить область просмотра, коснувшись ее, как показано на рисунке 2.
ViewGroup, который содержит `ImageView` слева и TextView справа.Для этого нужно обновлять лупу в соответствии с событиями касания, полученными представлением, как показано ниже.
Kotlin
imageView.setOnTouchListener { v, event -> when (event.actionMasked) { MotionEvent.ACTION_DOWN, MotionEvent.ACTION_MOVE -> { val viewPosition = IntArray(2) v.getLocationOnScreen(viewPosition) magnifier.show(event.rawX - viewPosition[0], event.rawY - viewPosition[1]) } MotionEvent.ACTION_CANCEL, MotionEvent.ACTION_UP -> { magnifier.dismiss() } } true }
Java
imageView.setOnTouchListener(new View.OnTouchListener() { @Override public boolean onTouch(View v, MotionEvent event) { switch (event.getActionMasked()) { case MotionEvent.ACTION_DOWN: // Fall through. case MotionEvent.ACTION_MOVE: { final int[] viewPosition = new int[2]; v.getLocationOnScreen(viewPosition); magnifier.show(event.getRawX() - viewPosition[0], event.getRawY() - viewPosition[1]); break; } case MotionEvent.ACTION_CANCEL: // Fall through. case MotionEvent.ACTION_UP: { magnifier.dismiss(); } } return true; } });
Дополнительные сведения об увеличении текста
Для виджетов текста на платформе важно понимать особенности поведения лупы и включать ее для пользовательского представления текста на платформе Android. Вот несколько советов:
- Лупа активируется сразу, как только пользователь касается маркера вставки или выделения.
- Лупа всегда плавно следует за пальцем пользователя по горизонтали, а по вертикали она зафиксирована в центре текущей строки текста.
- При горизонтальном перемещении лупа перемещается только между левой и правой границами текущей строки. Кроме того, когда пользователь убирает палец за эти границы и расстояние по горизонтали между пальцем и ближайшей границей больше половины исходной ширины контента в лупе, лупа закрывается, поскольку курсор больше не виден в ней.
- Лупа не активируется, если шрифт текста слишком большой. Текст считается слишком большим, если разница между верхним и нижним выносными элементами шрифта больше высоты контента, который помещается в лупу. В этом случае включение лупы не дает дополнительных преимуществ.