# 燈箱/Lightbox
利用[模態對話框](modal.html)為圖片和視頻創建一個別致的燈箱。
## 用法
要使用這個組件,添加 `data-uk-lightbox` 屬性到一個鏈接到圖片的錨文本中。如果title屬性存在,它將會被顯示為燈箱的標題。
注意 此組件需要額外添加 `lightbox.js` 文件,在`js/components`文件夾中。
### Example

### Markup
```
<a href="my-image.jpg" data-uk-lightbox title="">...</a>
```
* * *
## 組/Groups
你可以鏈接多個圖片到同一個燈箱中,并在燈箱內切換顯示,就是一個畫廊了。只需添加 `{group:'my-group'}` 選項到每個單元的data屬性,并且每個單元使用同一個grou名稱,以顯示在同一個燈箱中。你需要確保你已經引入了 [滑動導航組件](slidenav.html) 的CSS,這樣你才能在燈箱里切換顯示各個單元。
### Example

### Markup
```
<a href="" data-uk-lightbox="{group:'my-group'}">...</a>
```
* * *
## 不同的內容源
燈箱并不限于圖片展示。其他的媒體,比如視頻,也可以顯示在燈箱中,它會通過判斷路徑自動生成能正常的輸出效果。
### Example

* * *
### 內容類型
如果路徑中沒有文件擴展名,只需要添加 `data-lightbox-type="image"` 屬性,視頻就能正常播放了。
* * *
## JavaScript 選項
| 選項 | 可用值 | 默認值 | 描述 |
| --- | --- | --- | --- |
| `group` | string | false | 組名用來將元素分組,作為畫廊進行展示。 |
| `duration` | integer | 400 | 畫廊切換內容時的動畫持續時間。 |
| `keyboard` | boolean | true | 允許使用鍵盤翻頁 |
### 手動初始化
```
var lightbox = UIkit.lightbox(element, { /* options */ });
```
### 創建動態燈箱
```
var lightbox = UIkit.lightbox.create([
{'source': 'http://url/to/video.mp4', 'type':'video'},
{'source': 'http://url/to/image.jpg', 'type':'image'}
]);
lightbox.show();
```
### 事件
| 名稱 | 參數 | 描述 |
| --- | --- | --- |
| `showitem.uk.lightbox` | event, data | 燈箱顯示時 |
- UIkit 中文文檔
- 開始使用
- 初學者
- 開始使用
- 如何自定義
- 布局示例
- 開發者
- 項目結構
- Less & Sass 文件
- 創建主題
- 創建樣式
- Customizer.json
- JavaScript
- 自定義前綴
- 核心組件
- 默認
- 基礎
- 打印
- 布局類組件
- 網格
- 面板/Panel
- 塊/Block
- 文章
- 評論/Comment
- 效果/Utility
- Flex 布局
- 覆蓋/Cover
- 導航類組件
- 導航菜單
- 導航欄
- 二級導航
- 面包屑/Breadcrumb
- 分頁
- 選項卡
- 縮略圖導航/Thumbnav
- 頁面元素
- 列表
- 描述列表
- 表格
- 表單
- 常用組件
- 按鈕
- 圖標
- 關閉/Close
- 徽章/Badge
- 提示框
- 縮略圖/Thumbnail
- 遮罩/Overlay
- 文本
- 列
- 動畫
- 對比度/Contrast
- JAVASCRIPT組件
- 下拉菜單
- 模態對話框
- 抽屜/Off-canvas
- 切換器/Switcher
- 撥動/toggle
- 滾動監聽/Scrollspy
- 平滑滾動
- 附加組件
- 布局類組件
- 動態網格
- 視差網格
- 導航類組件
- 圓點導航
- 滑動導航/Slidenav
- 動態分頁
- 常用組件
- 高級表單
- 文件表單/Form file
- 密碼表單
- 選擇表單
- 占位符
- 進度條/Progress
- JAVASCRIPT組件
- 燈箱/Lightbox
- 自動完成/Autocomplete
- 日期選擇器/Datepicker
- HTML 編輯器
- 滾動條/Slider
- 滑塊集/Slideset
- 幻燈片/Slideshow
- 視差/Parallax
- 手風琴/Accordion
- 通知/Notify
- 搜索/Search
- 可嵌套/Nestable
- 可排序/Sortable
- 附著/Sticky
- 時間選擇器
- 工具提示/Tooltip
- 上傳