Folder Content Filling

About this plugin

👋 Say goodbye to copy-pasting. Let "Folder Content Filling" handle the repetitive work!

告别繁琐的复制粘贴，让“文件夹内容填充”帮你搞定重复性工作！

🎯 Folder Content Filling is a productivity tool designed to bridge your local assets with your Figma designs. Simply select a local folder, and the plugin will automatically categorize your text files (.txt) and image sub-folders for instant usage.

文件夹内容填充是一款专注于利用本地数据进行设计的效率插件。只需选择一个本地文件夹，插件即可自动将里面的文本（txt）和图片（子文件夹）素材映射到面板中。

📖 如何使用 (How it works)

🛠️ 准备素材 (Preparation)

1. Organize a "Root Folder" on your computer.
2. For Text: Place .txt files directly in this folder (ensure each line in the file represents one data entry).
3. For Images: Categorize your images into different sub-folders.
4. 首先在电脑本地整理一个“素材总文件夹”。
5. 文本素材： 将 .txt 文档直接放入该文件夹（文档内每一行代表一条独立数据）。
6. 图片素材： 将图片按照分类放入不同的子文件夹中。

🚀 启动与连接 (Connect)

1. Run the plugin and select your prepared "Root Folder". The plugin will automatically detect and list all available text and image sources.
2. 运行插件，点击选择刚才准备好的“素材总文件夹”。插件会自动识别并列出所有的文本源和图片源。

✍️ 填充文本 (Fill Text)

1. Select Text Layers in Figma, then click a .txt filename on the plugin panel to populate them with random lines from the file.
2. 在 Figma 中选中一个或多个文本层，点击插件面板上的 txt 文件名，即可随机填入该文档中的文本行。

🖼️ 填充图片 (Fill Images)

1. Select Shapes or Frames in Figma, then click a sub-folder name on the plugin panel to fill them with random images from that directory.
2. 在 Figma 中选中一个或多个 Shape 或 Frame，点击插件面板上的 子文件夹名称，即可随机填入该目录下的图片。

⚙️ 个性化设置 (Settings)

1. Drag to resize the panel height or toggle languages (CN/EN) anytime. The plugin automatically remembers your layout and language preferences!
2. 支持自由拖拽调整面板高度，并可点击右上角切换中/英文。插件会自动记忆您的语言和高度偏好，下次打开即用！

🎉 核心功能亮点 (Key Features)

📁 Direct Local Access (本地资源直连):

1. Connects directly to your local directories. No cloud uploads required—ensuring maximum privacy and zero latency.
2. 直接读取本地目录，无需上传云端，确保隐私且零延迟。

🧠 Smart Categorization (智能分类识别):

1. Automatically scans and sorts your folder contents. Identifies .txt files for Text Filling and sub-folders for Image Filling instantly.
2. 自动扫描并分类文件夹内容。瞬间将.txt文件识别为文本填充，子文件夹识别为图片填充。

⚡️ Random Batch Filling (随机批量填充):

1. Text: Populates selected text layers with random lines from your .txt documents.
2. Images: Fills selected shapes or frames with random images from your specific sub-folders.
3. 文本：从.txt文档中随机抽取行来填充选中的文本层。图片：从特定子文件夹中随机抽取图片填充选中的形状。

🛠 Personalized Experience (个性化体验):

1. Supports custom plugin window height and bilingual switching (English/Chinese). It automatically remembers your layout preferences and language settings.
2. 支持自定义窗口高度和双语切换。自动记忆您的布局偏好和语言设置。

🔄 Flexible Workflow (灵活切换):

1. Switch between different source folders on the fly to match the specific assets needed for your current project.
2. 随时切换源文件夹，以匹配当前项目所需的特定素材。