Что такое текстовый индикатор выполнения?

Текстовый индикатор выполнения показывает степень выполнения задачи с помощью обычных символов вместо изображения, например ████████░░░░░░░░░░░░ 42% или [=========> ]. Поскольку это обычный текст, его можно использовать везде, где используется текст: в README, сообщении Discord или Slack, сообщении коммита, скрипте терминала, строке состояния или публикации в социальной сети.

Описание инструмента

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

Возможности

  • Стили из блоков, оттенков, решёток, стрелок, кругов, квадратов и emoji, а также пользовательские символы заполнения, пустого пространства и указателя
  • Плавные блоки, заполняющие восьмые доли символа для более точного отображения
  • Ширина от 1 до 100 символов
  • Необязательные левая и правая границы, например [ и ]
  • Процент, значение от общего количества, оба показателя или отсутствие подписи с выбором количества знаков после запятой
  • Несколько индикаторов одновременно с выровненными подписями
  • Копирование результата или его скачивание в виде текстового файла

Как это работает

Значение делится на общее количество и умножается на ширину, чтобы определить, сколько символов нужно заполнить; результат округляется до ближайшего символа. Плавный стиль округляет результат до ближайшей восьмой доли символа и отображает частично заполненную ячейку с помощью одного из Unicode-блоков ▏▎▍▌▋▊▉. В стиле со стрелкой и в пользовательских индикаторах с символом указателя последний заполненный символ заменяется указателем, пока индикатор не заполнен полностью. Значения ниже нуля отображаются как пустой индикатор, а значения выше общего количества — как полностью заполненный индикатор, при этом подпись по-прежнему показывает фактический процент, например 150%.

Советы

  • Вставляйте индикаторы в блок кода (три обратных апострофа в Markdown, Discord или Slack), чтобы они отображались моноширинным шрифтом и были выровнены.
  • Emoji и некоторые символы во многих шрифтах занимают больше одной позиции, поэтому индикаторы с emoji могут не выравниваться с текстом в той же строке.
  • Для терминала или файла журнала, который может не поддерживать Unicode, используйте стиль «Решётка» или «Стрелка», поскольку они используют только символы ASCII.