dynamic-sticky-sidebardynamic-sticky-sidebar
راهنما
  • Vanilla JS
  • React
  • Vue
API
دمو
npm
  • English
  • فارسی
  • العربية
  • Deutsch
  • Français
  • Italiano
GitHub
راهنما
  • Vanilla JS
  • React
  • Vue
API
دمو
npm
  • English
  • فارسی
  • العربية
  • Deutsch
  • Français
  • Italiano
GitHub
  • راهنما

    • مقدمه
    • شروع به کار
    • الزامات چیدمان
    • هدرهای پویا
    • چطور کار می‌کند
    • عیب‌یابی
  • فریم‌ورک‌ها

    • Vanilla JS
    • React
    • Vue
  • مرجع

    • مرجع API
    • دموی زنده

مرجع API

stickySidebar(target, options?)

function stickySidebar(target: HTMLElement | string, options?: StickySidebarOptions): StickySidebar;
پارامترتایپتوضیح
targetHTMLElement | stringالمنت سایدبار، یا یک selector برای آن. اگر چیزی match نشود، خطای [dynamic-sticky-sidebar] sidebar element not found پرتاب می‌شود.
optionsStickySidebarOptionsآپشن‌ها را ببینید. همه اختیاری هستند.

آپشن‌ها

type Px = number | (() => number);
type HeaderInput = string | Element | ArrayLike<Element> | null | undefined;

interface StickySidebarOptions {
    header?: HeaderInput;
    offsetTop?: Px;
    offsetBottom?: Px;
    gap?: number;
    media?: string;
    scroller?: Element | string | null;
    subscribe?: (update: () => void) => void | (() => void);
}

header

  • تایپ: string | Element | ArrayLike<Element> | null
  • پیش‌فرض: ندارد

المنت (یا المنت‌های) هدر sticky یا fixed. اگر selector بدهید، همه‌ی المنت‌های match‌شده استفاده می‌شوند. سایدبار زیر پایین‌ترین لبه‌ی قابل‌مشاهده در میان آن‌ها می‌چسبد و وقتی کنار می‌روند، جمع می‌شوند یا تغییر اندازه می‌دهند، به‌صورت زنده دنبالشان می‌کند. هدرهای پویا را ببینید.

offsetTop

  • تایپ: number | () => number
  • پیش‌فرض: 0

فاصله‌ی اضافه بین هدر (یا بالای viewport، اگر هدری نباشد) و سایدبار. اگر تابع باشد، در هر محاسبه‌ی دوباره صدا زده می‌شود.

offsetBottom

  • تایپ: number | () => number
  • پیش‌فرض: 0

فاصله‌ی اضافه بین سایدبار و پایین viewport، وقتی سایدبار به پایین چسبیده است.

gap

  • تایپ: number
  • پیش‌فرض: 16

فاصله بر حسب px که روی هر دو لبه، علاوه بر offsetTop / offsetBottom، اعمال می‌شود.

media

  • تایپ: string
  • پیش‌فرض: همیشه فعال

یک media query. نمونه فقط تا وقتی query برقرار است اجرا می‌شود، مثلاً '(min-width: 768px)'. وقتی دیگر برقرار نباشد، listenerها حذف و استایل‌های inline برگردانده می‌شوند.

scroller

  • تایپ: Element | string | null
  • پیش‌فرض: window

المنت اسکرول‌شونده، وقتی سایدبار به‌جای خود صفحه داخل یک container اسکرول‌شونده قرار دارد. همه‌ی موقعیت‌ها نسبت به بخش قابل‌مشاهده‌ی اسکرولر اندازه‌گیری می‌شوند.

subscribe

  • تایپ: (update: () => void) => void | (() => void)
  • پیش‌فرض: ندارد

یک منبع خارجی را که هدر را جابه‌جا می‌کند (یک store، یک event bus و…) وصل می‌کند. هر بار که منبع تغییر کرد update را صدا بزنید و یک تابع unsubscribe برگردانید. این تابع هنگام شروع نمونه صدا زده می‌شود و هنگام توقف آن unsubscribe می‌شود.

subscribe: (update) => store.subscribe(update)

نمونه (Instance)

interface StickySidebar {
    readonly element: HTMLElement;
    update(): void;
    refresh(): void;
    setOptions(options: StickySidebarOptions): void;
    destroy(): void;
}

element

المنت سایدبار، بعد از resolve شدن.

update()

به‌صورت همگام دوباره محاسبه می‌کند و بعد برای چند فریم به دنبال کردن ادامه می‌دهد، در صورتی که چیزی هنوز در حال حرکت باشد. آن را بعد از تغییراتی صدا بزنید که کتابخانه نمی‌تواند ببیند. وقتی باید کمک کنید را ببینید.

refresh()

نمونه را کامل از نو راه‌اندازی می‌کند: selectorهای header و scroller را دوباره query می‌کند، media را دوباره ارزیابی می‌کند و حالت چیدمان را دوباره تشخیص می‌دهد. بعد از جایگزین شدن المنت‌های هدر در DOM از آن استفاده کنید.

setOptions(options)

همه‌ی آپشن‌ها را جایگزین می‌کند و merge نمی‌کند.

  • تغییر header، media، scroller یا subscribe (مقایسه بر اساس identity) نمونه را از نو راه‌اندازی می‌کند.
  • بقیه‌ی تغییرات (gap، offsetTop، offsetBottom) فقط باعث محاسبه‌ی دوباره می‌شوند.

destroy()

همه‌ی listenerها و observerها را حذف می‌کند، فریم‌های در انتظار را لغو می‌کند، تابع پاک‌سازی subscribe را صدا می‌زند و استایل‌های inline اصلی سایدبار را برمی‌گرداند.

React

import { StickySidebar, useStickySidebar } from 'dynamic-sticky-sidebar/react';
Exportامضا
useStickySidebar<T extends HTMLElement>(options?: UseStickySidebarOptions) => (node: T | null) => void
StickySidebarForwardRefExoticComponent<StickySidebarProps>
interface UseStickySidebarOptions extends Omit<StickySidebarOptions, 'header' | 'scroller'> {
    header?: HeaderInput | RefObject<Element | null>;
    scroller?: Element | string | null | RefObject<Element | null>;
}

interface StickySidebarProps extends UseStickySidebarOptions, HTMLAttributes<HTMLElement> {
    as?: ElementType; // default 'aside'
    children?: ReactNode;
}

React را ببینید.

Vue

import { useStickySidebar, vStickySidebar, StickySidebarPlugin } from 'dynamic-sticky-sidebar/vue';
Exportامضا
useStickySidebar(target: MaybeRefOrGetter<HTMLElement | ComponentPublicInstance | null>, options?: MaybeRefOrGetter<VueStickySidebarOptions>) => { update(): void; refresh(): void }
vStickySidebarDirective<HTMLElement, VueStickySidebarOptions | undefined>
StickySidebarPluginPlugin که v-sticky-sidebar را ثبت می‌کند
interface VueStickySidebarOptions extends Omit<StickySidebarOptions, 'header' | 'scroller'> {
    header?: MaybeRefOrGetter<HeaderInput | ComponentPublicInstance>;
    scroller?: MaybeRefOrGetter<Element | string | null | undefined | ComponentPublicInstance>;
}

Vue را ببینید.

ویرایش این صفحه در GitHub
بعدی
دموی زنده