Как реализовать лупу для текста

Попробуйте Compose
Jetpack Compose – это рекомендуемый набор инструментов для создания пользовательского интерфейса в Android. Узнайте, как использовать текст в Compose.

Виджет "Лупа", доступный в Android 9 (уровень API 28) и более поздних версиях, представляет собой виртуальную лупу, которая показывает увеличенную копию View через панель наложения, представляющую собой линзу. Эта функция улучшает вставку текста и выбор пользовательского опыта. Применяя лупу к тексту, пользователь может точно позиционировать курсор или маркеры выделения, просматривая увеличенный текст на панели, которая следует за его пальцем.

На рисунке 1 показано, как лупа помогает выделять текст. API лупы не привязаны к тексту, и вы можете использовать этот виджет в различных случаях, например для чтения мелкого текста или увеличения трудноразличимых названий мест на картах.

Изображение, на котором показано, как выглядит лупа после захвата правого маркера выделения
Рисунок 1. Увеличение текста. Когда пользователь перетаскивает правый маркер выделения, появляется лупа, которая помогает точно разместить маркер.

Лупа уже интегрирована с виджетами платформы, такими как 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.

Рисунок 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. Вот несколько советов:

  • Лупа активируется сразу, как только пользователь касается маркера вставки или выделения.
  • Лупа всегда плавно следует за пальцем пользователя по горизонтали, а по вертикали она зафиксирована в центре текущей строки текста.
  • При горизонтальном перемещении лупа перемещается только между левой и правой границами текущей строки. Кроме того, когда пользователь убирает палец за эти границы и расстояние по горизонтали между пальцем и ближайшей границей больше половины исходной ширины контента в лупе, лупа закрывается, поскольку курсор больше не виден в ней.
  • Лупа не активируется, если шрифт текста слишком большой. Текст считается слишком большим, если разница между верхним и нижним выносными элементами шрифта больше высоты контента, который помещается в лупу. В этом случае включение лупы не дает дополнительных преимуществ.