dear_file_browser/lib.rs
1#![deny(missing_docs)]
2//! File dialogs and in-UI file browser for `dear-imgui-rs`.
3//!
4//! Note on UTF-8/CJK: Dear ImGui's default font does not include CJK glyphs.
5//! If you need Chinese/Japanese/Korean or emoji, load a font that contains
6//! those glyphs (e.g., Noto Sans SC) into the font atlas during initialization.
7//! For best quality, enable the `freetype` feature and follow the pattern in
8//! `examples/style_and_fonts.rs` to add fonts and ranges (e.g., Simplified
9//! Chinese common glyphs).
10//!
11//! Two backends:
12//! - Native (via `rfd`) for OS dialogs (desktop) and Web File Picker (wasm)
13//! - ImGui (pure-UI) browser that works everywhere and is fully themeable
14
15mod core;
16#[cfg(feature = "native-rfd")]
17mod native;
18#[cfg(feature = "imgui")]
19mod ui;
20
21pub use core::{
22 Backend, ClickAction, DialogMode, FileDialog, FileDialogError, FileFilter, LayoutStyle,
23 Selection, SortBy,
24};
25#[cfg(feature = "imgui")]
26pub use ui::{FileBrowserState, FileDialogExt};