Struct Attachments 

pub struct Attachments { /* private fields */ }

Shared handle to the attachments staged on an EditorPane composer.

The composer’s owner keeps a clone (see EditorPane::attachments), stages images with Attachments::push_image and collapsed pastes with Attachments::push_text, and drains the queue on submit with Attachments::take. The pane renders one framed card per visible attachment above its status band, tinted with the attachment’s identity color and captioned with its #N marker plus pixel resolution or paste size.

Attachments::set_visible reconciles the band with the composer text: an attachment whose inline reference was deleted hides — and returns on undo — without losing its marker number.

Mutations change the pane’s height out of band, so the owner triggers a relayout afterwards (e.g. crate::Ui::resize at the current width).

Implementations

impl Attachments

pub fn new() -> Self

Creates an empty attachment queue.

pub fn push_image(&self, source: impl Into<Str>) -> Attachment

Stages an image source, probing its pixel dimensions from the file header, and returns the staged descriptor.

Examples found in repository

examples/chat/demo.rs (line 933)

	fn attach_image(&mut self, path: &str) {
		let attachment = self.attachments.push_image(path);
		let payload = format!("<ref image={}/>", attachment.marker);
		self.insert_chip(&attachment, &payload);
	}

pub fn push_text(&self, text: &str) -> Attachment

Stages pasted text collapsed out of the composer and returns the staged descriptor.

Examples found in repository

examples/chat/demo.rs (line 941)

	fn attach_paste(&mut self, text: &str) {
		let attachment = self.attachments.push_text(text);
		self.insert_chip(&attachment, text);
	}

pub fn take(&self) -> Vec<Attachment>

Drains the whole queue, restarting marker numbering, and returns the visible attachments in marker order. Hidden descriptors — whose inline references the user deleted — are discarded, never handed to the host.

Examples found in repository

examples/chat/demo.rs (line 826)

	pub fn handle_key(&mut self, key: Key) -> bool {
		*self.edit_outcome.borrow_mut() = None;
		let _ = self.editor_ui.handle_key(key);
		let outcome = self
			.edit_outcome
			.borrow_mut()
			.take()
			.unwrap_or(EditOutcome::Ignored);
		match outcome {
			EditOutcome::Submitted(text) => {
				let trimmed = text.trim();
				if trimmed == "/switch" {
					self.switch_requested = true;
					return false;
				}
				if let Some(path) = trimmed
					.strip_prefix("/attach")
					.filter(|rest| rest.is_empty() || rest.starts_with(' '))
				{
					let path = path.trim().to_string();
					if !path.is_empty() {
						self.attach_image(&path);
					}
					return false;
				}
				let _ = self.attachments.take();
				self.refresh_composer();
				self
					.transcript
					.push(Entry::Submitted(Box::new(Submission::new(
						text,
						Self::message_width(self.last_viewport.width),
						&self.ctx,
					))));
				self.set_working(true, self.started_at.elapsed());
				false
			},
			EditOutcome::Changed => {
				self.reconcile_attachments();
				false
			},
			EditOutcome::Ignored => {
				if key == Key::Ctrl('c') {
					return true;
				}
				if key != Key::Esc {
					return false;
				}
				if self.work.borrow().working {
					self.set_working(false, self.started_at.elapsed());
					return false;
				}
				true
			},
		}
	}

pub fn set_visible(&self, visible: impl FnMut(&Attachment) -> bool) -> bool

Shows exactly the attachments visible accepts and hides the rest (ones whose inline reference was deleted), returning whether anything changed. Hidden attachments stay staged, so an undo can bring them back.

Examples found in repository

examples/chat/demo.rs (lines 965-970)

	fn reconcile_attachments(&mut self) {
		let charset = self.ctx.charset;
		let changed = {
			let editor = self.editor.borrow();
			let text = editor.text();
			let ranges = editor.atom_ranges();
			self.attachments.set_visible(|attachment| {
				let chip = chip_label(attachment, charset);
				ranges
					.iter()
					.any(|&(start, end)| text.get(start..end) == Some(chip.as_str()))
			})
		};
		if changed {
			self.refresh_composer();
		}
	}

pub fn len(&self) -> usize

Number of visible attachments.

pub fn is_empty(&self) -> bool

Whether no attachment is visible.

Trait Implementations

impl Clone for Attachments

fn clone(&self) -> Attachments

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for Attachments

fn default() -> Attachments

Returns the “default value” for a type.