Filesize formatter

Filesize formatter нужен для удобного форматирования размера файлов (или любых числовых значений в байтах) в читаемый вид, понятный человеку. Он автоматически конвертирует в килобайты, мегабайты, гигабайты и т. д., учитывая локализацию, также можно настроить округление.

Добавьте KbqDataSizePipe в imports компонента. Он работает как стандартный Angular pipe:

import { KbqDataSizePipe } from '@koobiq/components/core';

@Component({
    imports: [KbqDataSizePipe],
    template: `
        <div>{{ 1024 | kbqDataSize }}</div>
    `
})

Форматер поддерживает локализацию, выбор системы измерения (SI/IEC) и настройку точности округления.

Можно задать параметры напрямую в шаблоне с помощью аргументов пайпа:

@Component({
    imports: [KbqDataSizePipe],
    template: `
        <div>{{ 1536 | kbqDataSize : 1 : 'IEC' : 'en-US' }}</div><!-- 1.5 KB -->
    `
})

Для задания общих параметров форматирования во всем приложении или модуле используйте провайдер:

import { kbqFilesizeFormatterConfigurationProvider } from '@koobiq/components/core';

@NgModule({
    providers: [
        kbqFilesizeFormatterConfigurationProvider({
            defaultPrecision: 3,
            defaultUnitSystem: 'SI'
        })
    ]
})
  • Между числом и единицей измерения используется неразрывный пробел (&nbsp;).
  • По умолчанию используется форматирование с помощью пайпа KbqDecimalPipe.
  • Для отображения чисел в таблицах применяется пайп KbqTableNumberPipe.

Чтобы применить форматирование чисел в таблице с помощью пайпа kbqTableNumber, необходимо переопределить KbqDecimalPipe, зарегистрировав соответствующий провайдер в компоненте или модуле:

Вопросы и предложения по документации
Если у вас есть вопросы или вы хотите внести свой вклад в написание документации, пожалуйста, создайте issue в нашем репозитории на GitHub.