Hãy sử dụng một ví dụ để hiển thị cách Tooltips có thể được thêm vào bất kỳ thành phần HTML nào trong tài liệu của bạn.
GHI CHÚ:
Nếu các mẫu chú giải công cụ này không hoạt động khi bạn đặt chúng vào trang của mình, thì bạn có một vấn đề khác. Bạn cần nhìn vào những thứ như:
- Thứ tự của các kịch bản được bao gồm
- Xem nếu bạn đang cố gắng khởi tạo các phần tử HTML đã bị xóa
- Xem nếu bạn đang cố gắng gọi các phương thức trong các tệp JS, bạn không còn bao gồm
Xem nếu bạn đang bao gồm tệp JS cung cấp chức năng bạn cần (không chỉ cho chú giải công cụ, mà bất kỳ thành phần nào bạn sử dụng trên trang).
<head>
<link rel="stylesheet" href="/Content/bootstrap.css" />
<link rel="stylesheet" href="/Content/animate.css" />
<link rel="stylesheet" href="/Content/style.css" />
</head>
<body>
... your HTML code ...
<script src="/Scripts/jquery-2.1.1.js"></script>
<script src="/Scripts/bootstrap.min.js"></script>
<script src="/Scripts/app/inspinia.js"></script> <!-- if using INSPINIA -->
... your JavaScript initializers ...
</body>
Thất bại của BẤT K of các mục trên có thể (và thường không) ngăn javascript tải và / hoặc chạy, và điều đó giữ cho mọi thứ tốt đẹp và bị hỏng.
BÀI TẬP LÀM VIỆC
Giả sử bạn có một huy hiệu và bạn muốn nó hiển thị một chú giải công cụ khi người dùng di chuyển qua nó.
HTML gốc:
<span class="badge badge-sm badge-plain">Admin Mode</span>
Công cụ khởi động đơn giản
Nếu bạn đang tạo chú giải công cụ cho Phần tử HTML và bạn đang sử dụng chú giải công cụ Plain Bootstrap, thì bạn sẽ chịu trách nhiệm gọi Công cụ khởi tạo Tooltip bằng mã JavaScript của riêng bạn.
TRƯỚC
<span class="badge badge-sm badge-plain">Admin Mode</span>
SAU
<span
class="badge badge-sm badge-plain"
data-toggle="tooltip"
data-placement="right"
title="Tooltip on right"
>Admin Mode</span>
BAN ĐẦU
<script>
// Initialize any Tooltip on this page
$(document).ready(function ()
{
$('[data-toggle="tooltip"]').tooltip();
}
);
</script>
Bootstrap Template Tooltips (chẳng hạn như INSPINIA)
Nếu bạn đang sử dụng mẫu bootstrap (chẳng hạn như INSPINIA), bạn đang bao gồm một tập lệnh hỗ trợ để hỗ trợ các tính năng của mẫu:
<script src="/Scripts/app/inspinia.js" />
Trong trường hợp INSPINIA, tập lệnh đi kèm sẽ tự động khởi chạy tất cả các chú giải công cụ bằng cách chạy mã javascript sau khi tải tài liệu xong:
// Tooltips demo
$('.tooltip-demo').tooltip({
selector: "[data-toggle=tooltip]",
container: "body"
});
Vì điều này, bạn KHÔNG phải tự khởi tạo Tooltips theo kiểu INSPINIA. Nhưng bạn phải định dạng các yếu tố của mình một cách cụ thể. Trình khởi tạo tìm kiếm các phần tử HTML có tooltip-demo
trong class
thuộc tính, sau đó gọi tooltip()
phương thức để khởi tạo bất kỳ phần tử con nào có thuộc tính data-toggle="tooltip"
được xác định.
Đối với huy hiệu ví dụ của chúng tôi, đặt một yếu tố bên ngoài xung quanh nó (giống như một <div>
hoặc <span>
) mà có class="tooltip-demo"
, sau đó đặt data-toggle
, data-placement
và title
thuộc tính cho các tooltip thực tế trong các yếu tố đó là huy hiệu. Sửa đổi HTML gốc từ phía trên để trông giống như thế này:
TRƯỚC
<span class="badge badge-sm badge-plain">Admin Mode</span>
SAU
<span class="tooltip-demo">
<span
class="badge badge-sm badge-plain"
data-toggle="tooltip"
data-placement="right"
title="Tooltip on right"
>Admin Mode</span>
</span>
BAN ĐẦU
None
Lưu ý rằng bất kỳ phần tử con nào trong <span class="tooltip-demo">
phần tử sẽ được chuẩn bị đúng tooltip của chúng. Tôi có thể có ba phần tử con, tất cả đều cần chú giải công cụ và đặt chúng trong một thùng chứa.
Nhiều mục, mỗi mục có một Tooltip
<span class="tooltip-demo">
<span class="badge badge-sm badge-plain" data-toggle="tooltip" data-placement="right" title="A Tooltip">Text 001</span>
<span class="badge badge-sm badge-plain" data-toggle="tooltip" data-placement="right" title="Another Tooltip">Text 002</span>
<span class="badge badge-sm badge-plain" data-toggle="tooltip" data-placement="right" title="Third Tooltip">Text 003</span>
</span>
Việc sử dụng tốt nhất cho việc này sẽ là thêm class="tooltip-demo"
một <td>
hoặc ngoài cùng <div>
hoặc <span>
.
Plain Bootstrap Tooltips trong khi sử dụng Mẫu
Nếu bạn đang sử dụng INSPINIA, nhưng bạn không muốn thêm thẻ ngoài <div>
hoặc <span>
thẻ bổ sung để tạo chú giải công cụ, bạn có thể sử dụng Chú giải công cụ Bootstrap tiêu chuẩn mà không can thiệp vào mẫu. Trong trường hợp này, bạn sẽ chịu trách nhiệm tự khởi tạo Tooltips. Tuy nhiên, bạn nên sử dụng một giá trị tùy chỉnh trong class
thuộc tính để xác định các mục Tooltip của bạn. Điều này sẽ giữ cho trình khởi tạo Tooltip của bạn không can thiệp vào các yếu tố bị ảnh hưởng bởi INSPINIA. Trong ví dụ của chúng tôi, hãy sử dụng standalone-tt
:
TRƯỚC
<span class="badge badge-sm badge-plain">Admin Mode</span>
SAU
<span
class="standalone-tt badge badge-sm badge-plain"
data-toggle="tooltip"
data-placement="right"
title="Tooltip on right"
>Admin Mode</span>
BAN ĐẦU
<script>
// Initialize MY standalone tooltips, ignoring INSPINIA-affected elements
$(document).ready(function ()
{
$('.standalone-tt').tooltip();
}
);
</script>