# 自动填充自定义字段

{% hint style="info" %}
对应的[官方文档地址](https://bitwarden.com/help/article/auto-fill-custom-fields/)
{% endhint %}

Bitwarden 不止于[自动填充用户名和密码](/docs/password-manager/autofill/autofill-from/autofill-from-browser-extensions.md)！Bitwarden 浏览器扩展还可以自动填充[自定义字段](/docs/password-manager/your-vault/vault-items/custom-fields.md)，以简化安全问题、PIN 码等的填充。

此外，如果您的浏览器扩展在自动填充特定站点的用户名和密码时遇到问题，使用[链接型自定义字段](#shi-yong-lian-jie-de-zi-ding-yi-zi-duan)可以强制自动填充。

{% hint style="success" %}
要使自动填充正常工作，正确命名自定义字段很重要。[了解更多](/docs/password-manager/your-vault/vault-items/custom-fields.md#custom-field-names)。
{% endhint %}

要自动填充自定义字段：

1、打开浏览器扩展，导航到**密码库**视图。此视图会自动检测已打开的标签页中显示的网页（例如 `myverizon.com`），并浮现所有具有相应 URI 的登录。

2、在包含要自动填充的自定义字段的项目上，选择**填充**按钮：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/4ExHyb45ZapKssCpRl6Uro/b8e686e8a58e0ed24f8aa58dd746253e/2024-12-03_09-55-22.png?w=889&#x26;fm=avif" alt=""><figcaption><p>带有自定义字段的项目</p></figcaption></figure></div>

浏览器扩展将查找与[自定义字段名称](/docs/password-manager/your-vault/vault-items/custom-fields.md#custom-field-names)匹配的任何字段，并自动填充该字段的值。

## 使用链接型自定义字段 <a href="#using-linked-custom-fields" id="using-linked-custom-fields"></a>

链接型自定义字段可用于解决浏览器扩展无法自动填充特定站点的用户名和密码时的问题。要创建和自动填充链接型自定义字段：

1、在项目**编辑**面板的**自定义字段**部分，从字段类型下拉菜单中选择链接型。

2、在**名称**输入框中，[为自定义字段指定一个名称](/docs/password-manager/your-vault/vault-items/custom-fields.md#custom-field-names)，使其与用户名或密码的 HTML 表单元素 `id`，`name`，`aria-label` 或 `placeholder` 相对应。

{% hint style="success" %}
您可以通过右键单击表单元素然后使用**复制自定义字段名称**上下文菜单选项来获取其正确的值：

<img src="https://bitwarden.com/assets/5nnPLqyzgAhDCinQNB0uUC/a721194f39f0a8fa919066d73ff9e2c8/2024-10-29_10-50-34.png?w=980&#x26;fm=avif" alt="" data-size="original">

{% endhint %}

3、选择**添加**。

4、根据您在自动填充时遇到问题的凭据类型，为字段值选择**用户名**或**密码**。在许多情况下，您需要为每个类型创建一个链接型自定义字段。

5、**保存**对密码库项目的更改。

现在您已经创建了一个或多个链接型自定义字段，您可以使用[前面部分中描述的方法](#auto-fill-custom-fields)自动填充了。当您操作时，您的浏览器扩展将自动填充用户名、密码或两者到为字段名称指定的 HTML 表单元素中。

## 特殊自动填充场景 <a href="#special-auto-fill-scenarios" id="special-auto-fill-scenarios"></a>

### HTML <a href="#html" id="html"></a>

自定义字段通常被填充到 HTML `<form>` 或 `<input>` 元素中，但是 Bitwarden 浏览器扩展也可以将自定义字段值自动填充到 HTML `<span>` 元素的 `innerText` 中。

要自动填充到 `<span>` 元素中，打开的标签页必须具有 `data-bwautofill` 属性。因此，在以下场景中：

```html
<span data-bwautofill id="myspan">Bitwarden is great.</span>
```

**名称**为 `myspan` 的自定义字段会将 `Bitwarden is great` 替换为保存在该自定义字段的**值**中的任何内容。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.ppgg.in/docs/password-manager/autofill/more-autofill-options/auto-fill-custom-fields.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.