ප්‍රධාන අන්තර්ගතය වෙත යන්න ලේඛන සංචාලනය වෙත යන්න
Check
in English

ඇඟවීම්

පවතින සහ නම්‍යශීලී අනතුරු ඇඟවීමේ පණිවිඩ අතලොස්සක් සමඟ සාමාන්‍ය පරිශීලක ක්‍රියා සඳහා සන්දර්භීය ප්‍රතිපෝෂණ පණිවිඩ සපයන්න.

මෙම පිටුවේ

උදාහරණ

ඕනෑම දිග පෙළක් සඳහා මෙන්ම විකල්ප වසා දැමීමේ බොත්තමක් සඳහා ඇඟවීම් තිබේ. නිසි හැඩගැන්වීම සඳහා, අවශ්‍ය සන්දර්භ පන්ති අටෙන් එකක් භාවිතා කරන්න (උදා, .alert-success). මාර්ගගතව ඉවත් කිරීම සඳහා, ඇඟවීම් භාවිතා කරන්න JavaScript ප්ලගිනය .

html 
<div class="alert alert-primary" role="alert">
  A simple primary alert—check it out!
</div>
<div class="alert alert-secondary" role="alert">
  A simple secondary alert—check it out!
</div>
<div class="alert alert-success" role="alert">
  A simple success alert—check it out!
</div>
<div class="alert alert-danger" role="alert">
  A simple danger alert—check it out!
</div>
<div class="alert alert-warning" role="alert">
  A simple warning alert—check it out!
</div>
<div class="alert alert-info" role="alert">
  A simple info alert—check it out!
</div>
<div class="alert alert-light" role="alert">
  A simple light alert—check it out!
</div>
<div class="alert alert-dark" role="alert">
  A simple dark alert—check it out!
</div>
උපකාරක තාක්ෂණයන් සඳහා අර්ථය ලබා දීම

අර්ථය එකතු කිරීම සඳහා වර්ණය භාවිතා කිරීම දෘශ්‍ය ඇඟවීමක් පමණක් සපයයි, එය තිර කියවනය වැනි ආධාරක තාක්ෂණයන් භාවිතා කරන්නන්ට ලබා නොදේ. වර්ණයෙන් දැක්වෙන තොරතුරු එක්කෝ අන්තර්ගතයෙන්ම පැහැදිලි බව (උදා: දෘශ්‍ය පෙළ) හෝ .visually-hiddenපන්තිය සමඟ සඟවා ඇති අතිරේක පෙළ වැනි විකල්ප ක්‍රම මගින් ඇතුළත් කර ඇති බව සහතික කර ගන්න.

සජීවී උදාහරණය

අනතුරු ඇඟවීමක් පෙන්වීමට පහත බොත්තම ක්ලික් කරන්න (ආරම්භ කිරීමට පේළිගත විලාසයන් සමඟ සඟවා ඇත), ඉන්පසු ගොඩනඟන ලද වසා දැමීමේ බොත්තම සමඟ එය ඉවත් කරන්න (සහ විනාශ කරන්න).

html 
<div id="liveAlertPlaceholder"></div>
<button type="button" class="btn btn-primary" id="liveAlertBtn">Show live alert</button>

අපගේ සජීවී ඇඟවීම් ආදර්ශනය ක්‍රියාත්මක කිරීමට අපි පහත ජාවාස්ක්‍රිප්ට් භාවිතා කරමු:

const alertPlaceholder = document.getElementById('liveAlertPlaceholder')

const alert = (message, type) => {
  const wrapper = document.createElement('div')
  wrapper.innerHTML = [
    `<div class="alert alert-${type} alert-dismissible" role="alert">`,
    `   <div>${message}</div>`,
    '   <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>',
    '</div>'
  ].join('')

  alertPlaceholder.append(wrapper)
}

const alertTrigger = document.getElementById('liveAlertBtn')
if (alertTrigger) {
  alertTrigger.addEventListener('click', () => {
    alert('Nice, you triggered this alert message!', 'success')
  })
}

.alert-linkඕනෑම ඇඟවීමක් තුළ ගැලපෙන වර්ණ සබැඳි ඉක්මනින් සැපයීමට උපයෝගිතා පන්තිය භාවිතා කරන්න .

html 
<div class="alert alert-primary" role="alert">
  A simple primary alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-secondary" role="alert">
  A simple secondary alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-success" role="alert">
  A simple success alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-danger" role="alert">
  A simple danger alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-warning" role="alert">
  A simple warning alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-info" role="alert">
  A simple info alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-light" role="alert">
  A simple light alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>
<div class="alert alert-dark" role="alert">
  A simple dark alert with <a href="#" class="alert-link">an example link</a>. Give it a click if you like.
</div>

අමතර අන්තර්ගතය

ඇඟවීම්වල ශීර්ෂ, ඡේද සහ බෙදුම් වැනි අමතර HTML මූලද්‍රව්‍ය ද අඩංගු විය හැක.

html 
<div class="alert alert-success" role="alert">
  <h4 class="alert-heading">Well done!</h4>
  <p>Aww yeah, you successfully read this important alert message. This example text is going to run a bit longer so that you can see how spacing within an alert works with this kind of content.</p>
  <hr>
  <p class="mb-0">Whenever you need to, be sure to use margin utilities to keep things nice and tidy.</p>
</div>

අයිකන

ඒ හා සමානව, ඔබට අයිකන සමඟ ඇඟවීම් නිර්මාණය කිරීමට flexbox උපයෝගිතා සහ Bootstrap Icons භාවිතා කළ හැකිය. ඔබගේ අයිකන සහ අන්තර්ගතය මත පදනම්ව, ඔබට තවත් උපයෝගිතා හෝ අභිරුචි මෝස්තර එක් කිරීමට අවශ්‍ය විය හැක.

html 
<div class="alert alert-primary d-flex align-items-center" role="alert">
  <svg xmlns="http://www.w3.org/2000/svg" class="bi bi-exclamation-triangle-fill flex-shrink-0 me-2" viewBox="0 0 16 16" role="img" aria-label="Warning:">
    <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
  </svg>
  <div>
    An example alert with an icon
  </div>
</div>

ඔබගේ ඇඟවීම් සඳහා නිරූපක එකකට වඩා අවශ්‍යද? එකම අයිකන නැවත නැවත යොමු කිරීම සඳහා තවත් Bootstrap Icons භාවිතා කිරීම සහ දේශීය SVG ස්ප්‍රයිට් එකක් සෑදීම සලකා බලන්න.

html 
<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
  <symbol id="check-circle-fill" viewBox="0 0 16 16">
    <path d="M16 8A8 8 0 1 1 0 8a8 8 0 0 1 16 0zm-3.97-3.03a.75.75 0 0 0-1.08.022L7.477 9.417 5.384 7.323a.75.75 0 0 0-1.06 1.06L6.97 11.03a.75.75 0 0 0 1.079-.02l3.992-4.99a.75.75 0 0 0-.01-1.05z"/>
  </symbol>
  <symbol id="info-fill" viewBox="0 0 16 16">
    <path d="M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16zm.93-9.412-1 4.705c-.07.34.029.533.304.533.194 0 .487-.07.686-.246l-.088.416c-.287.346-.92.598-1.465.598-.703 0-1.002-.422-.808-1.319l.738-3.468c.064-.293.006-.399-.287-.47l-.451-.081.082-.381 2.29-.287zM8 5.5a1 1 0 1 1 0-2 1 1 0 0 1 0 2z"/>
  </symbol>
  <symbol id="exclamation-triangle-fill" viewBox="0 0 16 16">
    <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
  </symbol>
</svg>

<div class="alert alert-primary d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Info:"><use xlink:href="#info-fill"/></svg>
  <div>
    An example alert with an icon
  </div>
</div>
<div class="alert alert-success d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Success:"><use xlink:href="#check-circle-fill"/></svg>
  <div>
    An example success alert with an icon
  </div>
</div>
<div class="alert alert-warning d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Warning:"><use xlink:href="#exclamation-triangle-fill"/></svg>
  <div>
    An example warning alert with an icon
  </div>
</div>
<div class="alert alert-danger d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Danger:"><use xlink:href="#exclamation-triangle-fill"/></svg>
  <div>
    An example danger alert with an icon
  </div>
</div>

අස් කරනවා

අනතුරු ඇඟවීමේ ජාවාස්ක්‍රිප්ට් ප්ලගිනය භාවිතයෙන්, ඕනෑම ඇඟවීම් පේළියක් ඉවත දැමිය හැක. මෙන්න මෙහෙමයි.

  • ඔබ අනතුරු ඇඟවීමේ ප්ලගිනය හෝ සම්පාදනය කරන ලද Bootstrap JavaScript පූරණය කර ඇති බවට වග බලා ගන්න.
  • වසන්න බොත්තමක් සහ පන්තිය එක් කරන්න .alert-dismissible, එය අනතුරු ඇඟවීමේ දකුණට අමතර පෑඩිං එකතු කරන අතර වසන බොත්තම ස්ථානගත කරයි.
  • වසන්න බොත්තම මත, data-bs-dismiss="alert"ජාවාස්ක්‍රිප්ට් ක්‍රියාකාරීත්වය අවුලුවාලන ගුණාංගය එක් කරන්න. <button>සියලුම උපාංග හරහා නිසි හැසිරීම සඳහා එය සමඟ මූලද්‍රව්‍යය භාවිතා කිරීමට වග බලා ගන්න .
  • ඉවතලන විට ඇඟවීම් සජීවීකරණය කිරීමට, .fadeසහ .showපන්ති එක් කිරීමට වග බලා ගන්න.

සජීවී ආදර්ශනයක් සමඟ ඔබට මෙය ක්‍රියාවෙන් දැකිය හැක:

html 
<div class="alert alert-warning alert-dismissible fade show" role="alert">
  <strong>Holy guacamole!</strong> You should check in on some of those fields below.
  <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
</div>
ඇඟවීමක් ඉවත දැමූ විට, මූලාංගය පිටු ව්‍යුහයෙන් සම්පූර්ණයෙන්ම ඉවත් කරනු ලැබේ. යතුරුපුවරු පරිශීලකයෙකු වසා දැමීමේ බොත්තම භාවිතයෙන් අනතුරු ඇඟවීම ප්‍රතික්ෂේප කළහොත්, ඔවුන්ගේ අවධානය හදිසියේම නැති වී යන අතර, බ්‍රවුසරය මත පදනම්ව, පිටුවේ/ලේඛනයේ ආරම්භයට යළි පිහිටුවනු ලැබේ. මෙම හේතුව නිසා, සිදුවීමට සවන් දෙන සහ පිටුවේ වඩාත් සුදුසු ස්ථානයට closed.bs.alertවැඩසටහන්ගත කරන අමතර JavaScript ඇතුළත් කිරීමට අපි නිර්දේශ කරමු. focus()ඔබ සාමාන්‍යයෙන් අවධානය යොමු නොකරන අන්තර්ක්‍රියාකාරී නොවන මූලද්‍රව්‍යයකට අවධානය යොමු කිරීමට අදහස් කරන්නේ නම් tabindex="-1", මූලද්‍රව්‍යයට එක් කිරීමට වග බලා ගන්න.

CSS

විචල්යයන්

v5.2.0 හි එකතු කරන ලදී

Bootstrap හි විකාශනය වන CSS විචල්‍ය ප්‍රවේශයේ කොටසක් ලෙස, ඇඟවීම් දැන් .alertවැඩිදියුණු කළ තත්‍ය කාලීන අභිරුචිකරණය සඳහා දේශීය CSS විචල්‍යයන් භාවිතා කරයි. CSS විචල්‍යයන් සඳහා අගයන් Sass හරහා සකසා ඇත, එබැවින් Sass අභිරුචිකරණයට තවමත් සහය දක්වයි.

  --#{$prefix}alert-bg: transparent;
  --#{$prefix}alert-padding-x: #{$alert-padding-x};
  --#{$prefix}alert-padding-y: #{$alert-padding-y};
  --#{$prefix}alert-margin-bottom: #{$alert-margin-bottom};
  --#{$prefix}alert-color: inherit;
  --#{$prefix}alert-border-color: transparent;
  --#{$prefix}alert-border: #{$alert-border-width} solid var(--#{$prefix}alert-border-color);
  --#{$prefix}alert-border-radius: #{$alert-border-radius};

Sass විචල්යයන්

$alert-padding-y:               $spacer;
$alert-padding-x:               $spacer;
$alert-margin-bottom:           1rem;
$alert-border-radius:           $border-radius;
$alert-link-font-weight:        $font-weight-bold;
$alert-border-width:            $border-width;
$alert-bg-scale:                -80%;
$alert-border-scale:            -70%;
$alert-color-scale:             40%;
$alert-dismissible-padding-r:   $alert-padding-x * 3; // 3x covers width of x plus default padding on either side

සාස් මික්සින්

$theme-colorsඅපගේ ඇඟවීම් සඳහා සන්දර්භීය විකරණයක පන්ති නිර්මාණය කිරීමට ඒකාබද්ධව භාවිතා කරයි.

@mixin alert-variant($background, $border, $color) {
  --#{$prefix}alert-color: #{$color};
  --#{$prefix}alert-bg: #{$background};
  --#{$prefix}alert-border-color: #{$border};

  @if $enable-gradients {
    background-image: var(--#{$prefix}gradient);
  }

  .alert-link {
    color: shade-color($color, 20%);
  }
}

සාස් ලූප්

alert-variant()මික්සින් සමඟ විකරණකාරක පන්ති ජනනය කරන ලූපය .

// Generate contextual modifier classes for colorizing the alert.

@each $state, $value in $theme-colors {
  $alert-background: shift-color($value, $alert-bg-scale);
  $alert-border: shift-color($value, $alert-border-scale);
  $alert-color: shift-color($value, $alert-color-scale);

  @if (contrast-ratio($alert-background, $alert-color) < $min-contrast-ratio) {
    $alert-color: mix($value, color-contrast($alert-background), abs($alert-color-scale));
  }
  .alert-#{$state} {
    @include alert-variant($alert-background, $alert-border, $alert-color);
  }
}

JavaScript හැසිරීම

ආරම්භ කරන්න

ඇඟවීම් ලෙස මූලද්‍රව්‍ය ආරම්භ කරන්න

const alertList = document.querySelectorAll('.alert')
const alerts = [...alertList].map(element => new bootstrap.Alert(element))

ඇඟවීමක් ඉවත දැමීමේ එකම අරමුණ සඳහා, JS API හරහා සංරචකය හස්තීයව ආරම්භ කිරීම අවශ්‍ය නොවේ. භාවිතා කිරීමෙන් data-bs-dismiss="alert", සංරචකය ස්වයංක්‍රීයව ආරම්භ කර නිසි ලෙස ඉවත් කරනු ලැබේ.

වැඩි විස්තර සඳහා ප්‍රේරක කොටස බලන්න.

ප්‍රේරක

පහත දැක්වෙන පරිදි ඇඟවීම තුළ ඇතිdata බොත්තමක් මත ඇති ගුණාංගය සමඟින් ඉවත් කිරීම සාක්ෂාත් කරගත හැකිය :

<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>

හෝ පහත දැක්වෙන පරිදි අනතුරු ඇඟවීමෙන් පිටත බොත්තමක් මත data-bs-target:

<button type="button" class="btn-close" data-bs-dismiss="alert" data-bs-target="#my-alert" aria-label="Close"></button>

අනතුරු ඇඟවීමක් වැසීමෙන් එය DOM වෙතින් ඉවත් කරන බව සලකන්න.

ක්රම

ඔබට අනතුරු ඇඟවීමේ නිර්මාපකය සමඟ අනතුරු ඇඟවීමේ අවස්ථාවක් නිර්මාණය කළ හැකිය, උදාහරණයක් ලෙස:

const bsAlert = new bootstrap.Alert('#myAlert')

මෙමගින් data-bs-dismiss="alert"උපලක්ෂණ ඇති descendant මූලද්‍රව්‍ය මත ක්ලික් සිදුවීම් සඳහා අනතුරු ඇඟවීමක් සවන් දෙයි. (data-api හි ස්වයංක්‍රීය-ආරම්භය භාවිතා කරන විට අවශ්‍ය නොවේ.)

ක්රමය විස්තර
close අනතුරු ඇඟවීමක් DOM වෙතින් ඉවත් කිරීමෙන් එය වසා දමයි. .fadeමූලද්‍රව්‍යයේ සහ පන්ති තිබේ නම් .show, එය ඉවත් කිරීමට පෙර අනතුරු ඇඟවීම මැකී යනු ඇත.
dispose මූලද්‍රව්‍යයක අනතුරු ඇඟවීමක් විනාශ කරයි. (DOM මූලද්‍රව්‍යයේ ගබඩා කර ඇති දත්ත ඉවත් කරයි)
getInstance DOM මූලද්‍රව්‍යයකට සම්බන්ධ අනතුරු ඇඟවීමේ අවස්ථාව ලබා ගැනීමට ඔබට ඉඩ සලසන ස්ථිතික ක්‍රමය. උදාහරණයක් ලෙස bootstrap.Alert.getInstance(alert):.
getOrCreateInstance ස්ථිතික ක්‍රමය DOM මූලද්‍රව්‍යයකට සම්බන්ධ අනතුරු ඇඟවීමේ අවස්ථාවක් ආපසු ලබා දෙන හෝ එය ආරම්භ කර නොමැති අවස්ථාවක නව එකක් නිර්මාණය කරයි. ඔබට එය මේ ආකාරයෙන් භාවිතා කළ හැකිය: bootstrap.Alert.getOrCreateInstance(element).

මූලික භාවිතය:

const alert = bootstrap.Alert.getOrCreateInstance('#myAlert')
alert.close()

සිදුවීම්

Bootstrap හි අනතුරු ඇඟවීමේ ප්ලගිනය අනතුරු ඇඟවීමේ ක්‍රියාකාරීත්වයට සම්බන්ධ වීම සඳහා සිදුවීම් කිහිපයක් නිරාවරණය කරයි.

සිදුවීම විස්තර
close.bs.alert closeනිදසුන් ක්‍රමය හැඳින්වූ විට වහාම ගිනි ගනී.
closed.bs.alert අනතුරු ඇඟවීම වසා ඇති විට සහ CSS සංක්‍රාන්ති සම්පූර්ණ වූ විට වෙඩි තබන ලදී. 
const myAlert = document.getElementById('myAlert')
myAlert.addEventListener('closed.bs.alert', event => {
  // do something, for instance, explicitly move focus to the most appropriate element,
  // so it doesn't get lost/reset to the start of the page
  // document.getElementById('...').focus()
})