Bootstrap ашылмалы плагинімен сілтемелер тізімдерін және т.б. көрсету үшін мәтінмәндік қабаттасуды ауыстырыңыз.
Шолу
Ашылмалы тізімдер ауыспалы, сілтемелер тізімдерін көрсетуге арналған контекстік қабаттар және т.б. Олар қосылған Bootstrap ашылмалы JavaScript плагинімен интерактивті етіп жасалған. Олар меңзерді апару арқылы емес, басу арқылы ауыстырылады; бұл әдейі жасалған дизайн шешімі .
Ашылмалы тізімдер динамикалық орналасуды және көру аймағын анықтауды қамтамасыз ететін үшінші тарап кітапханасында құрылған, Popper.js . Bootstrap JavaScript алдында popper.min.js қосуды ұмытпаңыз немесе Popper.js бар bootstrap.bundle.min.js/ пайдаланыңыз bootstrap.bundle.js. Popper.js ашылмалы тізімдерді шарлау тақталарында орналастыру үшін пайдаланылмайды, бірақ динамикалық орналасу қажет емес.
Егер сіз JavaScript-ті дереккөзден құрастырсаңыз, олutil.js .
Қол жетімділік
WAI ARIA стандарты нақты виджетті анықтайды ,role="menu" бірақ бұл әрекеттерді немесе функцияларды іске қосатын қолданбаға ұқсас мәзірлерге тән. ARIA мәзірлері тек мәзір элементтерін, құсбелгі мәзірінің элементтерін, радио түймелерінің мәзір элементтерін, радио түймелерінің топтарын және ішкі мәзірлерді қамтуы мүмкін.
Екінші жағынан, Bootstrap ашылмалы тізімдері жалпы және әртүрлі жағдайлар мен белгілеу құрылымдарына қолданылатын етіп жасалған. Мысалы, іздеу өрістері немесе кіру пішіндері сияқты қосымша кірістерді және пішінді басқару элементтерін қамтитын ашылмалы тізімдерді жасауға болады. Осы себепті, Bootstrap шынайы ARIA мәзірлері үшін қажетті roleжәне атрибуттардың ешқайсысын күтпейді (немесе автоматты түрде қосады) . Авторлар осы неғұрлым нақты атрибуттарды өздері қосуы керек.aria-
Дегенмен, Bootstrap көптеген стандартты пернетақта мәзірінің өзара әрекеттесуіне кірістірілген қолдауды қосады, мысалы, курсор пернелерін пайдаланып жеке элементтерді жылжыту және мәзірді пернемен .dropdown-itemжабу мүмкіндігі .ESC
Мысалдар
Ашылмалы тізімнің ауыстырып-қосқышын (түймеңізді немесе сілтемеңізді) және ашылмалы мәзірді ішінде .dropdownнемесе жариялайтын басқа элементті ораңыз position: relative;. Ашылмалы тізімдерді әлеуетті қажеттіліктеріңізге жақсырақ сәйкестендіру үшін элементтерден <a>немесе элементтерден іске қосуға болады.<button>
Жалғыз түйме
Кез келген сингл .btnкейбір белгілеу өзгерістерімен ашылмалы қосқышқа айналуы мүмкін. <button>Төменде оларды кез келген элементпен жұмыс істеуге қоюға болады :
Сол сияқты, бір түйменің ашылмалы тізімдері сияқты іс жүзінде бірдей белгілеумен, бірақ .dropdown-toggle-splitашылмалы каретка айналасындағы дұрыс аралық үшін қосу арқылы бөлінген түйме ашылмалы тізімдерін жасаңыз.
Біз бұл қосымша сыныпты каретаның paddingекі жағындағы көлденеңді 25%-ға азайту және margin-leftкәдімгі түймелердің ашылмалы тізімдері үшін қосылғанын жою үшін пайдаланамыз. Бұл қосымша өзгертулер каретканы бөлу түймешігінің ортасында ұстайды және негізгі түйменің жанындағы сәйкес өлшемді соққы аймағын қамтамасыз етеді.
Тарихи ашылмалы мәзір мазмұны сілтемелер болуы керек еді , бірақ бұл енді v4 нұсқасына қатысты емес. Енді ашылмалы тізімде жай ғана s <button>орнына элементтерді пайдалануға болады.<a>
Сондай-ақ, көмегімен интерактивті емес ашылмалы элементтерді жасауға болады .dropdown-item-text. Теңшелетін CSS немесе мәтіндік утилиталардың көмегімен әрі қарай сәндеуге болады.
Әдепкі бойынша, ашылмалы мәзір ата-анасының жоғарғы жағында және сол жағында автоматты түрде 100% орналасады. А-ға қосыңыз .dropdown-menu-right, .dropdown-menuашылмалы мәзірді оңға туралаңыз.
Ескерту! Ашылмалы тізімдер Popper.js арқасында орналастырылған (олар шарлау тақтасында болған жағдайларды қоспағанда).
Жауапты туралау
Жауапты туралауды пайдаланғыңыз келсе, data-display="static"төлсипатты қосу арқылы динамикалық орналастыруды өшіріңіз және жауап беретін вариация сыныптарын пайдаланыңыз.
Ашылмалы мәзірді берілген тоқтау нүктесімен немесе одан үлкенірек оң жаққа туралау үшін қосыңыз .dropdown-menu{-sm|-md|-lg|-xl}-right.
Сол жақ ашылмалы мәзірді берілген тоқтау нүктесімен немесе одан үлкенірек туралау үшін .dropdown-menu-rightжәне қосыңыз .dropdown-menu{-sm|-md|-lg|-xl}-left.
Шарлау жолақтарындағы ашылмалы түймелерге төлсипатты қосудың қажеті жоқ екенін data-display="static"ескеріңіз, себебі Popper.js шарлау жолақтарында пайдаланылмайды.
Мәзір мазмұны
Тақырыптар
Кез келген ашылмалы мәзірдегі әрекеттер бөлімдерін белгілеу үшін тақырып қосыңыз.
Кез келген еркін пішінді мәтінді мәтіні бар ашылмалы мәзірге орналастырыңыз және бос орын утилиталарын пайдаланыңыз . Мәзір енін шектеу үшін сізге қосымша өлшем мәнерлері қажет болуы мүмкін екенін ескеріңіз.
.showДеректер атрибуттары немесе JavaScript арқылы ашылмалы плагин негізгі тізім элементіндегі сыныпты ауыстыру арқылы жасырын мазмұнды (ашылмалы мәзірлер) ауыстырады . Атрибут data-toggle="dropdown"қолданба деңгейінде ашылмалы мәзірлерді жабу үшін пайдаланылады, сондықтан оны әрқашан пайдалану жақсы идея.
Сенсорлы құрылғыларда ашылмалы тізімді ашу элементтің тікелей еншілес бөліктеріне бос ( $.noop) өңдегіштерді қосады . Бұл, әрине, ұсқынсыз бұзақылық iOS іс-шаралар делегациясындағы қызықты мәселені шешу үшін қажет , әйтпесе ашылмалы тізімнен тыс кез келген жерде түрту ашылмалы тізімді жабатын кодты іске қосуға жол бермейді. Ашылмалы тізім жабылғаннан кейін бұл қосымша бос өңдеушілер жойылады.mouseover<body>mouseover
Деректер атрибуттары арқылы
Ашылмалы тізімді ауыстырып қосу data-toggle="dropdown"үшін сілтемеге немесе түймеге қосыңыз.
JavaScript арқылы
JavaScript арқылы ашылмалы тізімге қоңырау шалыңыз:
data-toggle="dropdown"әлі де қажет
Ашылмалы тізімге JavaScript арқылы қоңырау шалуыңызға немесе оның орнына data-api пайдалануыңызға қарамастан, ашылмалы тізімнің data-toggle="dropdown"іске қосу элементінде әрқашан болуы қажет.
Опциялар
Опцияларды деректер атрибуттары немесе JavaScript арқылы жіберуге болады. Деректер атрибуттары үшін параметр атауын ішінде data-сияқты қосыңыз data-offset="".
Аты
Түр
Әдепкі
Сипаттама
офсет
саны | жол | функциясы
0
Ашылмалы тізімнің мақсатына қатысты ығысуы.
Функция ығысуды анықтау үшін пайдаланылғанда, ол бірінші аргумент ретінде ығысу деректерін қамтитын нысанмен шақырылады. Функция бірдей құрылымы бар нысанды қайтаруы керек. Іске қосу элементі DOM түйіні екінші аргумент ретінде жіберіледі.
Анықтамалық элементте қабаттасқан жағдайда, Ашылмалы тізімге айналдыруға рұқсат беріңіз. Қосымша ақпарат алу үшін Popper.js құжаттамаларын қараңыз .
шекара
жол | элемент
'scrollParent'
Ашылмалы мәзірдің толып кету шектеуінің шекарасы. 'viewport', 'window', 'scrollParent', немесе HTMLElement сілтемесінің мәндерін қабылдайды (тек JavaScript). Қосымша ақпаратты Popper.js's preventOverflow құжаттарынан қараңыз .
анықтама
жол | элемент
'қосу'
Ашылмалы мәзірдің анықтамалық элементі. 'toggle', 'parent'немесе HTMLElement сілтемесінің мәндерін қабылдайды . Қосымша ақпаратты Popper.js сілтемеОбъект құжаттарынан қараңыз .
көрсету
жол
«динамикалық»
Әдепкі бойынша, динамикалық орналасу үшін Popper.js пайдаланамыз. Мұны арқылы өшіріңіз static.
popperConfig
null | объект
null
Bootstrap әдепкі Popper.js конфигурациясын өзгерту үшін Popper.js конфигурациясын қараңыз .
boundaryКез келген мәннен басқа мәнге орнатылған кезде 'scrollParent'мәнер контейнерге position: staticқолданылатынын ескеріңіз ..dropdown
Әдістері
Әдіс
Сипаттама
$().dropdown('toggle')
Берілген шарлау тақтасының немесе қойындылы шарлаудың ашылмалы мәзірін ауыстырады.
$().dropdown('show')
Берілген шарлау тақтасының н��месе қойындылы шарлаудың ашылмалы мәзірін көрсетеді.
$().dropdown('hide')
Берілген шарлау тақтасының немесе қойындылы шарлаудың ашылмалы мәзірін жасырады.
$().dropdown('update')
Элементтің ашылмалы тізімінің орнын жаңартады.
$().dropdown('dispose')
Элементтің ашылмалы тізімін бұзады.
Оқиғалар
Барлық ашылмалы оқиғалар .dropdown-menuата-ана элементінде іске қосылады және relatedTargetмәні ауыстырып-қосқыш якорь элементі болып табылатын сипатқа ие. hide.bs.dropdownжәне hidden.bs.dropdownоқиғалардың нұқу оқиғасы үшін Оқиға нысанын қамтитын clickEventсипаты бар (тек бастапқы оқиға түрі болғанда ғана ).click
Оқиға
Сипаттама
show.bs.dropdown
Бұл оқиға шоу данасы әдісі шақырылғанда бірден іске қосылады.
shown.bs.dropdown
Бұл оқиға ашылмалы тізім пайдаланушыға көрінетін болған кезде іске қосылады (CSS ауысуларының аяқталуын күтеді).
hide.bs.dropdown
Бұл оқиға жасыру данасы әдісі шақырылған кезде бірден іске қосылады.
hidden.bs.dropdown
Бұл оқиға ашылмалы тізімді пайдаланушыдан жасыруды аяқтаған кезде іске қосылады (CSS ауысуларының аяқталуын күтеді).