Skip to content
Office Oxide

Замена текста в DOCX и PPTX

replace_text(needle, replacement) проходит по каждому элементу <w:t> в DOCX (тело, колонтитулы) и по каждому <a:t> на каждом слайде и заметках-слайде в PPTX. Возвращает количество выполненных замен.

Это правильный инструмент для шаблонизации: задайте {{плейсхолдеры}} в исходном документе и подставляйте значения во время выполнения.

Однопроходная замена

Rust

use office_oxide::edit::EditableDocument;

let mut ed = EditableDocument::open("contract.docx")?;
let n = ed.replace_text("{{client_name}}", "Acme Corp");
println!("{n} replacements");
ed.save("contract_acme.docx")?;

Python

from office_oxide import EditableDocument

with EditableDocument.open("contract.docx") as ed:
    n = ed.replace_text("{{client_name}}", "Acme Corp")
    print(f"{n} replacements")
    ed.save("contract_acme.docx")

JavaScript

import { EditableDocument } from 'office-oxide';

using ed = EditableDocument.open('contract.docx');
const n = ed.replaceText('{{client_name}}', 'Acme Corp');
console.log(`${n} replacements`);
ed.save('contract_acme.docx');

Go

ed, _ := officeoxide.OpenEditable("contract.docx")
defer ed.Close()
n, _ := ed.ReplaceText("{{client_name}}", "Acme Corp")
fmt.Printf("%d replacements\n", n)
ed.Save("contract_acme.docx")

C#

using var ed = EditableDocument.Open("contract.docx");
long n = ed.ReplaceText("{{client_name}}", "Acme Corp");
Console.WriteLine($"{n} replacements");
ed.Save("contract_acme.docx");

C

int err = 0;
OfficeEditableHandle *ed = office_editable_open("contract.docx", &err);
int64_t n = office_editable_replace_text(ed, "{{client_name}}", "Acme Corp", &err);
printf("%lld replacements\n", (long long)n);
office_editable_save(ed, "contract_acme.docx", &err);
office_editable_free(ed);

Заполнение нескольких ключей за раз

Применяйте все замены перед сохранением — это гораздо эффективнее, чем открывать файл заново для каждой замены.

Rust

let fields = [
    ("{{client_name}}",   "Acme Corp"),
    ("{{contract_date}}", "2026-04-19"),
    ("{{amount}}",        "$120,000"),
    ("{{tier}}",          "Enterprise"),
];

let mut ed = EditableDocument::open("contract.docx")?;
for (needle, value) in fields {
    ed.replace_text(needle, value);
}
ed.save("contract_acme.docx")?;

Python

fields = {
    "{{client_name}}":   "Acme Corp",
    "{{contract_date}}": "2026-04-19",
    "{{amount}}":        "$120,000",
    "{{tier}}":          "Enterprise",
}

with EditableDocument.open("contract.docx") as ed:
    for needle, value in fields.items():
        ed.replace_text(needle, value)
    ed.save("contract_acme.docx")

JavaScript

const fields = {
  '{{client_name}}':   'Acme Corp',
  '{{contract_date}}': '2026-04-19',
  '{{amount}}':        '$120,000',
  '{{tier}}':          'Enterprise',
};

using ed = EditableDocument.open('contract.docx');
for (const [k, v] of Object.entries(fields)) ed.replaceText(k, v);
ed.save('contract_acme.docx');

C

const char *keys[]   = { "{{client_name}}", "{{contract_date}}", "{{amount}}", "{{tier}}" };
const char *values[] = { "Acme Corp",       "2026-04-19",        "$120,000",   "Enterprise" };

int err = 0;
OfficeEditableHandle *ed = office_editable_open("contract.docx", &err);
for (size_t i = 0; i < 4; i++) {
    office_editable_replace_text(ed, keys[i], values[i], &err);
}
office_editable_save(ed, "contract_acme.docx", &err);
office_editable_free(ed);

Шаблоны PPTX

Тот же API, та же семантика — replace_text проходит по каждому слайду и каждому слайду заметок.

Rust

let mut ed = EditableDocument::open("deck_template.pptx")?;
ed.replace_text("{{quarter}}", "Q4 2026");
ed.replace_text("{{growth}}",  "+18.4%");
ed.save("q4_deck.pptx")?;

Python

with EditableDocument.open("deck_template.pptx") as ed:
    ed.replace_text("{{quarter}}", "Q4 2026")
    ed.replace_text("{{growth}}",  "+18.4%")
    ed.save("q4_deck.pptx")

JavaScript

using ed = EditableDocument.open('deck_template.pptx');
ed.replaceText('{{quarter}}', 'Q4 2026');
ed.replaceText('{{growth}}',  '+18.4%');
ed.save('q4_deck.pptx');

Go

ed, _ := officeoxide.OpenEditable("deck_template.pptx")
defer ed.Close()
ed.ReplaceText("{{quarter}}", "Q4 2026")
ed.ReplaceText("{{growth}}", "+18.4%")
ed.Save("q4_deck.pptx")

C#

using var ed = EditableDocument.Open("deck_template.pptx");
ed.ReplaceText("{{quarter}}", "Q4 2026");
ed.ReplaceText("{{growth}}", "+18.4%");
ed.Save("q4_deck.pptx");

C

int err = 0;
OfficeEditableHandle *ed = office_editable_open("deck_template.pptx", &err);
office_editable_replace_text(ed, "{{quarter}}", "Q4 2026", &err);
office_editable_replace_text(ed, "{{growth}}",  "+18.4%", &err);
office_editable_save(ed, "q4_deck.pptx", &err);
office_editable_free(ed);

О границах ранов

DOCX и PPTX разбивают текст на «раны» (runs) — непрерывные фрагменты с одинаковым стилем оформления. Если пользователь вставил текст или сработала автокоррекция прямо посередине токена, Word может хранить {{name}} как три отдельных рана. replace_text обрабатывает совпадения через границы ранов прозрачно: перед поиском он объединяет соседние раны одного стилевого окна.

Если плейсхолдеры содержат специальные символы или стилизованные фрагменты, отдавайте предпочтение простым ASCII-токенам вроде {{name}}, а не «умным кавычкам» Word — это минимизирует накладные расходы на объединение ранов.

XLSX — особый случай

replace_text возвращает 0 для XLSX: текст таблиц хранится в таблице общих строк и в формулах ячеек, а не в элементах <w:t> / <a:t>. Для работы с таблицами используйте set_cell.

Смотрите также