Scrollbar — Обзор

KbqScrollbar — настраиваемый скроллбар. Его можно показывать постоянно, при наведении или прокрутке либо скрыть. Компонент поддерживает управление колесом мыши, жестами и клавиатурой, а также предоставляет методы программной прокрутки.

Режим отображения

Входной параметр kbqScrollbarMode задает режим отображения:

Режим	Описание
`hover`	Скроллбар появляется при наведении курсора или во время прокрутки. Режим используется по умолчанию
`always`	Скроллбар отображается, пока содержимое не помещается
`native`	Браузер отображает собственный скроллбар
`hidden`	Скроллбар не отображается, но содержимое можно прокручивать

В режимах hover и always полоса рисуется только для оси, которую пользователь может прокрутить: у оси с вычисленным overflow hidden, clip или visible полосы нет, сколько бы содержимое ни выходило за границы.

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

In cryptography, a brute-force attack or exhaustive key search is a cryptanalytic attack that consists of an attacker submitting many possible keys or passwords with the hope of eventually guessing correctly. This strategy can theoretically be used to break any form of encryption that is not information-theoretically secure.[1] However, in a properly designed cryptosystem the chance of successfully guessing the key is negligible.

Brute-force attacks are an application of brute-force search, the general problem-solving technique of enumerating all candidates and checking each one. The word 'hammering' is sometimes used to describe a brute-force attack,[4] with 'anti-hammering' for countermeasures.[5]

When cracking passwords, this method is very fast when used to check all short passwords, but for longer passwords other methods such as the dictionary attack are used because a brute-force search takes too long. Longer passwords, passphrases and keys have more possible values, making them exponentially more difficult to crack than shorter ones due to the diversity of characters.[2]

Brute-force attacks can be made less effective by implementing key stretching techniques making it more difficult for an attacker to recognize when the code has been cracked or by making the attacker do more work to test each guess. One of the measures of the strength of an encryption system is how long it would theoretically take an attacker to mount a successful brute-force attack against it.[3]

Показать код

Виртуальная прокрутка

Примените директиву kbqScrollbarViewport к cdk-virtual-scroll-viewport, чтобы добавить настраиваемый скроллбар. Директива поддерживает те же режимы отображения.

Показать код

Программное управление прокруткой

Получите экземпляр компонента по имени экспорта kbqScrollbar и вызовите один из публичных методов:

Метод	Описание
`scrollTo`	Прокручивает до заданных координат
`scrollToTop` и `scrollToBottom`	Прокручивают до верхней или нижней границы
`scrollStart` и `scrollEnd`	Прокручивают к логическому началу или концу по горизонтали с учетом RTL
`scrollToElement`	Прокручивает до элемента, указанного напрямую или CSS-селектором. Поддерживает дополнительные отступы
`scrollIntoView`	Располагает элемент в центре области просмотра

Параметр behavior принимает значения auto, instant и smooth.

[SCROLL TO ELEMENT] When cracking passwords, this method is very fast when used to check all short passwords, but for longer passwords other methods such as the dictionary attack are used because a brute-force search takes too long. Longer passwords, passphrases and keys have more possible values, making them exponentially more difficult to crack than shorter ones due to the diversity of characters.[2]

Brute-force attacks can be made less effective by implementing key stretching techniques making it more difficult for an attacker to recognize when [SCROLL INTO VIEW] the code has been cracked or by making the attacker do more work to test each guess. One of the measures of the strength of an encryption system is how long it would theoretically take an attacker to mount a successful brute-force attack against it.[3]

Показать код

Индикатор прокрутки

Вызовите метод flashScrollIndicators, чтобы ненадолго показать скроллбар — это подскажет, что доступна прокрутка:

 import { afterNextRender, ChangeDetectionStrategy, Component, viewChild } from '@angular/core';
import { KbqScrollbar } from '@koobiq/components/scrollbar';
 
@Component({
    imports: [KbqScrollbar],
    template: `
        <kbq-scrollbar>...</kbq-scrollbar>
    `,
    changeDetection: ChangeDetectionStrategy.OnPush
})
export class FlashScrollIndicatorsExample {
    private readonly scrollbar = viewChild.required(KbqScrollbar);
 
    constructor() {
        afterNextRender(() => {
            this.scrollbar().flashScrollIndicators();
        });
    }
}

Скроллбар браузера

Директива kbqNativeScrollbar настраивает внешний вид скроллбара элемента, не заменяя браузерный механизм прокрутки. Добавьте kbqNativeScrollbarDescendants, чтобы применить те же настройки к скроллбарам вложенных элементов.

Показать код

События прокрутки

Подпишитесь на scrollChanges, чтобы отслеживать события scroll:

 import { afterNextRender, ChangeDetectionStrategy, Component, DestroyRef, inject, viewChild } from '@angular/core';
import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
import { KbqScrollbar } from '@koobiq/components/scrollbar';
 
@Component({
    imports: [KbqScrollbar],
    template: `
        <kbq-scrollbar>...</kbq-scrollbar>
    `,
    changeDetection: ChangeDetectionStrategy.OnPush
})
export class ScrollEventsExample {
    private readonly scrollbar = viewChild.required(KbqScrollbar);
    private readonly destroyRef = inject(DestroyRef);
 
    constructor() {
        afterNextRender(() => {
            this.scrollbar()
                .scrollChanges.pipe(takeUntilDestroyed(this.destroyRef))
                .subscribe(() => {
                    // Обработайте событие прокрутки.
                });
        });
    }
}

Если вы нашли ошибку или хотите доработать статью, создайте запрос на GitHub.